GuessMarket MCP

GuessMarket MCP Servidor

Servidor MCP para mercados de predicción de GuessMarket. Da a los agentes de IA acceso completo para descubrir mercados, analizar precios, consultar saldos y posiciones en cadena, construir transacciones de trading y obtener ABIs de contratos inteligentes.

Disponible en 5 cadenas EVM: Ethereum, Base, Polygon, BSC y PulseChain.

Herramientas

Solo lectura (API)

Herramienta	Descripción
list_markets	Lista los mercados de predicción con filtros por estado y cadena
get_market	Obtén información detallada del mercado: pregunta, probabilidades SÍ/NO, volumen, liquidez, hora de cierre
get_market_history	Obtén el historial de precios con marcas de tiempo para análisis de tendencias
get_networks	Obtén todas las cadenas compatibles con direcciones de contrato
get_portfolio	Obtén la actividad de trading de una billetera en todos los mercados
get_abi	Obtén el ABI del contrato inteligente para integraciones personalizadas

Solo lectura (en cadena)

Herramienta	Descripción
get_balance	Obtén el saldo de stablecoin (USDC/USDT) de una billetera en cualquier cadena
get_allowance	Comprueba cuánto stablecoin tiene aprobado un mercado para gastar desde una billetera
get_position	Obtén las acciones SÍ, acciones NO y tokens LP de una billetera en un mercado específico

Estas herramientas leen directamente de la blockchain a través de endpoints RPC públicos. No se requieren claves API.

Constructores de transacciones

Todos los constructores de transacciones devuelven objetos de transacción EVM sin firmar. Firma con tu billetera y transmítelos a la cadena. Los montos son legibles para humanos (p. ej. "10.5") y se convierten automáticamente a los decimales correctos por cadena (6 para USDC, 18 para USDT en BSC).

Herramienta	Descripción	Parámetros clave
build_approve_tx	Aprobar el gasto de stablecoin para un mercado	market_address, amount (o "max" para ilimitado), chain_id
build_buy_shares_tx	Comprar acciones de resultado SÍ o NO	market_address, outcome, amount, chain_id, min_shares (deslizamiento)
build_sell_shares_tx	Vender acciones de resultado SÍ o NO	market_address, outcome, shares, chain_id, min_usdc (deslizamiento)
build_add_liquidity_tx	Añadir liquidez en stablecoin, recibir tokens LP	market_address, amount, chain_id
build_remove_liquidity_tx	Quemar tokens LP, recibir stablecoin de vuelta	market_address, lp_tokens, chain_id
build_claim_winnings_tx	Reclamar ganancias de un mercado resuelto	market_address, chain_id
build_create_market_tx	Crear un nuevo mercado de predicción	question, end_time (unix timestamp), chain_id
build_buy_with_approval_tx	Aprobar + comprar en una sola llamada (devuelve 2 transacciones ordenadas)	market_address, outcome, amount, chain_id, min_shares (deslizamiento)

Protección contra deslizamiento

build_buy_shares_tx y build_sell_shares_tx aceptan parámetros de deslizamiento opcionales (min_shares y min_usdc). Cuando se establecen en 0 (por defecto), el servidor devuelve una advertencia. Establece un mínimo para protegerte contra el front-running.

Flujo de trading

Comprar acciones

1. list_markets               → Find a market to trade
2. get_market                  → Check current odds and liquidity
3. get_balance                 → Check your stablecoin balance
4. get_allowance               → Check if approval is needed
5. build_approve_tx            → Approve stablecoin spending (if needed)
6. build_buy_shares_tx         → Buy YES or NO shares
7. Sign and broadcast transactions with your wallet
8. get_position                → Verify your shares

O combina los pasos 5-6 con build_buy_with_approval_tx que devuelve ambas transacciones en orden.

Vender acciones

1. get_position                → Check your share holdings
2. build_sell_shares_tx        → Sell shares back to the market
3. Sign and broadcast the transaction
4. get_balance                 → Verify stablecoin received

Proporcionar liquidez

1. build_approve_tx            → Approve stablecoin spending
2. build_add_liquidity_tx      → Deposit stablecoin, receive LP tokens
3. get_position                → Verify LP tokens received
4. build_remove_liquidity_tx   → Later: burn LP tokens to withdraw

Crear un mercado

1. build_create_market_tx      → Deploy a new prediction market
2. Sign and broadcast — the new market address is in the tx receipt

Formato de respuesta de transacción

{
  "transaction": {
    "to": "0x...",
    "data": "0x...",
    "chainId": 8453,
    "value": "0x0"
  },
  "description": "Buy YES shares for 10 USDC on market 0x... (Base Mainnet)",
  "meta": {
    "chain": "Base Mainnet",
    "stablecoin": "USDC",
    "outcome": "YES",
    "function": "buyShares(uint8,uint256,uint256)"
  },
  "warnings": []
}

Inicio rápido

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "guessmarket": {
      "command": "npx",
      "args": ["-y", "guessmarket-mcp"]
    }
  }
}

Claude Code

Añade a tu proyecto con la CLI:

claude mcp add guessmarket -- npx -y guessmarket-mcp

O añade a .mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "guessmarket": {
      "command": "npx",
      "args": ["-y", "guessmarket-mcp"]
    }
  }
}

VS Code

Añade a la configuración de VS Code o a .vscode/mcp.json:

{
  "mcp": {
    "servers": {
      "guessmarket": {
        "command": "npx",
        "args": ["-y", "guessmarket-mcp"]
      }
    }
  }
}

Cadenas compatibles

Cadena	ID de cadena	Stablecoin
Ethereum	1	USDC (6 decimales)
Base	8453	USDC (6 decimales)
Polygon	137	USDC (6 decimales)
BSC	56	USDT (18 decimales)
PulseChain	369	USDC (6 decimales)

Configuración

No se requieren claves API: el servidor utiliza la API REST pública de GuessMarket.

URL de API personalizada

Por defecto, el servidor se conecta a https://guessmarket.com/api/guessmarket/v1. Sobrescribe con una variable de entorno:

{
  "mcpServers": {
    "guessmarket": {
      "command": "npx",
      "args": ["-y", "guessmarket-mcp"],
      "env": {
        "GUESSMARKET_API_URL": "https://your-instance.com/api/guessmarket/v1"
      }
    }
  }
}

Arquitectura

AI Agent  <-->  MCP Server  <-->  GuessMarket REST API (market data)
   |                  |
   |                  └───────>  Public RPCs (on-chain reads)
   |                                    |
   |                              5 EVM Chains
   |                          (Ethereum, Base, Polygon,
   |                             BSC, PulseChain)
   |
   └── Signs & broadcasts unsigned transactions on-chain

El servidor MCP proporciona datos de mercado (a través de la API REST), lee el estado en cadena (a través de endpoints RPC públicos) y construye transacciones sin firmar (mediante codificación ABI local). El agente firma las transacciones con su propia billetera y las transmite directamente a la blockchain.

Requisitos

• Node.js 18 o posterior (utiliza fetch nativo)

Desarrollo

npm install
npm run build
node build/index.js

Licencia

MIT