Provides AI agents with access to trading data, DeFi protocol health, token risk analysis, SEC filings, and persistent agent memory.
Also known as WickedAPI/wicked-mcp, wicked-mcp, @wickedlabs/wicked-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.6.5
- Last commit
- Nov 12, 2026
- License
- MIT
What is WickedAPI MCP?
WickedAPI provides AI agents with access to trading data, DeFi protocol health, token risk analysis, SEC filings, and persistent agent memory.
Summary generated from the project's README
About WickedAPI MCP server
Wicked MCP provides AI agents with a comprehensive suite of financial and decentralized finance tools. It connects agents to twelve live services covering trading data, protocol health, token risk, SEC filings, and brokerage synchronization. Developers can use this server locally via stdio or connect to a remote HTTP endpoint. The server includes over 100 tools, ranging from price and momentum scores to on-chain balance reads and insider trading summaries.
Setup is flexible, allowing for zero-configuration use where paid endpoints return an x402 payment challenge. Users can provide a WICKEDAPI_API_KEY for rate-limited free access or a WICKEDAPI_PAYER_PRIVATE_KEY to enable autonomous pay-per-call using USDC on Base. For identity and memory tasks, the server requires wallet signatures produced by the user. This architecture ensures the MCP server acts as a thin bridge to specialized data logic while maintaining security through user-controlled signing.
Written from the project's README. Every use case is checked against a quote from it.
How to install WickedAPI MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall WickedAPI MCP in Claude Code
$ claude mcp add --env 'WICKEDAPI_API_KEY=<YOUR_WICKEDAPI_API_KEY>' --env 'WICKEDAPI_PAYER_PRIVATE_KEY=<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>' wicked-mcp -- npx -y @wickedlabs/wicked-mcpInstall WickedAPI MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"wicked-mcp": {
"command": "npx",
"args": [
"-y",
"@wickedlabs/wicked-mcp"
],
"env": {
"WICKEDAPI_API_KEY": "<YOUR_WICKEDAPI_API_KEY>",
"WICKEDAPI_PAYER_PRIVATE_KEY": "<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>"
}
}
}
}Install WickedAPI MCP in VS Code
.vscode/mcp.json
{
"servers": {
"wicked-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wickedlabs/wicked-mcp"
],
"env": {
"WICKEDAPI_API_KEY": "<YOUR_WICKEDAPI_API_KEY>",
"WICKEDAPI_PAYER_PRIVATE_KEY": "<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>"
}
}
}
}Install WickedAPI MCP in VS Code CLI
$ code --add-mcp '{"name":"wicked-mcp","type":"stdio","command":"npx","args":["-y","@wickedlabs/wicked-mcp"],"env":{"WICKEDAPI_API_KEY":"<YOUR_WICKEDAPI_API_KEY>","WICKEDAPI_PAYER_PRIVATE_KEY":"<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>"}}'Install WickedAPI MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"wicked-mcp": {
"command": "npx",
"args": [
"-y",
"@wickedlabs/wicked-mcp"
],
"env": {
"WICKEDAPI_API_KEY": "<YOUR_WICKEDAPI_API_KEY>",
"WICKEDAPI_PAYER_PRIVATE_KEY": "<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>"
}
}
}
}Install WickedAPI MCP in Codex
$ codex mcp add wicked-mcp --env 'WICKEDAPI_API_KEY=<YOUR_WICKEDAPI_API_KEY>' --env 'WICKEDAPI_PAYER_PRIVATE_KEY=<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>' -- npx -y @wickedlabs/wicked-mcpInstall WickedAPI MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.wicked-mcp] command = "npx" args = ["-y", "@wickedlabs/wicked-mcp"] [mcp_servers.wicked-mcp.env] WICKEDAPI_API_KEY = "<YOUR_WICKEDAPI_API_KEY>" WICKEDAPI_PAYER_PRIVATE_KEY = "<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>"
Install WickedAPI MCP in Gemini CLI
$ gemini mcp add -s user -e 'WICKEDAPI_API_KEY=<YOUR_WICKEDAPI_API_KEY>' -e 'WICKEDAPI_PAYER_PRIVATE_KEY=<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>' wicked-mcp npx -- -y @wickedlabs/wicked-mcpInstall WickedAPI MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"wicked-mcp": {
"command": "npx",
"args": [
"-y",
"@wickedlabs/wicked-mcp"
],
"env": {
"WICKEDAPI_API_KEY": "<YOUR_WICKEDAPI_API_KEY>",
"WICKEDAPI_PAYER_PRIVATE_KEY": "<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>"
}
}
}
}Configuration
WICKEDAPI_API_KEYSecretFree-tier partner key for the data services. Omit to fall back to x402.
WICKEDAPI_PAYER_PRIVATE_KEYSecretFunded Base wallet key; auto-pays x402 for Trading, Protocol Health, Token Risk and Broker Sync calls.
| Name | Description | |
|---|---|---|
| WICKEDAPI_API_KEY | Free-tier partner key for the data services. Omit to fall back to x402. | Secret |
| WICKEDAPI_PAYER_PRIVATE_KEY | Funded Base wallet key; auto-pays x402 for Trading, Protocol Health, Token Risk and Broker Sync calls. | Secret |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablewickedapi/wicked-mcp is public and reachablegithub.com/wickedapi/wicked-mcp ↗Pass
- Package names this repository as its source@wickedlabs/wicked-mcp names wickedapi/wicked-mcp as sourcenpmjs.com/package/@wickedlabs/wicked-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @wickedlabs/wicked-mcpnpmjs.com/package/@wickedlabs/wicked-mcp/v/0.7.5#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/wickedapi/wicked-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @wickedlabs/wicked-mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 253 msPass
README
View on GitHubWickedAPI MCP Server
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.
Remote endpoint (no install)
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.
No signup required
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:
- Zero config — calls without credentials still work; paid endpoints return the real
402payment challenge (price, network,payTo) as the tool result. - Autonomous pay-per-call — set
WICKEDAPI_PAYER_PRIVATE_KEYto 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_KEYfor free, rate-limited access across all four services (same key works everywhere).
Install
{
"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.
Resources
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'sllms.txtwickedapi://trading/status,wickedapi://protocol_health/status,wickedapi://token_risk/status,wickedapi://broker_sync/status— each service's live endpoint catalog
Quick start
claude 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).
Prompts
One-click workflows that chain real tool calls (Claude Desktop and other prompt-aware clients surface these directly):
rug_check(address,chain, optionalsymbol) — token risk check + market sentiment + optional momentum read, before buying.vet_dependency(slug, optionaltoken_address,chain) — protocol health + optional contract-level risk check, before building on a DeFi protocol.morning_briefing(optionalsymbol) — macro calendar + earnings calendar + sentiment + momentum verdict, as one digest.fact_check(output, optionalsource) — split an answer into claims and verify each with Wicked Sanity.verify_agent(wallet) — Identity assertion + Reputation stake/tier before you transact with an agent.find_reliable_tool(need, optionalcategory,min_score) — Registry search by real uptime/latency/schema scores.agent_memory_guide(wallet,task) — the two-step signed Memory flow, explained to the model.counterparty_check(address) — OFAC screening and wallet risk (plus Identity/Reputation) before you pay someone.insider_watch(ticker, optionaldays) — insider trades, insider summary and 8-K events for a stock.trade_idea_check(symbol, optionaltimeframe) — verdict, volatility, positioning and news for a trade idea.
Environment variables
| 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.
Local development
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)
What this is not
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.
WickedAPI MCP questions
How do I add WickedAPI MCP to Claude Code?
Run claude mcp add --env 'WICKEDAPI_API_KEY=<YOUR_WICKEDAPI_API_KEY>' --env 'WICKEDAPI_PAYER_PRIVATE_KEY=<YOUR_WICKEDAPI_PAYER_PRIVATE_KEY>' wicked-mcp -- npx -y @wickedlabs/wicked-mcp in your terminal. Add --scope user to make it available in every project.
How do I add WickedAPI MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need to sign up to use the tools?
No signup is required. Some tools are free, while others return a 402 payment challenge that can be handled via an API key or autonomous pay-per-call using a private key.
How can I pay for premium tools without a subscription?
You can use autonomous pay-per-call by setting the WICKEDAPI_PAYER_PRIVATE_KEY environment variable to a funded Base-mainnet wallet's private key.
Can agents without a wallet use the identity services?
Yes, agents without a wallet can use a sandbox identity for testing purposes, though these results are not reported as verified.