CryptoStruct

oficial

Servidor MCP remoto para dados históricos de criptomoedas e mercados de previsão: pesquise ~500K instrumentos, estatísticas de mercado ao vivo (OHLC, volume, spreads, profundidade, slippage) e compra de tick-data. Sem chave para catálogo e estatísticas; OAuth opcional para ferramentas de conta. Endpoint: https://cryptostruct.com/mcp

GitHubExperimente este MCPPatrocinado

O que você pode fazer com CryptoStruct MCP?

Pesquisar o catálogo de instrumentos — Solicite instrumentos em 35 mercados, incluindo mercados de previsão, usando search_instruments com filtros como class=prediction.
Obter snapshots de mercado em tempo real — Solicite OHLC atual, VWAP, spreads e profundidade de livro de ofertas para qualquer instrumento via get_market_snapshot.
Analisar agregados históricos — Consulte estatísticas diárias, horárias ou por minuto (ex.: get_daily_stats, get_hourly_stats) para estudos de eventos ou análise de tendências.
Verificar cobertura de arquivo — Confirme a disponibilidade de dados em nível diário para um instrumento desde 2021 usando get_coverage.
Pré-visualizar e iniciar compras — Use preview_checkout para testar uma compra de dados e depois create_checkout para obter uma URL do Stripe ou acionar a aprovação de crédito.
Gerenciar sua conta — Liste pedidos anteriores, baixe arquivos comprados e verifique o saldo de assinatura ou crédito com list_my_orders e get_my_subscription.

Documentação

Servidor MCP CryptoStruct

Servidor MCP remoto de primeira parte para cryptostruct.com — dados históricos de criptomoedas e mercados de previsão (arquivos diários em nível de tick de 35 plataformas, incluindo Kalshi e Polymarket), além de estatísticas de mercado ao vivo, criado para traders, quants e agentes de IA.

Este repositório documenta o servidor hospedado. Não há nada para instalar ou executar a partir daqui — o servidor é operado pela CryptoStruct.

Endpoint: https://cryptostruct.com/mcp (HTTP Streamable, sem estado, modo JSON)
Endpoint OAuth: https://cryptostruct.com/mcp/auth (mesmas ferramentas; responde a 401 + WWW-Authenticate para acionar o fluxo OAuth padrão — Dynamic Client Registration + PKCE)
Cartão do servidor: /.well-known/mcp/server-card.json
Documentação: https://cryptostruct.com/docs/mcp · Documentação do produto: https://docs.cryptostruct.com

Nenhuma chave de API é necessária — o catálogo, as estatísticas de mercado e o fluxo de compra para convidados funcionam sem chave. Entrar via OAuth (opcional) vincula sua conta CryptoStruct para histórico de pedidos, downloads de arquivos comprados e pagamento com seus créditos — sempre com seu consentimento (veja Compra de dados).

Início rápido

Claude Code

claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth

Cursor / configuração JSON genérica

{
  "mcpServers": {
    "cryptostruct": {
      "url": "https://cryptostruct.com/mcp"
    }
  }
}

claude.ai — Configurações → Conectores → Adicionar conector personalizado → https://cryptostruct.com/mcp/auth

O que você pode fazer

Catálogo e descoberta: pesquise ~500 mil instrumentos em 35 plataformas (spot, perpétuos, futuros, opções, mercados de previsão), com cobertura de arquivo diário desde 2021-02-08.
Mercados de previsão: contratos de eventos da Kalshi e Polymarket são instrumentos de primeira classe — pesquisáveis no catálogo (class=prediction), com cobertura, snapshots ao vivo e agregados por minuto/dia como qualquer instrumento de cripto. Os contratos são cotados em 0..1 (USD); o volume é normalizado em USD.
Estatísticas de mercado: snapshots ao vivo e agregados por minuto/hora/dia — OHLC, VWAP, negociações, volume, spreads, profundidade do book; curvas de slippage / impacto de mercado.
Compra de dados: arquivos de tick brutos — tanto para instrumentos de cripto quanto de mercados de previsão — custam €1 por instrumento-dia. Pagamento com cartão: o servidor repassa uma URL de checkout do Stripe — o pagamento ocorre no navegador do usuário, o servidor nunca toca nos dados do cartão. Arquivos de amostra gratuitos de dia completo estão disponíveis sem qualquer compra.
Créditos e consentimento do agente (login OAuth): os créditos da conta nunca são gastos por um agente sem o consentimento do usuário. Por padrão, create_checkout responde a approval_required com uma página de aprovação onde o usuário confirma (paga com créditos ou cartão) ou descarta o pedido; pedidos não aprovados expiram após 24 h sem cobrança. Os usuários podem optar por compras autônomas dentro de limites (limites por pedido e por janela móvel de 24 horas) em https://cryptostruct.com/account/agents — então pedidos totalmente cobertos por créditos são concluídos imediatamente; qualquer valor acima dos limites volta para aprovação. O agente também pode passar seu próprio max_credit_cents. preview_checkout informa ao agente antecipadamente qual dos três resultados esperar. Essas configurações só podem ser alteradas no site, nunca por meio do token de um agente.
Ferramentas de conta (login OAuth): liste pedidos, obtenha URLs de download para arquivos comprados, verifique assinatura, saldo de créditos e configurações de gastos do agente.

Ferramentas

Ferramenta	Descrição	Nível
`get_data_dictionary`	Dicionário de dados e referência do produto (formato de arquivo, unidades, preços)	gratuito
`search_instruments`	Pesquise o catálogo de instrumentos	gratuito
`list_venues`	Liste as plataformas cobertas	gratuito
`get_instrument`	Detalhes do instrumento	gratuito
`get_coverage`	Cobertura de arquivo diário para um instrumento	gratuito
`list_sample_files`	Arquivos de amostra gratuitos de dia completo	gratuito
`get_price_quote`	Cotação de preço para um conjunto de arquivos de dados	gratuito
`get_market_snapshot`	Snapshot de mercado ao vivo (60 min + 24 h)	gratuito
`get_daily_stats`	Agregados diários (30d–180d gratuitos; 365d/máx Premium)	gratuito
`get_hourly_stats`	Agregados horários (7d–90d gratuitos; 180d Premium)	gratuito
`get_slippage`	Curva de slippage / impacto de mercado (1h gratuita; 24h/7d Premium)	gratuito
`get_top_instruments`	Principais instrumentos por volume de 24 h ao vivo	gratuito
`get_movers`	Movimentadores de 24 h (altas e baixas)	gratuito
`get_minutes_range`	Série histórica por minuto para estudos de eventos	premium
`create_checkout`	Inicie uma compra — URL do Stripe (cartão) ou `approval_required` / born-paid (créditos, conforme as configurações de consentimento do usuário)	comércio
`get_checkout_status`	Consulte um checkout por `session_id` (cartão) ou `order_id` (conectado; pedidos de crédito/aprovação)	comércio
`get_order_files`	Liste os arquivos de um pedido pago com URLs de download	comércio
`request_file_restore`	Restaure um arquivo arquivado (armazenamento frio)	comércio
`list_my_orders`	Meus pedidos	login
`get_my_files`	Meus arquivos comprados	login
`get_my_subscription`	Minha assinatura, saldo de créditos e configurações de gastos do agente	login
`preview_checkout`	Simulação de compra: arquivos possuídos/indisponíveis, cobertura de créditos e se `create_checkout` será concluído, pedirá aprovação ou repassará ao Stripe	login

Níveis: free/commerce funcionam sem chave. sign-in exige login OAuth verificado (qualquer conta). Ferramentas/parâmetros premium exigem CryptoStruct Premium (€20/mês) — que também desbloqueia janelas de estatísticas mais longas (diário 365d/máx, horário 180d, slippage 24h/7d), limites de pesquisa maiores, um bloco de qualidade de dados em get_market_snapshot e um orçamento de chamadas 5×. Chamadas além do seu nível retornam erros estáticos AUTH_REQUIRED / PREMIUM_REQUIRED com uma URL de upgrade — nunca uma falha grave.

Limites de taxa

Orçamento ponderado por chamador: 120 unidades/min sem chave (por IP) ou por usuário conectado, 600 unidades/min para Premium. Leituras baratas do catálogo custam 1 unidade, estatísticas com uso intensivo de upstream 3–5, checkout 10. Em erros RATE_LIMITED, aguarde o número de segundos indicado.

Convenções

Todos os tamanhos de arquivo são em bytes compactados (zstd); valores de mercado em USD; preços de venda em EUR.
Dados com granularidade por minuto são retidos ~30 dias no upstream; agregados horários/diários alcançam mais longe.
Arquivos de tick são capturas JSON-lines de dia completo (snapshots e atualizações do orderbook, negociações, liquidações, funding, mark/index incluindo gregas de opções). Referência de formato: Market Data Protocol.

Relacionados

Agent Skill para análise dos arquivos de tick: cryptostruct-market-data (zip)
Índice de descoberta de skills: /.well-known/agent-skills/index.json
Catálogo de API (RFC 9727): /.well-known/api-catalog
llms.txt: https://cryptostruct.com/llms.txt

Suporte

Perguntas ou problemas: https://cryptostruct.com/contact