CryptoConduit-MCP

Um servidor MCP que dá a agentes de IA acesso direto aos mercados de previsão cripto da Polymarket, enriquecido com preços spot ao vivo. Descubra mercados, analise livros de ordens, faça paper trading de estratégias, acompanhe atividades e execute negociações ao vivo.

GitHub

Documentação

CryptoConduit MCP

Um servidor MCP que dá a agentes de IA acesso direto aos mercados de previsão de cripto da Polymarket, enriquecidos com preços spot ao vivo. Descubra mercados, analise livros de ofertas, faça paper trading de estratégias, acompanhe atividades e execute negociações ao vivo — tudo por meio de linguagem natural.

Construído em Rust. 22 ferramentas. Testado na mainnet.

Use-o como um servidor MCP com qualquer cliente compatível com MCP, ou importe a biblioteca core/ diretamente em seus próprios bots e pipelines em Rust — zero dependência de MCP.

O que ele faz

Inteligência de Mercado — Descubra e monitore mercados de previsão em 6 ativos (BTC, ETH, SOL, XRP, DOGE, BNB) e 8 tipos de mercado (de 5 minutos a mensal). Preços spot da Binance em tempo real sobrepostos aos livros de ofertas da Polymarket, com pontuação de negociabilidade, análise de spread e perfil de profundidade.

Análise Quantitativa — Momentum do spot, dinâmica do livro de ofertas (tendências de spread, mudanças de profundidade, desequilíbrio), detecção de divergência entre probabilidade e preço spot, e análise de fluxo de baleias — combinados em um único briefing por mercado. Quando o histórico local não está disponível, a análise recorre à consulta de mercados resolvidos na Gamma para contexto de volume e atividade históricos.

Paper Trading — Simulação de P&L ajustada por taxas usando o modelo de taxas da Polymarket. Paper trading com acompanhamento completo de portfólio, execução autônoma de auto-trades, saída antecipada e gerenciamento de posições. Teste estratégias sem risco antes de comprometer capital real.

Negociação ao Vivo — Coloque e gerencie ordens reais na Polymarket via SDK oficial. Tripla barreira de segurança: dry run por padrão, confirmação explícita obrigatória e um gerenciador de risco com limites diários de perda, acompanhamento de drawdown e pausas por perdas consecutivas.

Monitoramento — Sistema de fundo sempre ativo: detecção de baleias no stream de negociações ao vivo da Polymarket, alertas de estreitamento de spread, detecção de picos de profundidade e notificações de janelas se aproximando. Nenhuma configuração manual necessária.

Ferramentas

Descoberta e Dados

Ferramenta	O que faz
`search_crypto_markets`	Pesquise na Polymarket por mercados de previsão de cripto. Filtre por ativo, tipo de mercado (5m, diário, mensal, etc.) e ordene por spread ou volume. Retorna mercados ativos com preços atuais, spreads e liquidez.
`get_active_window`	Instantâneo da janela de previsão atual de 5m ou 15m — tempo restante, preço spot, ambos os lados UP/DOWN com melhor bid/ask, spread e profundidade.
`get_window_briefing`	Versão mais rica da janela ativa — adiciona movimento do spot desde a abertura, perfil de volatilidade de 1 hora, cálculos de ponto de equilíbrio com taxas e pontuação de negociabilidade por lado.
`get_spot_price`	Preço spot atual da Binance para qualquer ativo suportado, com indicador de idade dos dados.
`get_order_book`	Livro de ofertas completo para um token de mercado específico — todos os níveis de bid/ask, profundidade total, análise de concentração e estimativas de slippage em vários tamanhos de negociação.
`get_market_analysis`	A principal ferramenta de análise. Combina 5 dimensões: momentum do spot (tendências de 1m/5m/15m, aceleração, volatilidade), dinâmica do livro de ofertas (tendências de spread, assimetria de profundidade, estatísticas históricas), divergência de probabilidade (modelo empírico vs preço de mercado), fluxo de baleias e alertas recentes. Recorre à consulta de mercados resolvidos na Gamma quando o histórico local não está disponível. Funciona em mercados de 5m, 15m, diários e mensais.
`get_whale_activity`	Grandes negociações recentes ($5k+) em mercados diários e mensais do stream de negociações ao vivo da Polymarket. Filtra ruído de micro-mercados e resgates pós-liquidação.
`get_alerts`	Alertas gerados pelo monitor de fundo: estreitamento de spread, picos de profundidade, negociações de baleias e janelas se aproximando do vencimento.

Simulação e Paper Trading

Ferramenta	O que faz
`simulate_trade`	Calculadora de P&L ajustada por taxas. Insira um tamanho de posição e preço, veja o lucro/perda exato para cenários de vitória e derrota, com taxas de taker da Polymarket, rebates de maker e matemática de liquidação. Mostra a taxa de vitória de ponto de equilíbrio.
`paper_trade`	Abra uma posição simulada aos preços atuais de mercado. Rastreia preço de entrada, taxas e timestamps. Posições são liquidadas automaticamente quando o mercado é resolvido na Polymarket.
`get_paper_portfolio`	Visão completa do portfólio — posições abertas com contagem regressiva ao vivo, resultados liquidados, taxa de vitória por ativo e faixa de preço de entrada, P&L total e acompanhamento de taxas.
`paper_close`	Saia de uma posição de paper antecipadamente ao preço de bid atual, pagando taxa de taker na saída. Mostra P&L realizado incluindo taxas de entrada e saída.
`set_auto_paper_trade`	Configure paper trading autônomo. Defina um ativo, tamanho de posição e condições de entrada — o servidor monitora mercados e abre posições automaticamente quando as condições são atendidas.
`get_auto_paper_trade_status`	Verifique quais auto-traders estão rodando, suas negociações recentes e estatísticas agregadas.

Negociação ao Vivo

Requer configuração de carteira. Veja Configuração da Carteira abaixo.

Ferramenta	O que faz
`approve_exchange`	Configuração on-chain única. Aprova transferências de tokens USDC e CTF para os 3 contratos de exchange da Polymarket. Custa ~$0.001 em gás POL. Deve ser executada antes de colocar qualquer ordem.
`get_balance`	Saldo de USDC.e da carteira na Polygon, além do status do gerenciador de risco (perda diária restante, perdas consecutivas, drawdown).
`place_order`	Coloque uma ordem de compra ou venda. Dry run por padrão — mostra o que aconteceria sem enviar. Requer `confirm=true` explícito para executar. Gerenciador de risco aplicado.
`cancel_order`	Cancele uma ordem específica por ID, ou cancele todas as ordens abertas de uma vez.
`get_positions`	Posições ao vivo atuais na sua carteira.
`redeem_winnings`	Resgate tokens CTF vencedores on-chain após a liquidação de um mercado. Funciona com mercados padrão e NegRisk.

Sistema

Ferramenta	O que faz
`set_data_logging`	Ative/desative o registro JSONL em segundo plano de preços spot, livros de ofertas e instantâneos de mercado. Útil para construir conjuntos de dados ou depurar.
`get_data_logging_status`	Verifique se o registro está ativo, onde os arquivos são salvos e o uso atual de disco.

Exemplo de saída

Briefing de janela

## BTC 5m Briefing (2:25 AM ET)

Time: 9% elapsed (26s / 300s), 274s remaining
Spot: $70822 -> $70843 (+0.03%)
Volatility (1h): avg 5m move: 0.051% | max: 0.146% | moves >0.05%: 5/12
UP:   ask=0.660 bid=0.650 spread=1.5% | good (depth: $755, slippage $100: 2.0%)
DOWN: ask=0.350 bid=0.340 spread=2.9% | good (depth: $127, slippage $100: 2.3%)
Fees (taker): UP at 0.660: fee=1.3%, breakeven WR=67.3%
              DOWN at 0.350: fee=1.3%, breakeven WR=36.3%

Análise de mercado (diário)

## BTC Market Analysis (daily)

### Spot Momentum
  Price           $70795    Trend        Down
  1m move         -0.085%   5m vol       0.055%
  5m move         -0.039%   Accel        decel (-0.078)
  15m move        -0.167%

$70795 — downtrend, decelerating. High volatility.

### Order Book Dynamics
  ATM strike: $70000 (spot: $70795)

  Side     Spread   Median       Trend    BidDep$    AskDep$  Imbalance
  ------------------------------------------------------------------------
  YES        1.3%     1.3%      stable       $169       $221  Mild ask pressure
  NO         3.9%     3.9%      stable        $74        $59  Mild bid pressure

YES side has better liquidity (tighter spread, deeper book).

### Probability Divergence
  Side     Market  Fair Est.  Divergence           Method       Conf
  --------------------------------------------------------------------
  YES       0.750     0.842   +0.092 (underpriced) vol-CDF      high
  NO        0.260     0.158   -0.102 (overpriced)  vol-CDF      high

YES looks underpriced (+9.2%). NO looks overpriced (-10.2%).

Portfólio de paper

## Paper Portfolio

Trades: 9 | Wins: 5 | Win rate: 55.6%
Total P&L: $11.66 | Avg P&L: $1.30
Volume: $55.00 | Fees paid: $1.69

By Asset:
  BTC:  4 trades, 50.0% WR, $3.71 P&L
  ETH:  2 trades, 50.0% WR, $3.40 P&L
  SOL:  1 trades, 100.0% WR, $5.04 P&L
  XRP:  1 trades, 100.0% WR, $4.65 P&L

By Entry Price:
  0.30-0.50: 3 trades, 66.7% WR, $9.86 P&L
  0.50-0.70: 6 trades, 50.0% WR, $1.80 P&L

Requisitos

Plataforma: Windows, macOS, Linux
Rede: Acesso às APIs da Polymarket e Binance necessário.

Nenhuma chave de API necessária. As APIs de dados de mercado da Polymarket e Binance são públicas. O servidor funciona imediatamente — sem contas, sem cadastro, sem tokens. Chaves de API só são necessárias se você habilitar negociação ao vivo (veja Configuração da Carteira).

Início rápido

Opção A: Baixe o binário pré-compilado

Pegue o binário mais recente para sua plataforma em Releases e coloque-o em algum lugar no seu PATH (ou anote o caminho completo para a configuração abaixo).

Opção B: Instale do crates.io

Requer Rust 1.85+.

cargo install crypto-conduit-mcp

Conecte ao seu cliente MCP

Adicione à configuração do seu cliente MCP:

{
  "mcpServers": {
    "crypto-predict": {
      "command": "crypto-conduit-mcp"
    }
  }
}

Se o binário não estiver no seu PATH, use o caminho completo (ex.: "/path/to/crypto-conduit-mcp" ou "C:\\Users\\you\\crypto-conduit-mcp.exe").

O servidor se comunica via stdio usando o Model Context Protocol.

Primeira inicialização: O servidor precisa de ~30-45 segundos para descobrir todos os mercados ativos da Polymarket. Durante essa janela, algumas ferramentas podem mostrar dados limitados. Após o ciclo inicial de descoberta, tudo é atualizado continuamente.

Uma vez em execução, o servidor automaticamente:

Descobre novos mercados a cada 4 minutos
Consulta livros de ofertas (a cada 5s para curto prazo, 30s para diário/mensal)
Transmite preços spot da Binance a cada 3s
Monitora o stream de negociações ao vivo da Polymarket para atividade de baleias
Gera alertas (estreitamento de spread, picos de profundidade, janelas se aproximando)

Tudo isso roda em segundo plano — as ferramentas leem desse estado em cache, então as respostas são instantâneas.

Configure (opcional)

O servidor funciona sem nenhum arquivo de configuração. Para personalizar, crie uma configuração no local apropriado para a plataforma:

Windows: %APPDATA%\crypto-conduit\config.toml
macOS: ~/Library/Application Support/crypto-conduit/config.toml
Linux: ~/.config/crypto-conduit/config.toml

[logging]
enabled = false          # background data logging (JSONL files)

# [trading]              # uncomment for live trading — see Wallet Setup below
# private_key = "..."
# max_order_size_usd = 100

Configuração da carteira (negociação ao vivo)

Negociação ao vivo requer uma carteira configurada. Paper trading funciona sem nada disso.

1. Crie ou use uma carteira EOA

Você precisa de uma conta de propriedade externa (EOA) na Polygon. Pode ser uma carteira MetaMask, uma carteira dedicada de negociação ou qualquer carteira compatível com Ethereum. Não use sua carteira principal — crie uma dedicada para negociação.

2. Financie a carteira

USDC.e (USDC com ponte) na Polygon — este é o token de garantia que a Polymarket usa. Contrato: 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174. Não é o USDC nativo (0x3c499...).
Uma pequena quantidade de POL para taxas de gás (aprovações on-chain custam ~$0.001).

3. Adicione sua chave privada à configuração

[trading]
private_key = "abc123..."   # 64 hex characters, no 0x prefix
wallet_type = "eoa"
max_order_size_usd = 100    # safety cap per order
daily_loss_limit_usd = 50   # risk manager halts trading if exceeded

Segurança: Sua chave privada nunca é registrada — o servidor usa uma implementação de Debug com dados ocultos. Ainda assim, mantenha as permissões deste arquivo de configuração restritas.

4. Aprove os contratos da exchange

Antes de colocar sua primeira ordem, execute a ferramenta approve_exchange. Esta é uma transação on-chain única que aprova transferências de tokens USDC e CTF para os 3 contratos de exchange da Polymarket (CTF Exchange, Neg Risk CTF Exchange, Neg Risk Adapter).

5. Coloque ordens

Todas as ordens usam modo dry run por padrão — elas mostram o que aconteceria sem enviar nada. Para executar uma ordem real, defina confirm=true. O gerenciador de risco verifica limites diários de perda, perdas consecutivas e drawdown antes de cada ordem.

Exemplos de prompts

Uma vez conectado via MCP, experimente estes com seu agente de IA:

Descoberta e análise

"Quais mercados diários de BTC estão ativos? Ordene pelo menor spread"
"Me dê um briefing da janela atual de ETH 5m"
"Execute uma análise completa de mercado no BTC diário"
"Mostre o livro de ofertas para o strike de BTC $70k"

Simulação

"Se eu comprar BTC diário YES a 0.75 com $50, qual é meu P&L em vitória vs derrota?"
"Qual taxa de vitória eu preciso para empatar entrando a 0.65?"

Paper trading

"Faça paper trade de $10 em BTC 5m UP"
"Mostre meu portfólio de paper — há posições liquidadas?"
"Feche a posição #3"
"Configure paper trading automático em ETH 5m: tamanho $5, entrar abaixo de 0.45, apenas quando o spot mover 0.1%+"

Negociação ao vivo

"Verifique meu saldo da carteira e status de risco"
"Dry run: compre $10 de ETH diário YES a 0.52"
"Cancele todas as minhas ordens abertas"

Monitoramento

"Há alguma negociação de baleia ou alerta nos últimos 30 minutos?"
"Mostre atividade recente de baleias em todos os ativos"

Uso como biblioteca Rust

O módulo core/ não tem dependência de MCP — é uma biblioteca independente. Importe-o diretamente para bots personalizados, pipelines de dados ou interfaces alternativas:

use crypto_conduit::core::providers::binance;
use crypto_conduit::core::analysis::fees;
use crypto_conduit::core::paper::portfolio;

Ativos suportados

Ativo	Par Binance	5m	15m	Horário	Diário	Mensal
BTC	BTCUSDT	Sim	Sim	Sim	Sim	Sim
ETH	ETHUSDT	Sim	Sim	Sim	Sim	Sim
SOL	SOLUSDT	Sim	Sim	Sim	Sim	Sim
XRP	XRPUSDT	Sim	Sim	Sim	Sim	Sim
DOGE	DOGEUSDT	Sim	Sim	Sim	Sim	Sim
BNB	BNBUSDT	Sim	Sim	Sim	Sim	Não

Arquitetura

src/
├── main.rs              ← MCP server entry point
├── mcp/                 ← MCP tool layer (thin wrappers)
│   ├── mod.rs           ← Tool registration
│   ├── tools_*.rs       ← Tool handlers by category
│   └── formatter.rs     ← Response formatting
└── core/                ← Standalone library (no MCP dependency)
    ├── types.rs          ← Shared types
    ├── providers/        ← API clients (Polymarket, Binance, Chainlink)
    ├── analysis/         ← Fee model, momentum, book dynamics, divergence
    ├── paper/            ← Paper trading engine
    ├── execution/        ← Live trading (Polymarket SDK, risk manager)
    └── monitor/          ← Background polling, alerts, whale tracking, auto-trade

Licença

AGPL-3.0 — veja LICENSE para detalhes.