wickedapi-mcp

WickedAPI MCP Server

MCP server for WickedAPI — an agent-ready trading & market-data API covering crypto/stock prices, OHLCV, technical indicators (ATR, Fair Value Gaps, ICT liquidity levels), perp funding/OI, order books, Kalshi prediction markets, DeFi TVL, volatility, a verified macro calendar, an earnings calendar, and an AI momentum score.

Tools are generated automatically from the live openapi.json, so the tool list always matches what's actually deployed.

No signup required

Every tool call hits a real /v1/* endpoint that's gated by x402 (HTTP-native pay-per-call, USDC on Base) with an API-key fallback:

• Zero config — calls without credentials still work; you'll get back the real 402 payment challenge (price, network, payTo) as the tool result.
• Autonomous pay-per-call — set WICKEDAPI_PAYER_PRIVATE_KEY to a funded Base-mainnet wallet's private key, and every call auto-pays ~$0.001 in USDC and returns real data. No account, no subscription.
• Partner API key — set WICKEDAPI_API_KEY for free, rate-limited access if you have one.

Install

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

Or for autonomous pay-per-call instead of a key:

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

Environment variables

Var	Required	Notes
WICKEDAPI_API_KEY	no	Free, rate-limited access if you have a partner key.
WICKEDAPI_PAYER_PRIVATE_KEY	no	Base-mainnet wallet private key. If set, every call auto-pays the x402 challenge in USDC — no key needed.
WICKEDAPI_BASE_URL	no	Override the API base (default https://api.wickedapi.com).

If neither WICKEDAPI_API_KEY nor WICKEDAPI_PAYER_PRIVATE_KEY is set, calls still succeed at the protocol level — you'll get the real 402 challenge back as the tool result instead of data.

Local development

npm install
npm run build
node dist/index.js

What this is not

This server doesn't reimplement any data logic — it's a thin, auto-generated bridge from MCP tool calls to the live WickedAPI HTTP endpoints. All the actual market data, indicators, and scoring live in the API itself.