Finance Toolkit
500+ transparent financial methods calculated from raw statements, not third-party endpoints.
Description from the maker (original English)
Whole Wicked suite for agents: market data, SEC filings, wallet checks, risk, identity, memory.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
WICKEDAPI_API_KEY, WICKEDAPI_PAYER_PRIVATE_KEYValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Works in Claude on the web, desktop and mobile:
https://mcp.wickedapi.com/mcpOpen Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"wicked": {
"command": "npx",
"args": [
"-y",
"@wickedlabs/wicked-mcp"
],
"env": {
"WICKEDAPI_API_KEY": "your-value",
"WICKEDAPI_PAYER_PRIVATE_KEY": "your-value"
}
}
}
}Run this in your terminal
claude mcp add --transport http wicked https://mcp.wickedapi.com/mcpclaude mcp add wicked --env WICKEDAPI_API_KEY=your-value --env WICKEDAPI_PAYER_PRIVATE_KEY=your-value -- npx -y @wickedlabs/wicked-mcpFill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"wicked": {
"url": "https://mcp.wickedapi.com/mcp"
}
}
}Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"wicked": {
"command": "npx",
"args": [
"-y",
"@wickedlabs/wicked-mcp"
],
"env": {
"WICKEDAPI_API_KEY": "your-value",
"WICKEDAPI_PAYER_PRIVATE_KEY": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"wicked": {
"type": "http",
"url": "https://mcp.wickedapi.com/mcp"
}
}
}Paste into .vscode/mcp.json in your project
{
"servers": {
"wicked": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wickedlabs/wicked-mcp"
],
"env": {
"WICKEDAPI_API_KEY": "your-value",
"WICKEDAPI_PAYER_PRIVATE_KEY": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
ChatGPT connects only to servers on the internet:
https://mcp.wickedapi.com/mcpMenu names can differ slightly by plan and over time.
Your choice stays on this device in a cookie; no account needed.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.
kalshi_probability[Trading Data API] Free, no signup required. Kalshi prediction-market probabilities. Query by category (returns the most active open markets) or a specific market ticker. **Example:** `/v1/kalshi-probability?category=crypto` Use when you want live Kalshi prediction-market probabi
kalshi_market[Trading Data API] Single Kalshi market depth: orderbook (yes/no levels) + recent trades for a specific ticker. **Example:** `/v1/kalshi-market?ticker=KXBTCD-26JUN1315-T64099.99` Use when you need one Kalshi market's orderbook and recent trades by ticker. Not for browsing markets
funding_oi[Trading Data API] Aggregated perpetual-futures funding rate & open interest from Binance + Bybit, with 7-day average funding, 24h OI change, and a long/short bias signal. **Example:** `/v1/funding-oi?symbol=BTC` Use when you want perp funding rates and open interest aggregated f
long_short_ratio[Trading Data API] Binance long/short ratios: global account, top-trader account, top-trader position, and taker buy/sell. Companion to funding-oi. **Example:** `/v1/long-short-ratio?symbol=BTC&period=1h` Use when you want Binance positioning ratios (global accounts, top traders,
orderbook[Trading Data API] Top-of-book depth + spread (bps) from Binance, Bybit, or Hyperliquid. **Example:** `/v1/orderbook?symbol=BTC&exchange=binance&depth=10` Use when you need top-of-book depth and spread (bps) on Binance, Bybit or Hyperliquid. Not for a prediction-market book (use
basis[Trading Data API] Spot-vs-perp basis (premium %) with funding-implied annualized carry. Spot from Coinbase; perp marks from Binance + Bybit. **Example:** `/v1/basis?symbol=BTC` Use when you want the spot-vs-perp premium and funding-implied annualized carry for a basis trade. Not
hyperliquid[Trading Data API] Hyperliquid perpetual context: funding (hourly), open interest, mark/oracle/mid price, premium, 24h volume. Not geo-blocked. **Example:** `/v1/hyperliquid?symbol=BTC` Use when you need Hyperliquid perp context: funding, open interest, mark/oracle price, premium
volatility[Trading Data API] Deribit volatility: DVOL implied-vol index (30d forward) + latest realized volatility, for BTC or ETH. **Example:** `/v1/volatility?currency=BTC` Use when you want Deribit implied volatility (DVOL) next to realized volatility for BTC or ETH. Not for other asset
sentiment[Trading Data API] Free, no signup required. Crypto Fear & Greed Index (alternative.me), current reading + optional history. **Example:** `/v1/sentiment?limit=7` Use when you want the crypto Fear & Greed reading as a quick market-mood signal. Not for asset-specific direction (use
defi_tvl[Trading Data API] DefiLlama data: TVL by chain, stablecoin circulating supply, or yield pools. **Example:** `/v1/defi-tvl?view=chains` Use when you need DeFi TVL by chain, stablecoin supply or yield pools from DefiLlama. Not for the health or risk of one protocol (use protocol_h
price[Trading Data API] Current spot price for crypto (Coinbase) or US equities/ETFs (Alpaca SIP), via the shared routing layer. **Example:** `/v1/price?symbol=BTC` Use when you need the current spot price of one crypto asset or US stock/ETF. Not for history or candles (use ohlcv), or
ohlcv[Trading Data API] OHLCV candles (oldest-first) for crypto or stocks. Routes to Alpaca SIP / Alpaca-crypto / Coinbase. **Example:** `/v1/ohlcv?symbol=NVDA&timeframe=1h&limit=100` Use when you need historical candles to chart or compute indicators yourself. Not for only the latest
atr[Trading Data API] Average True Range (Wilder's) + volatility-regime classification (low/normal/high/extreme by historical percentile). Crypto or stocks. **Example:** `/v1/atr?symbol=BTC&timeframe=1h&period=14` Use when you need volatility for position sizing or stops: Wilder ATR
rates[Trading Data API] US Treasury yield curve (1M–30Y) + recession-indicator spreads (10y-2y, 10y-3m), from FRED. **Example:** `/v1/rates` Use when you need the US Treasury yield curve and recession spreads (10y-2y, 10y-3m). Not for event dates (use macro_calendar). Behavior: read-o
market_clock[Trading Data API] US equities market clock (is_open, next_open/close) + upcoming sessions, via Alpaca. Crypto endpoints are 24/7 and unaffected. **Example:** `/v1/market-clock` Use when you need to know whether US equity markets are open and when the next session opens or closes
market_overview[Trading Data API] Free, no signup required. CoinGecko global crypto stats (total market cap, 24h volume, BTC/ETH dominance) or top coins by market cap. **Example:** `/v1/market-overview` Use when you want global crypto stats: total market cap, 24h volume, BTC and ETH dominance.
gas[Trading Data API] Free, no signup required. Ethereum gas oracle (safe/propose/fast gas prices + base fee, in gwei), via Etherscan. **Example:** `/v1/gas` Use when you need current Ethereum gas prices (safe, standard, fast) and the base fee before sending a transaction. Not for o
fvg[Trading Data API] Fair Value Gap zones (standard ICT/LuxAlgo) with CE (50%), gap size, age, fill status, distance from price. Standard timeframes match TradingView candles. Crypto or stocks. **Example:** `/v1/fvg?symbol=BTC&timeframe=1h` Use when you want Fair Value Gap zones (I
liquidity_levels[Trading Data API] ICT liquidity levels: buy-side liquidity (above swing highs) & sell-side (below swing lows), sweep/taken status, relative-equal pools, and nearest untaken targets. Crypto or stocks. **Example:** `/v1/liquidity-levels?symbol=TQQQ&timeframe=1h` Use when you want
macro_calendar[Trading Data API] Free, no signup required. Upcoming US macro events (FOMC rate decisions, CPI, jobs report) with verified Fed/BLS dates, days-until, and Kalshi rate-decision odds (cut/hold/hike) for FOMC meetings. **Example:** `/v1/macro-calendar` Use when you want upcoming US
earnings_calendar[Trading Data API] US equity earnings announcement calendar: report date, before/after-market timing, analyst EPS estimate + count, market cap, and prior-year actual EPS. Sourced live from Nasdaq's public calendar. **Example:** `/v1/earnings-calendar?date=2026-07-14&days=3` Use w
wallet_portfolio[Trading Data API] What a wallet holds: native balance plus major ERC-20 tokens (stablecoins, wrapped assets, large caps) across Ethereum, Base, Arbitrum, Optimism and Polygon, with live USD prices, per-chain and total value. Address or ENS name. Reads the chain directly; tokens
verdict[Trading Data API] One-call trading verdict for an asset: LONG, SHORT or NEUTRAL bias with a 0-10 confidence, a one-line thesis, entry, invalidation and two targets, and the trend / momentum / structure / liquidity readings behind it. Mechanical scoring from live candles on two t
momentum_score[Trading Data API] Alias of /v1/verdict. Multi-asset momentum verdict (bias, confidence, thesis, entry/invalidation/targets, signal readings) from the oracle.py pipeline, run on a separate Python service. Scoped to 10 assets. **Example:** `/v1/momentum-score?symbol=BTC&timeframe=
chain_balance[Trading Data API] Native-token balance (ETH/POL) for any address or ENS name on Ethereum, Base, Arbitrum, Optimism or Polygon. Live from the chain over redundant RPCs — wei plus formatted units. **Example:** `/v1/chain-balance?address=vitalik.eth&chain=ethereum` Use when you nee
chain_token_balance[Trading Data API] ERC-20 token balance for an address or ENS name, with token symbol and decimals read from the contract. Ethereum, Base, Arbitrum, Optimism, Polygon. **Example:** `/v1/chain-token-balance?address=0xB71C06dAC44c91bc997FB84C247DeEF676F4A9f6&token=0x833589fCD6eDb6E
chain_nonce[Trading Data API] Transaction count (nonce) for an address or ENS name: confirmed nonce plus pending nonce, so an agent can sign the next transaction without a collision. **Example:** `/v1/chain-nonce?address=0xB71C06dAC44c91bc997FB84C247DeEF676F4A9f6&chain=base` Use when you ne
chain_block[Trading Data API] Block header lookup: number, hash, timestamp, miner, tx count, gas used/limit and base fee. Latest by default, or any block number, safe or finalized. **Example:** `/v1/chain-block?chain=base&block=latest` Use when you need a block header (number, hash, time, m
chain_ens[Trading Data API] ENS lookup on Ethereum mainnet in either direction: name to address, or address to primary name. **Example:** `/v1/chain-ens?name=vitalik.eth` Use when you need to resolve an ENS name to an address, or an address to its primary ENS name. Not for non-ENS lookups
chain_tx[Trading Data API] Transaction lookup by hash: status (success/reverted/pending), block, from/to, value, nonce, gas used, effective gas price and log count. **Example:** `/v1/chain-tx?hash=0x...&chain=base` Use when you need the status and details of a transaction by hash. Not fo
polymarket[Trading Data API] Polymarket prediction markets with live probabilities: question, per-outcome probability, 24h and total volume, liquidity, best bid/ask, one-day price change and end date. Top markets by volume, liquidity or soonest end, or free-text search. **Example:** `/v1/p
web_search[Trading Data API] Real-time web search for agents: ranked results with title, URL, snippet and score, plus an optional synthesized answer. Pay per search; general or news topic. **Example:** `/v1/web-search?q=latest+ethereum+upgrade&max_results=5&topic=news` Use when an agent ne
crypto_news[Trading Data API] Latest crypto headlines aggregated from Cointelegraph, Decrypt and Bitcoin Magazine, newest first: title, source, URL, published time and a short summary. Filter by keyword or source. **Example:** `/v1/crypto-news?q=etf&limit=10` Use when you want the latest cr
liquidations[Trading Data API] Recent forced liquidations on OKX USDT perpetual swaps for a coin: each event with time, liquidated side, bankruptcy price, size and USD notional, plus long vs short liquidated totals and the largest event. Real exchange data, no estimates. **Example:** `/v1/li
protocol_health_scoreboard[Protocol Health Oracle] Public teaser: protocol name, score, and verdict only (no components/history) across the full tracked universe — auto-ingested from DefiLlama (TVL > $1M) plus curated protocols. Use when you want the free public ranking of every tracked DeFi protocol: nam
protocol_health_list_protocols[Protocol Health Oracle] All tracked protocols with their latest health score and verdict. Use when you need every tracked protocol with its latest score and verdict. Not for one protocol's details (use protocol_health_score). Behavior: read-only. Priced via x402 (USDC on Base) o
protocol_health_track_protocol[Protocol Health Oracle] Track a new protocol. Scored immediately from live GitHub + DeFiLlama data. Use when a protocol you care about is not tracked yet and you want it scored from live GitHub and DefiLlama data. Not for reading an existing score. Behavior: writes state upstrea
protocol_health_score[Protocol Health Oracle] Latest health score for one protocol: components (GitHub activity, TVL trend, treasury), source details, and score history. Use when you are vetting one protocol before integrating it and want GitHub activity, TVL trend and treasury components. Not for a
protocol_health_refresh_all[Protocol Health Oracle] Force an immediate live re-score of all tracked protocols. Use when you need every tracked protocol re-scored right now instead of waiting for the schedule. Not for a single protocol (read it with protocol_health_score). Behavior: writes state upstream (n
protocol_health_sync_universe[Protocol Health Oracle] Force an immediate sync of the tracked-protocol universe from DefiLlama (TVL > $1M). Runs automatically once/day; use this to trigger it on demand. Use when you want the tracked universe re-synced from DefiLlama (TVL above $1M), which also runs automatica
token_risk[Token Risk Oracle] Free, public, no signup. Aggregates real on-chain risk signals from GoPlus Security for a token contract — honeypot detection, mint/ownership authority, holder & LP concentration, buy/sell tax, trust-list status — into one transparent risk score. Never a bare
broker_sync_register_user[Broker Sync API] Register a user with SnapTrade and get a brokerage connection-portal URL. Use when you are onboarding a user and need a SnapTrade brokerage connection-portal URL. Not for reading data for an already connected user. Behavior: writes state upstream (not read-only)
broker_sync_connections[Broker Sync API] List a user's connected brokerage accounts (normalized). Use when you want a user's connected brokerage accounts in a normalized shape. Not for holdings (use broker_sync_positions) or cash (use broker_sync_balances). Behavior: read-only. Priced via x402 (USDC on
broker_sync_positions[Broker Sync API] Real positions across all of a user's connected brokerages, one normalized schema, stamped as_of. Use when you want a user's real positions across all connected brokerages in one schema. Not for cash and buying power (use broker_sync_balances). Behavior: read-on
broker_sync_balances[Broker Sync API] Cash & buying power per connected account (normalized). Use when you want cash and buying power per connected account. Not for holdings (use broker_sync_positions). Behavior: read-only. Priced via x402 (USDC on Base) or free with WICKEDAPI_API_KEY; with neither,
broker_sync_transactions[Broker Sync API] Transaction/activity history across brokerages. Use when you want a user's transaction and activity history across brokerages. Not for current holdings (use broker_sync_positions). Behavior: read-only. Priced via x402 (USDC on Base) or free with WICKEDAPI_API_KE
broker_sync_prop_firms[Broker Sync API] Prop-firm platform integration registry — live-verified methods (Topstep ProjectX API, FTMO MatchTrader bridge) and connection status. Use when you want the registry of prop-firm platforms and which integration methods are live-verified. Not for a user's own acc
filings_freshness[Filings Oracle] Proof of real-time: seconds since the last successful SEC poll, age of the newest filing, median and p95 ingest lag (from SEC acceptance time) over the last 200 live filings, last successful poll per form type, and rows stored - Free. Proof of real-time: seconds
filings_latest_preview[Filings Oracle] The 10 most recent filings across all form types (form, company, ticker, filed_at only) - Free. The 10 most recent filings across all form types (form, company, ticker, filed_at only). Full structured data, filtering and cursors need /v1/filings. **Example:** `/v
filings_search[Filings Oracle] Structured SEC filings feed (8-K, Form 4, Schedule 13D/13G, 10-K, 10-Q), ingested within about a minute of SEC acceptance. Filter by form, ticker, CIK or 8-K item; page with a cursor, or long-poll with wait= to receive the next filing the moment it lands. **Examp
filings_8k_events[Filings Oracle] 8-K material-event alerts classified into categories an agent can act on: earnings, exec_change, material_agreement, acquisition_disposition, bankruptcy, delisting, cybersecurity, auditor_or_restatement, control_change, financing, restructuring_impairment, shareh
filings_insider_trades[Filings Oracle] Form 4 insider transactions parsed to one row per trade: insider, role and title, security, code (P purchase, S sale, A grant ...), shares, price, dollar value, shares owned after, direct/indirect, and whether it was under a 10b5-1 plan. Defaults to open-market b
filings_insider_summary[Filings Oracle] Insider activity rollup for one ticker over a window: open-market buy and sell counts and dollar totals, net flow, distinct buyers and sellers, a cluster-buying flag (three or more insiders buying), and the largest trades. **Example:** `/v1/insider-summary?ticker
filings_filing[Filings Oracle] One filing by accession number, with its parsed items or insider transactions and the SEC document link. **Example:** `/v1/filing?accession=0001731122-26-001341` Use when you have an accession number and want that one filing with parsed items and the SEC link. No
wallet_sanctions_check[Wallet Oracle] Is this address on the US Treasury OFAC SDN sanctions list? Exact match against every digital-currency address OFAC publishes (EVM, Tron, Bitcoin and others), with the sanctioned entity, program, and the list's publish date - Free. Is this address on the US Treasu
wallet_check[Wallet Oracle] Pre-transaction counterparty check for an EVM wallet or contract: OFAC SDN screening, GoPlus malicious-address flags (phishing, drainers, laundering, mixers ...), and a live on-chain profile (EOA / contract / EIP-7702, nonce, balance, ENS, first transaction, contr
reputation_status[Wicked Reputation] An agent's current reputation: tier, active/unbonding stake, score, slash count, founding-member badge. http_status 404 means the wallet never registered — treat as tier 'unranked'. Use when you want one agent's tier, stake, reputation score and slash count be
reputation_statement[Wicked Reputation] An agent's full position plus real event ledger (stakes, unstakes, withdrawals, slashes). Does not include WickedAPI call volume or fees — see the `note` field. Use when you need an agent's full position and ledger of stakes, unstakes, withdrawals and slashes.
reputation_query[Wicked Reputation] Search/rank registered agents by tier, stake, reputation or slash history. Every filter is a typed query param. Use when you want to filter or rank agents by tier, stake, reputation or slash history. Not for one known wallet (use reputation_status). Behavior:
reputation_tiers[Wicked Reputation] Live tier thresholds and benefits (min stake, rate-limit multiplier, fee discount). Read at call time — thresholds are admin-configurable. Use when you want the live tier thresholds and benefits (minimum stake, rate-limit multiplier, fee discount). Not for a s
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026
The registry name was verified with the GitHub account WickedAPI, which owns the repo
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
Responded in 463 ms (HTTP 200)
No sign-in needed
Read 60 tool descriptions and found no hidden instructions to the AI
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: WICKEDAPI_API_KEY, WICKEDAPI_PAYER_PRIVATE_KEY
Either way works: install it on your computer or connect to the cloud version.
The GitHub repo last changed –, and the latest version (1.6.4) reached the registry 13 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
In the same category: Finance Toolkit, SolidInvoice, Korea Tax Calculator
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
500+ transparent financial methods calculated from raw statements, not third-party endpoints.
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
MCP server for the whole Wicked suite — trading data, DeFi protocol health, token safety, brokerage sync, agent identity, reputation, a tool-reliability registry, hallucination checks, persistent agent memory, and x402 paywalls, in one server.
100+ tools across 12 live services. The first four are generated automatically from each service's own live openapi.json, so the list always matches what's deployed; the rest are hand-written because they use wallet signatures and non-/v1 routes:
| Service | Tools | Auth |
|---|---|---|
| Trading Data API | 28 (unprefixed: price, ohlcv, fvg, momentum_score, macro_calendar, …, plus on-chain reads chain_balance, chain_token_balance, chain_nonce, chain_block, chain_ens, chain_tx) | API key or x402, 5 free |
| Protocol Health Oracle | 6 (protocol_health_*) | API key or x402, scoreboard free |
| Token Risk Oracle | 1 (token_risk) | 100% free, no key |
| Broker Sync API | 6 (broker_sync_*) | API key or x402 |
| Filings Oracle | 7 (filings_search, filings_8k_events, filings_insider_trades, filings_insider_summary, …) | freshness + preview free; rest key or x402 |
| Wallet Oracle | 2 (wallet_sanctions_check, wallet_check) | OFAC sanctions lookup free; full check key or x402 |
| Wicked Reputation | 5 (reputation_*) | free, no key |
| Wicked Registry | 6 (registry_*) | search/detail: key or x402; featured/badge/report free; register needs your signature |
| Wicked Identity | 8 (identity_*) | no wallet? start with identity_sandbox_register (no signing); free test key via identity_get_test_key; real-wallet calls need your signature over a nonce |
| Wicked Sanity | 2 (sanity_check, sanity_check_batch) | key or x402 |
| Wicked Memory | 8 (memory_prepare, memory_store, memory_search, …) | wallet signature on every call; only search is metered |
| x402 Paywall | 8 (paywall_*) | paywall_signup is open; the rest need the tenant key |
Plus 6 resources (the platform directory, llms.txt, and each service's live endpoint catalog) and 10 prompts (rug_check, vet_dependency, morning_briefing, fact_check, verify_agent, find_reliable_tool, agent_memory_guide) that chain tools together the way the cookbook does.
These tools never sign anything or hold a key. Agents with no wallet can still try Wicked Identity end to end through a sandbox identity (identity_sandbox_register, then pass sandbox_token instead of a signature); sandbox results are for testing and are never reported as verified. Identity (real wallet), Registry registration and Memory take a signature you produce with your own wallet (identity_get_nonce / memory_prepare return the exact message to sign). Calls that need x402 payment return the real 402 challenge (decoded under payment_required for x402 v2) rather than auto-paying — WICKEDAPI_PAYER_PRIVATE_KEY auto-pay applies to the Trading, Protocol Health, Token Risk and Broker Sync tools.
Also listed on Glama, the official MCP Registry (io.github.WickedAPI/wicked-mcp) and Smithery.
The same 107 tools are served over streamable HTTP at `https://mcp.wickedapi.com/mcp` (stateless, rate-limited per IP; the public deployment carries no personal keys, so paid calls return the x402 challenge). Point any streamable-HTTP MCP client at it. To self-host, build the Dockerfile and run it with node dist/http.js (the image defaults to the stdio entry point), or npm run build && npm run start:http; see .env.example for RATE_LIMIT_PER_MINUTE, ALLOWED_HOSTS and TRUSTED_CLIENT_IP_HEADER.
Every tool hits a real endpoint gated by x402 (HTTP-native pay-per-call, USDC on Base) with an API-key fallback — and the Token Risk Oracle tool is free no matter what:
402 payment challenge (price, network, payTo) as the tool result.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.WICKEDAPI_API_KEY for free, rate-limited access across all four services (same key works everywhere).{
"mcpServers": { "wickedapi": { "command": "npx", "args": ["-y", "@wickedlabs/wicked-mcp"], "env": { "WICKEDAPI_API_KEY": "your-key-here" } } } }
Or for autonomous pay-per-call instead of a key:
{
"mcpServers": { "wickedapi": { "command": "npx", "args": ["-y", "@wickedlabs/wicked-mcp"], "env": { "WICKEDAPI_PAYER_PRIVATE_KEY": "0xyour-base-wallet-private-key" } } } }
Nothing configured? The Token Risk Oracle tool and the 5 free Trading Data API endpoints (sentiment, macro_calendar, market_overview, gas, kalshi_probability) still work with zero setup.
Read without calling a tool — useful for a client that surfaces resources in its UI:
wickedapi://platform/services — the full service directory (JSON)wickedapi://platform/llms — the platform's llms.txtwickedapi://trading/status, wickedapi://protocol_health/status, wickedapi://token_risk/status, wickedapi://broker_sync/status — each service's live endpoint catalogclaude mcp add --transport http wicked https://mcp.wickedapi.com/mcp # Claude Code, no install
npx -y @wickedlabs/wicked-mcp # local stdio
Claude Desktop / Cursor / VS Code config and per-framework starters: see the cookbooks. The remote also serves a landing page at /, /llms.txt, an MCP server card at /.well-known/mcp/server-card.json, and aggregate per-tool call counts at /stats (counts only; no arguments or IPs).
One-click workflows that chain real tool calls (Claude Desktop and other prompt-aware clients surface these directly):
address, chain, optional symbol) — token risk check + market sentiment + optional momentum read, before buying.slug, optional token_address, chain) — protocol health + optional contract-level risk check, before building on a DeFi protocol.symbol) — macro calendar + earnings calendar + sentiment + momentum verdict, as one digest.output, optional source) — split an answer into claims and verify each with Wicked Sanity.wallet) — Identity assertion + Reputation stake/tier before you transact with an agent.need, optional category, min_score) — Registry search by real uptime/latency/schema scores.wallet, task) — the two-step signed Memory flow, explained to the model.address) — OFAC screening and wallet risk (plus Identity/Reputation) before you pay someone.ticker, optional days) — insider trades, insider summary and 8-K events for a stock.symbol, optional timeframe) — verdict, volatility, positioning and news for a trade idea.| Var | Required | Notes |
|---|---|---|
WICKEDAPI_API_KEY | no | Free, rate-limited access across all four services (same key works everywhere). |
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 Trading Data API base (default https://api.wickedapi.com). |
WICKEDAPI_PROTOCOL_HEALTH_URL | no | Override the Protocol Health Oracle base (default https://protocol-health-oracle.wickedapi.com). |
WICKEDAPI_TOKEN_RISK_URL | no | Override the Token Risk Oracle base (default https://token-risk-oracle.wickedapi.com). |
WICKEDAPI_BROKER_SYNC_URL | no | Override the Broker Sync API base (default https://broker-sync-api.wickedapi.com). |
REGISTRY_API_KEY / IDENTITY_API_KEY / SANITY_API_KEY / MEMORY_API_KEY | no | Free-tier keys for the paid calls of Registry, Identity, Sanity and Memory search. Omit to get the x402 challenge instead. |
PAYWALL_API_KEY | for paywall_* | Tenant Bearer key returned once by paywall_signup. |
REPUTATION_BASE_URL / REGISTRY_BASE_URL / IDENTITY_BASE_URL / SANITY_BASE_URL / MEMORY_BASE_URL / PAYWALL_BASE_URL | no | Override the matching service base (defaults are the *.wickedapi.com hosts). |
WICKEDAPI_SHOWCASE_URL | no | Override the platform directory base used by resources (default https://wickedapi.com). |
If neither WICKEDAPI_API_KEY nor WICKEDAPI_PAYER_PRIVATE_KEY is set, paid calls still succeed at the protocol level — you'll get the real 402 challenge back as the tool result instead of data. If one service's spec fails to load (network hiccup, that service is down), its tools are simply skipped for the session — the rest still register normally.
npm install
npm test # builds, then unit + end-to-end tests (e2e needs network) node dist/index.js # stdio node dist/http.js # streamable HTTP on $PORT (default 8080)
This server doesn't reimplement any data logic — it's a thin bridge from MCP tool calls to the live Wicked HTTP endpoints across all ten services. All the actual market data, indicators, scoring, and risk signals live in the APIs themselves.