Wicked API - Agent First API Services
# WickedAPI MCP Server
MCP server for [WickedAPI](https://api.wickedapi.com) — 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`](https://api.wickedapi.com/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](https://x402.org) (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
```json
{
"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:
```json
{
"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
```bash
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.
TDQS
Scored across 22 tools
Each tool targets a distinct financial data type or source (e.g., ATR, FVG, basis, earnings calendar, Kalshi probability vs. market depth). No two tools serve the same purpose, and descriptions clearly delineate their outputs.
All tool names use lowercase snake_case with a consistent pattern of single nouns or verb_noun phrases (e.g., 'price', 'earnings_calendar', 'long_short_ratio'). No mixed naming conventions.
22 tools is slightly above the ideal range, but the wide scope of financial data (crypto, equities, macro, derivatives) justifies the count. Each tool adds distinct value without excessive redundancy.
The set covers a broad range of financial data (technical, fundamental, macro, sentiment, prediction markets) but lacks fundamental stock data (e.g., financials, dividends), forex, or commodities, leaving notable gaps for a comprehensive financial API.