Como Configurar o Polymarket MCP Server

MCP significa Model Context Protocol — é um protocolo criado pela Anthropic que permite a modelos de IA (como o Claude) se conectarem a ferramentas externas de forma padronizada.

Pensa nisso como um 'plugin universal' — o MCP Server expõe ferramentas que o Claude pode chamar automaticamente. No caso do Polymarket MCP Server, são 45 ferramentas completas para pesquisar mercados, analisar odds, executar trades e gerir portfolio em mercados preditivos.

Como funciona na prática:

1. O MCP Server roda localmente na tua máquina (é um processo Python)

2. O Claude Desktop ou Claude Code conecta-se ao server via protocolo MCP

3. Quando pedes ao Claude algo sobre Polymarket, ele automaticamente chama as ferramentas do server

4. As ferramentas comunicam com a API real do Polymarket e devolvem dados/executam ações

É basicamente dar ao Claude superpoderes de trading em mercados preditivos! 🎯

Antes de começar, confirma que tens tudo isto instalado:

Obrigatório:

• •Python 3.10 ou superior — verifica com python3 --version no terminal
• •pip (gestor de pacotes Python) — normalmente vem com o Python
• •Git — para clonar o repositório
• •Claude Desktop OU Claude Code — o cliente MCP onde vais usar

Para trading real (modo completo):

• •Uma wallet Polygon (private key + address)
• •Conta na Polymarket com API credentials (CLOB)
• •USDC na rede Polygon para fundos de trading

Para modo DEMO (sem wallet):

• •Nenhuma credencial extra! Podes explorar mercados, ver análises e preços sem precisar de wallet. É perfeito para começar.

Abre o terminal e executa estes comandos:

`

# Clonar o repositório

git clone https://github.com/caiovicentino/polymarket-mcp-server.git

cd polymarket-mcp-server

# Criar ambiente virtual (IMPORTANTE!)

python3 -m venv venv

source venv/bin/activate # macOS/Linux

# No Windows: venv\Scripts\activate

# Instalar o pacote

pip install -e .

`

OU usa o instalador automático (mais fácil):

`

# macOS/Linux

./quickstart.sh

# Windows

install.bat

`

O quickstart.sh faz tudo automaticamente: verifica Python, cria o venv, instala dependências, configura o ambiente e testa a instalação.

Agora precisas configurar as credenciais:

`

# Copiar o ficheiro de exemplo

cp .env.example .env

# Editar com o teu editor favorito

nano .env

`

Para modo DEMO (sem trading):

`

DEMO_MODE=true

`

É só isto! Podes já usar para explorar mercados.

Para modo completo (com trading):

`

POLYGON_PRIVATE_KEY=a_tua_private_key_sem_prefixo_0x

POLYGON_ADDRESS=0xOTeuEnderecoPolygon

# Limites de segurança (recomendado!)

MAX_ORDER_SIZE_USD=1000

MAX_TOTAL_EXPOSURE_USD=5000

MAX_POSITION_SIZE_PER_MARKET=2000

MIN_LIQUIDITY_REQUIRED=10000

MAX_SPREAD_TOLERANCE=0.05

REQUIRE_CONFIRMATION_ABOVE_USD=500

`

⚠️ NUNCA partilhes a tua private key com ninguém! Guarda o ficheiro .env em segurança.

Esta é a parte crucial — ligar o MCP Server ao Claude Desktop:

1. Encontra o ficheiro de configuração do Claude Desktop:

• •macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• •Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Adiciona esta configuração:

`json

{

"mcpServers": {

"polymarket": {

"command": "/caminho/para/polymarket-mcp-server/venv/bin/python",

"args": ["-m", "polymarket_mcp.server"],

"cwd": "/caminho/para/polymarket-mcp-server",

"env": {

"POLYGON_PRIVATE_KEY": "a_tua_key",

"POLYGON_ADDRESS": "0xOTeuAddress"

}

}

}

}

`

IMPORTANTE: Substitui /caminho/para/ pelo caminho real onde clonaste o repo! Podes encontrar com pwd no terminal dentro da pasta do projeto.

3. Reinicia o Claude Desktop — obrigatório para carregar a nova config.

4. Verifica: Deverás ver um ícone de ferramentas 🔧 no Claude Desktop indicando que o MCP Server está conectado. Se vires as 45 ferramentas listadas, está tudo a funcionar! 🎉

Se preferes usar Claude Code (CLI) em vez do Claude Desktop:

`

# Dentro da pasta do projeto, com o venv ativado

claude mcp add polymarket python -m polymarket_mcp.server

`

Ou podes adicionar manualmente ao ficheiro de configuração do Claude Code.

Depois é só abrir o Claude Code e pedir coisas como:

• •"Mostra-me os mercados trending no Polymarket"
• •"Analisa o mercado X e dá-me uma recomendação"
• •"Qual é o spread atual no mercado Y?"

O Polymarket MCP Server também inclui um dashboard web para monitorização visual:

`

# Iniciar o dashboard

polymarket-web

# Ou

./start_web_dashboard.sh

`

Acede em http://localhost:8080 e tens:

• •Monitorização em tempo real do status do MCP
• •Gestão visual dos limites de segurança
• •Pesquisa e análise de mercados com UI
• •Gráficos de performance e rate limits
• •Tema escuro profissional 🌙

Depois de tudo configurado, testa com estes comandos no Claude:

Teste básico (funciona em DEMO e Full mode):

• •"Search for trending markets on Polymarket"
• •"Show me crypto prediction markets"
• •"Analyze the top market by volume"

Teste de trading (só Full mode):

• •"Show me my current positions"
• •"What's my portfolio value?"

Se o Claude responder com dados reais do Polymarket, está tudo configurado corretamente! 🎉