WickedAPI

Servidor MCP WickedAPI

Servidor MCP para toda a plataforma WickedAPI — dados de negociação, saúde de protocolos DeFi, segurança de tokens e sincronização de corretoras, em um único servidor.

35 ferramentas em 4 serviços ativos, geradas automaticamente a partir do openapi.json ativo de cada serviço — a lista de ferramentas sempre corresponde ao que está realmente implantado:

Serviço	Ferramentas	Autenticação
API de Dados de Negociação	22 (sem prefixo: price, ohlcv, fvg, momentum_score, sentiment, macro_calendar, …)	Chave de API ou x402, 5 gratuitas
Oracle de Saúde de Protocolo	6 (protocol_health_*)	Chave de API ou x402, placar gratuito
Oracle de Risco de Token	1 (token_risk)	100% gratuito, sem chave
API de Sincronização de Corretoras	6 (broker_sync_*)	Chave de API ou x402

Além de 6 recursos (o diretório da plataforma, llms.txt e o catálogo de endpoints ativos de cada serviço) e 3 prompts (rug_check, vet_dependency, morning_briefing) que encadeiam ferramentas da mesma forma que o livro de receitas faz.

Sem necessidade de cadastro

Cada ferramenta acessa um endpoint real protegido por x402 (pagamento por chamada nativo de HTTP, USDC na Base) com fallback para chave de API — e a ferramenta do Oracle de Risco de Token é gratuita independentemente de tudo:

• Zero configuração — chamadas sem credenciais ainda funcionam; endpoints pagos retornam o desafio de pagamento 402 real (preço, rede, payTo) como resultado da ferramenta.
• Pagamento por chamada autônomo — defina WICKEDAPI_PAYER_PRIVATE_KEY com a chave privada de uma carteira financiada na mainnet da Base, e cada chamada paga automaticamente ~$0,001 em USDC e retorna dados reais. Sem conta, sem assinatura.
• Chave de API de parceiro — defina WICKEDAPI_API_KEY para acesso gratuito com limite de taxa em todos os quatro serviços (a mesma chave funciona em todos os lugares).

Instalação

{
  "mcpServers": {
    "wickedapi": {
      "command": "npx",
      "args": ["-y", "wickedapi-mcp"],
      "env": {
        "WICKEDAPI_API_KEY": "your-key-here"
      }
    }
  }
}

Ou para pagamento por chamada autônomo em vez de uma chave:

{
  "mcpServers": {
    "wickedapi": {
      "command": "npx",
      "args": ["-y", "wickedapi-mcp"],
      "env": {
        "WICKEDAPI_PAYER_PRIVATE_KEY": "0xyour-base-wallet-private-key"
      }
    }
  }
}

Nada configurado? A ferramenta do Oracle de Risco de Token e os 5 endpoints gratuitos da API de Dados de Negociação (sentiment, macro_calendar, market_overview, gas, kalshi_probability) ainda funcionam sem nenhuma configuração.

Recursos

Leia sem chamar uma ferramenta — útil para um cliente que exibe recursos em sua interface:

• wickedapi://platform/services — o diretório completo de serviços (JSON)
• wickedapi://platform/llms — o llms.txt da plataforma
• wickedapi://trading/status, wickedapi://protocol_health/status, wickedapi://token_risk/status, wickedapi://broker_sync/status — o catálogo de endpoints ativos de cada serviço

Prompts

Fluxos de trabalho com um clique que encadeiam chamadas reais de ferramentas (Claude Desktop e outros clientes com suporte a prompts exibem isso diretamente):

• rug_check (address, chain, symbol opcional) — verificação de risco de token + sentimento de mercado + leitura opcional de momentum, antes de comprar.
• vet_dependency (slug, token_address opcional, chain) — saúde do protocolo + verificação opcional de risco em nível de contrato, antes de construir em um protocolo DeFi.
• morning_briefing (symbol opcional) — calendário macro + calendário de lucros + sentimento + veredito de momentum, como um único resumo.

Variáveis de ambiente

Variável	Obrigatória	Observações
WICKEDAPI_API_KEY	não	Acesso gratuito com limite de taxa em todos os quatro serviços (a mesma chave funciona em todos os lugares).
WICKEDAPI_PAYER_PRIVATE_KEY	não	Chave privada da carteira na mainnet da Base. Se definida, cada chamada paga automaticamente o desafio x402 em USDC — sem necessidade de chave.
WICKEDAPI_BASE_URL	não	Substitui a base da API de Dados de Negociação (padrão https://api.wickedapi.com).
WICKEDAPI_PROTOCOL_HEALTH_URL	não	Substitui a base do Oracle de Saúde de Protocolo (padrão https://protocol-health-oracle.wickedapi.com).
WICKEDAPI_TOKEN_RISK_URL	não	Substitui a base do Oracle de Risco de Token (padrão https://token-risk-oracle.wickedapi.com).
WICKEDAPI_BROKER_SYNC_URL	não	Substitui a base da API de Sincronização de Corretoras (padrão https://broker-sync-api.wickedapi.com).
WICKEDAPI_SHOWCASE_URL	não	Substitui a base do diretório da plataforma usada pelos recursos (padrão https://wickedapi.com).

Se nem WICKEDAPI_API_KEY nem WICKEDAPI_PAYER_PRIVATE_KEY estiverem definidos, chamadas pagas ainda funcionam no nível do protocolo — você receberá o desafio 402 real de volta como resultado da ferramenta em vez de dados. Se a especificação de um serviço falhar ao carregar (instabilidade de rede, serviço fora do ar), suas ferramentas são simplesmente ignoradas na sessão — o restante ainda é registrado normalmente.

Desenvolvimento local

npm install
npm run build
node dist/index.js

O que isto não é

Este servidor não reimplementa nenhuma lógica de dados — é uma ponte fina e gerada automaticamente de chamadas de ferramentas MCP para os endpoints HTTP ativos da WickedAPI em todos os quatro serviços. Todos os dados reais de mercado, indicadores, pontuações e sinais de risco vivem nas próprias APIs.