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

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.