Polymarket MCP

Polymarket MCP Server

⚠️ Aviso: A Quantish está encerrando. A plataforma Quantish (quantish.live) está sendo desativada. Este servidor MCP é auto-hospedado e continuará funcionando de forma independente, mas a equipe Quantish não manterá nem atualizará mais este projeto. Se você está construindo no espaço de mercados de previsão e precisa de infraestrutura de dados em tempo real, confira polynode.dev.

Servidor MCP auto-hospedado para negociação em mercados de previsão da Polymarket.

Visão Geral

Este pacote fornece um servidor MCP (Model Context Protocol) que permite que agentes de IA negociem em mercados de previsão da Polymarket através da rede Polygon.

Recursos

• Negociação Completa na Polymarket - Compre/venda em qualquer mercado da Polymarket
• Gerenciamento de Carteira Polygon - Gere e gerencie carteiras com integração Safe
• Transações sem Gás - A maioria das operações usa o relayer da Polymarket (sem necessidade de MATIC)
• Compatível com MCP - Funciona com Claude, Cursor e qualquer cliente MCP
• Auto-hospedável - Execute em Railway, Fly.io ou qualquer host Node.js

Início Rápido

git clone https://github.com/joinQuantish/polymarket-mcp
cd polymarket-mcp
npm install

Variáveis de Ambiente

Variável	Obrigatório	Descrição
DATABASE_URL	Sim	String de conexão PostgreSQL
ENCRYPTION_KEY	Sim	String hexadecimal de 32 bytes para criptografia de carteira
POLYGON_RPC_URL	Sim	Endpoint RPC da Polygon
BOT_SIGNING_SECRET	Não	Segredo para autenticação HMAC de bots confiáveis
PORT	Não	Porta do servidor (padrão 3000)

Gerar Chaves de Criptografia

# Generate ENCRYPTION_KEY (32 bytes = 64 hex chars)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

# Generate BOT_SIGNING_SECRET (for trusted bot auth)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Configuração do Banco de Dados

Qualquer banco de dados PostgreSQL funciona. Opções:

Provedor	Observações
Railway	Adicione o serviço PostgreSQL, copie DATABASE_URL das variáveis
Supabase	Nível gratuito em supabase.com, copie a string de conexão em Configurações > Banco de Dados
Neon	Postgres sem servidor em neon.tech, nível gratuito disponível
Docker Local	docker run -e POSTGRES_PASSWORD=pass -p 5432:5432 postgres

Defina seu DATABASE_URL e então execute:

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

Executando o Servidor

# Development
npm run dev

# Production
npm run build
npm start

Ferramentas Disponíveis

Conta e Carteira

Ferramenta	Descrição
request_api_key	Crie conta com nova carteira (ou recupere uma existente)
setup_wallet	Implante carteira Safe e defina aprovações
get_wallet_status	Verifique o status de implantação e aprovação da carteira
get_balances	Obtenha saldos de USDC/MATIC
get_deposit_addresses	Obtenha endereços para depósito (EVM, Solana, BTC)
export_private_key	Exporte a chave privada da carteira
import_private_key	Importe uma carteira existente

Negociação

Ferramenta	Descrição
place_order	Coloque ordem de compra/venda
cancel_order	Cancele uma ordem aberta
cancel_all_orders	Cancele todas as ordens abertas
get_orders	Obtenha histórico de ordens
execute_atomic_orders	Execute múltiplas ordens atomicamente
get_orderbook	Obtenha ofertas de compra/venda do mercado
get_price	Obtenha preço médio do mercado

Posições

Ferramenta	Descrição
get_positions	Obtenha suas posições
sync_positions	Sincronize posições da API da Polymarket
get_claimable_winnings	Verifique ganhos resgatáveis
claim_winnings	Reivindique ganhos de mercados resolvidos
get_onchain_shares	Obtenha todas as participações ERC-1155 (incluindo presenteadas)

Transferências e Trocas

Ferramenta	Descrição
transfer_usdc	Envie USDC em ponte
transfer_native_usdc	Envie USDC nativo da Circle
transfer_shares	Envie ações ERC-1155
send_matic	Envie MATIC de EOA
swap_tokens	Troque tokens via LI.FI
get_swap_quote	Obtenha cotação de troca

Chaves de API

Ferramenta	Descrição
list_api_keys	Liste suas chaves de API
create_additional_api_key	Crie nova chave de API
revoke_api_key	Revogue uma chave de API

Nota: As ferramentas de busca de mercado (search_markets, get_market, get_active_markets) estão disponíveis via Discovery MCP.

Formato da API

O servidor expõe um endpoint JSON-RPC 2.0 em /mcp:

curl -X POST https://your-server.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_balances",
      "arguments": {}
    },
    "id": 1
  }'

Configuração do Cliente MCP

Claude Desktop / Cursor

{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-server.com/mcp",
        "--header",
        "x-api-key: YOUR_API_KEY"
      ]
    }
  }
}

Segurança

Usuários Recorrentes

Por segurança, usuários recorrentes (externalId existente) não podem obter novas chaves de API sem autenticação. Opções:

1. Use a chave de API existente - Se você a tiver salva
2. Autenticação HMAC (somente bots confiáveis) - Assine com BOT_SIGNING_SECRET:

   signature = HMAC-SHA256(externalId:timestamp, BOT_SIGNING_SECRET)
   

3. Nova Conta - Use um externalId diferente

Desenvolvimento

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Run migrations
npm run db:push

# Start development server
npm run dev

Recursos

• GitHub: joinQuantish/polymarket-mcp
• Discovery MCP: joinQuantish/quantish-discovery
• Polymarket Docs: docs.polymarket.com

Licença

Este projeto está licenciado sob a PolyForm Noncommercial License 1.0.0.

Gratuito para uso pessoal, pesquisa e fins não comerciais. O uso comercial requer permissão explícita da Quantish Inc. Entre em contato com hello@quantish.live para licenciamento comercial.

---

Construído por Quantish Inc.