WickedAPI

Servidor MCP de WickedAPI

Servidor MCP para toda la plataforma WickedAPI — datos de trading, salud de protocolos DeFi, seguridad de tokens y sincronización de brokers, en un solo servidor.

35 herramientas en 4 servicios en vivo, generadas automáticamente desde el openapi.json propio de cada servicio — la lista de herramientas siempre coincide con lo que realmente está desplegado:

Servicio	Herramientas	Autenticación
API de Datos de Trading	22 (sin prefijo: price, ohlcv, fvg, momentum_score, sentiment, macro_calendar, …)	Clave API o x402, 5 gratuitas
Oráculo de Salud de Protocolos	6 (protocol_health_*)	Clave API o x402, marcador gratuito
Oráculo de Riesgo de Tokens	1 (token_risk)	100% gratuito, sin clave
API de Sincronización de Brokers	6 (broker_sync_*)	Clave API o x402

Además, 6 recursos (el directorio de la plataforma, llms.txt, y el catálogo de endpoints en vivo de cada servicio) y 3 indicaciones (rug_check, vet_dependency, morning_briefing) que encadenan herramientas de la misma manera que el libro de recetas.

Sin necesidad de registro

Cada herramienta accede a un endpoint real protegido por x402 (pago por llamada nativo de HTTP, USDC en Base) con un respaldo de clave API — y la herramienta del Oráculo de Riesgo de Tokens es gratuita sin importar qué:

• Configuración cero — las llamadas sin credenciales siguen funcionando; los endpoints de pago devuelven el desafío de pago 402 real (precio, red, payTo) como resultado de la herramienta.
• Pago por llamada autónomo — establece WICKEDAPI_PAYER_PRIVATE_KEY con la clave privada de una billetera financiada en Base-mainnet, y cada llamada paga automáticamente ~$0.001 en USDC y devuelve datos reales. Sin cuenta, sin suscripción.
• Clave API de socio — establece WICKEDAPI_API_KEY para acceso gratuito con límite de velocidad en los cuatro servicios (la misma clave funciona en todas partes).

Instalación

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

O para pago por llamada autónomo en lugar de una clave:

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

¿Nada configurado? La herramienta del Oráculo de Riesgo de Tokens y los 5 endpoints gratuitos de la API de Datos de Trading (sentiment, macro_calendar, market_overview, gas, kalshi_probability) siguen funcionando sin configuración alguna.

Recursos

Lee sin llamar a una herramienta — útil para un cliente que muestra recursos en su interfaz:

• wickedapi://platform/services — el directorio completo de servicios (JSON)
• wickedapi://platform/llms — el llms.txt de la plataforma
• wickedapi://trading/status, wickedapi://protocol_health/status, wickedapi://token_risk/status, wickedapi://broker_sync/status — el catálogo de endpoints en vivo de cada servicio

Indicaciones

Flujos de trabajo de un clic que encadenan llamadas reales a herramientas (Claude Desktop y otros clientes conscientes de indicaciones los muestran directamente):

• rug_check (address, chain, symbol opcional) — verificación de riesgo de token + sentimiento de mercado + lectura de impulso opcional, antes de comprar.
• vet_dependency (slug, token_address opcional, chain) — salud del protocolo + verificación de riesgo a nivel de contrato opcional, antes de construir sobre un protocolo DeFi.
• morning_briefing (symbol opcional) — calendario macro + calendario de ganancias + sentimiento + veredicto de impulso, como un solo resumen.

Variables de entorno

Variable	Requerida	Notas
WICKEDAPI_API_KEY	no	Acceso gratuito con límite de velocidad en los cuatro servicios (la misma clave funciona en todas partes).
WICKEDAPI_PAYER_PRIVATE_KEY	no	Clave privada de billetera en Base-mainnet. Si se establece, cada llamada paga automáticamente el desafío x402 en USDC — sin necesidad de clave.
WICKEDAPI_BASE_URL	no	Sobrescribe la base de la API de Datos de Trading (predeterminado https://api.wickedapi.com).
WICKEDAPI_PROTOCOL_HEALTH_URL	no	Sobrescribe la base del Oráculo de Salud de Protocolos (predeterminado https://protocol-health-oracle.wickedapi.com).
WICKEDAPI_TOKEN_RISK_URL	no	Sobrescribe la base del Oráculo de Riesgo de Tokens (predeterminado https://token-risk-oracle.wickedapi.com).
WICKEDAPI_BROKER_SYNC_URL	no	Sobrescribe la base de la API de Sincronización de Brokers (predeterminado https://broker-sync-api.wickedapi.com).
WICKEDAPI_SHOWCASE_URL	no	Sobrescribe la base del directorio de la plataforma utilizada por los recursos (predeterminado https://wickedapi.com).

Si ni WICKEDAPI_API_KEY ni WICKEDAPI_PAYER_PRIVATE_KEY están establecidos, las llamadas de pago aún tienen éxito a nivel de protocolo — recibirás el desafío 402 real como resultado de la herramienta en lugar de datos. Si la especificación de un servicio falla al cargar (problema de red, ese servicio está caído), sus herramientas simplemente se omiten para la sesión — el resto se registra normalmente.

Desarrollo local

npm install
npm run build
node dist/index.js

Qué no es esto

Este servidor no reimplementa ninguna lógica de datos — es un puente delgado y generado automáticamente desde llamadas de herramientas MCP hacia los endpoints HTTP en vivo de WickedAPI en los cuatro servicios. Todos los datos reales de mercado, indicadores, puntuaciones y señales de riesgo viven en las propias APIs.