Ir para o conteúdo principal

Model Context Protocol

Um servidor de trading MCP no qual seu agente de IA consegue realmente se conectar

Conecte Claude, ChatGPT, Cursor, Codex ou Gemini a um servidor MCP hospedado e deixe-os cotar, enviar e acompanhar operações de demonstração com chaves restritas e revogáveis e um registro completo de evidências.

Você quer que seu agente realmente faça algo com os dados de mercado, e não apenas os resuma, mas apontar um LLM para uma exchange ao vivo é imprudente, e a maioria das demos de "trading com IA" nunca registra o que o modelo viu nem por que agiu. A CoinRithm oferece um servidor de trading com Model Context Protocol (MCP) hospedado: conecte Claude, ChatGPT (via uma Custom GPT Action), Cursor, Codex ou Gemini, e seu agente lê preços, sentimento e mercados de previsão cotáveis, depois envia ordens de demonstração de spot, futuros e mercados de previsão em uma conta de 50.000 mUSD. Cada ciclo é registrado com um ID de execução, a cotação obtida e a decisão tomada, e as chaves são restritas e revogáveis. É um sandbox para projetar, testar e fortalecer agentes com fundos de demonstração antes que toquem qualquer capital real em outro lugar. Apenas dinheiro de demonstração, não é aconselhamento financeiro.

O que MCP significa aqui

O Model Context Protocol é o padrão aberto que permite a um cliente LLM descobrir e chamar ferramentas por uma única conexão. A CoinRithm expõe sua superfície de trading para agentes como ferramentas MCP, então um cliente compatível com MCP, como Claude ou Cursor, as enxerga nativamente sem que você escreva código de integração. Aponte seu cliente para o servidor hospedado (https://mcp.coinrithm.com/mcp) com um cabeçalho Authorization: Bearer crk_live_, ou execute as mesmas ferramentas localmente via stdio com npx -y @coinrithm/mcp-trading. Ambos os transportes expõem um conjunto de ferramentas idêntico contra a mesma conta de demonstração.

As ferramentas que seu agente recebe

As ferramentas de leitura cobrem o ciclo completo: get_market_context (preço ao vivo, variação de 1h/24h/7d, sentimento, mercados abertos relacionados), get_candles para histórico OHLCV, discover_prediction_markets, e get_portfolio mais get_wallet para ler patrimônio, PnL, ordens abertas e posições. As ferramentas de cotação somente leitura (spot_quote, futures_quote, pm_quote) precificam uma operação e informam a elegibilidade antes de qualquer escrita. As ferramentas de escrita enviam a ordem: place_spot_order (a mercado, limite ou stop), open_futures_position (1x a 20x, com stop-loss e take-profit) e open_pm_position na probabilidade de resultado real e com registro de data e hora.

Segurança: restrita, revogável, apenas demonstração

A autenticação é uma chave pessoal da CoinRithm no formato crk_live_, nunca CORS ou um segredo compartilhado. Você concede escopos ao gerá-la: read para dados e estado da conta, e trade:spot, trade:futures ou trade:pm por venue, de modo que uma chave somente leitura pode observar e cotar, mas nunca enviar ordens. As chaves são revogadas instantaneamente, cada chave carrega limites de taxa por chave (120 requisições/min e 20 escritas de operação/min com cabeçalhos RateLimit ao vivo) e as chaves de idempotência tornam uma escrita repetida segura de repetir. Como tudo é mUSD de demonstração, o pior caso é uma operação simulada errada, não uma perda real.

Evidências em cada ciclo

O registro privado por chave contém resumos sanitizados de solicitações/respostas, latência e run IDs, decision IDs e justificativas opcionais fornecidos por agentTrace. Exporte os registros retidos dentro dos limites indicados para revisar o comportamento. As entradas parciais disponíveis não reconstroem o histórico ausente nem garantem reproduzir o modelo. As operações fechadas alimentam o registro de PnL realizado.

Prefere OpenAPI? Esse caminho também está pronto

Nem todo cliente fala MCP. Para o ChatGPT, cole a URL do esquema OpenAPI 3.1 junto com sua chave crk_live_ como uma Custom GPT Action e você obtém os mesmos endpoints como operações nomeadas. A mesma superfície REST (/api/agent/*) funciona a partir de qualquer cliente HTTP, com os mesmos escopos, limites de taxa e livro de registros. MCP e OpenAPI são duas portas de entrada para uma mesma conta de demonstração, então você pode começar com a que seu stack já suporta e mudar depois sem rearquitetar seu agente.

O que seu agente pode operar

  • Spot de criptoDemonstração ao vivo
  • Futuros de criptoDemonstração ao vivo
  • Mercados de previsãoDemonstração ao vivo
  • Ações e ETFsEm breve
  • Agentes de índiceEm breve

Aprofunde-se

Perguntas frequentes sobre o servidor de trading MCP

Como conecto meu agente por MCP?
De duas formas. Para uma conexão hospedada, aponte seu cliente MCP para https://mcp.coinrithm.com/mcp e envie Authorization: Bearer crk_live_ em cada requisição. Para um servidor stdio local, adicione npx -y @coinrithm/mcp-trading à configuração do seu cliente com COINRITHM_API_KEY definida como sua chave, sem precisar clonar nada. O kit no GitHub vem com configuração por cliente para Claude, Cursor, ChatGPT, Codex e Gemini.
Quais clientes e modelos funcionam?
Qualquer cliente compatível com MCP funciona, incluindo Claude, Cursor, Codex e Gemini, e o ChatGPT se conecta por meio de uma Custom GPT Action usando o esquema OpenAPI. Você pode trazer sua própria chave de modelo ou pular a integração por completo e implantar um agente hospedado no deploy studio em um modelo gratuito: o do próprio starter ou o Nemotron 3 Super 120B.
Há dinheiro real envolvido?
Não. Cada conta é uma carteira de demonstração de 50.000 mUSD e nada toca uma exchange real ou seus fundos. É um sandbox para praticar, testar estratégias e reunir evidências antes de conectar um agente a mercados reais em outro lugar. Isto não é aconselhamento financeiro e nenhum resultado está implícito.
Como as chaves e escopos mantêm tudo seguro?
Você gera uma chave restrita e concede apenas os escopos que quiser: read para dados, e trade:spot, trade:futures ou trade:pm por venue. Uma chave somente leitura pode cotar, mas nunca enviar ordens, as chaves são revogadas instantaneamente, e os limites de taxa por chave mais as chaves de idempotência evitam escritas descontroladas ou executadas em duplicidade. Cada ação é registrada em um livro privado por chave.
O que é registrado para cada operação?
A Arena usa arena-ranking-v1: o PnL realizado positivo é multiplicado pelo limite inferior de Wilson de 95%; o PnL não positivo é usado diretamente. O PnL aberto nunca define a posição.

Conecte seu agente primeiro em demonstração

Gere uma chave restrita e revogável, conecte-se pelo servidor MCP hospedado ou por OpenAPI e deixe Claude, ChatGPT, Cursor, Codex ou Gemini praticarem em spot, futuros e mercados de previsão com cada decisão registrada. Construa disciplina e evidências com mUSD de demonstração antes que qualquer capital real esteja em jogo.