polymarket-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_statusB | Modo activo, límites y estado. No muestra secretos ni hace operaciones. |
| discover_marketsC | Mercados 5m del intervalo actual y próximos. windows: 1..6. Sólo se opera el actual. |
| get_market_snapshotC | Reglas oficiales, fuente de resolución, cierre, libros Up/Down y comisiones actuales. |
| quote_tradeA | Cotiza sin operar. BUY amount=USD nominales + comisión; SELL amount=shares (2 decimales). limit_price: máximo al comprar o mínimo al vender. Devuelve quote_id, vencimiento, estimación sobre profundidad y max_debit_usd incluyendo reserva de comisión. |
| execute_tradeA | EJECUTA una cotización vigente: dinero virtual en paper, REAL en live. reason: motivo decidido por la IA. Repetir quote_id devuelve la misma operación. Mostrar el comprobante al usuario; luego consultar poll_updates para confirmaciones. SL optativo: stop_loss_percent=20 activa salida al caer 20% el precio del token desde la entrada. stop_slippage=0.03 permite 3 centavos por debajo del disparador. |
| get_portfolioB | Saldo, posiciones y PnL disponible del modo activo. No modifica ni liquida posiciones. |
| get_trade_historyC | Comprobantes persistentes del modo activo, recientes primero. limit 1..200. |
| settle_paperA | Acredita una sola vez los resultados paper oficialmente resueltos; no envía transacciones. |
| sync_ordersA | Reconcilia órdenes live con fills confirmados. En paper consulta resoluciones. No envía apuestas. |
| poll_updatesA | Sincroniza y entrega eventos apuesta por apuesta. Guardar next_cursor como próximo after. Incluye órdenes, fills y resultados. El cliente debe invocarlo periódicamente. |
| cancel_orderA | Intenta cancelar una orden live de este MCP. No revierte shares ya compradas/vendidas. |
| set_trading_pausedA | Pausa/reanuda nuevas ejecuciones de forma persistente; consultas siguen disponibles. |
| set_reduce_onlyA | Bloquea compras nuevas y permite ventas/SL. La pausa total tiene prioridad. |
| set_stop_lossA | Autoriza SL automático para una compra: porcentaje sobre precio del token O disparador absoluto. Sólo a pedido del usuario. Un SL activo por token; slippage es tolerancia absoluta de precio. No garantiza ejecución. Requiere MCP/worker encendido. Persiste tras reiniciar. |
| list_stop_lossesB | SL persistidos: estado, configuración, intentos, orden vinculada y último error. |
| cancel_stop_lossA | Desactiva futuros envíos del SL; no revierte una venta ya reservada/enviada. |
| get_movementsA | Auditoría SQLite con cursor y filtros. No sincroniza ni opera. Eventos no son débitos adicionales. |
| get_market_contextD | Reglas y referencias Chainlink TWAP 30/60s, antigüedad y variación desde inicio cuando disponible. |
| get_price_historyB | Historial LOCAL recibido de Chainlink; ventana TWAP 30/60s, since Unix UTC. Sin datos previos inventados. |
| record_forecastA | Guarda pronóstico antes del cierre (probabilidad 0..1), sin operar. Evaluación con ganador oficial. |
| get_metricsA | Estados de órdenes, latencias, errores seguros, slippage y Brier de pronósticos resueltos. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| trading_session | Guía para una sesión donde la IA decide e informa cada operación. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 21 tools
Most tools have clear action-resource boundaries, but sync_orders and poll_updates both handle reconciliation and event delivery, and get_market_snapshot/get_market_context/get_price_history overlap around market data. These are distinguishable with effort but could cause misselection.
All tool names use a consistent snake_case verb_noun or verb_adjective pattern, such as cancel_order, discover_markets, set_stop_loss, and list_stop_losses. The only slight deviation is poll_updates, but it remains readable and predictable.
At 21 tools, the server is slightly heavy but the breadth is justified by covering market discovery, trading, risk controls, paper settlement, sync, and audit. It stays within a reasonable range but is approaching the threshold where navigation becomes more demanding.
The core prediction-market workflow is well covered: discovery, quoting, execution, cancellation, portfolio, history, settlement, stop losses, sync, and audit. Minor gaps include no explicit open-order listing for paper mode and some redundancy among market-data tools, but there are no fatal dead-ends.