Back to Browse

Wicked MCP Server

Developer ToolsUse Caution3.5MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

Whole Wicked suite for agents: market data, SEC filings, wallet checks, risk, identity, memory.

About

Whole Wicked suite for agents: market data, SEC filings, wallet checks, risk, identity, memory.

Remote endpoints: streamable-http: https://mcp.wickedapi.com/mcp

Security Report

3.5
Use Caution3.5High Risk

The visible code (entry point, package metadata, README, icons) is a thin bridge to wickedapi.com endpoints and shows no malicious patterns, but the main server logic (src/server.ts) was not provided, so tool implementations could not be verified. The score is driven by a wallet private key read from an environment variable to auto-sign USDC payments with no visible spending cap, tools generated at runtime from a remote openapi.json, and an undisclosed Sentry telemetry dependency. Supply chain analysis found 6 known vulnerabilities in dependencies (0 critical, 4 high severity). Package verification found 1 issue.

6 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

crypto_wallet_key

Check that this permission is expected for this type of plugin.

payment_signing

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Free-tier partner key for the data services. Omit to fall back to x402.Required

Environment variable: WICKEDAPI_API_KEY

Funded Base wallet key; auto-pays x402 for Trading, Protocol Health, Token Risk and Broker Sync calls.Required

Environment variable: WICKEDAPI_PAYER_PRIVATE_KEY

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

WickedAPI MCP Server

WickedAPI/wicked-mcp MCP server smithery badge

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:

ServiceToolsAuth
Trading Data API28 (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 Oracle6 (protocol_health_*)API key or x402, scoreboard free
Token Risk Oracle1 (token_risk)100% free, no key
Broker Sync API6 (broker_sync_*)API key or x402
Filings Oracle7 (filings_search, filings_8k_events, filings_insider_trades, filings_insider_summary, …)freshness + preview free; rest key or x402
Wallet Oracle2 (wallet_sanctions_check, wallet_check)OFAC sanctions lookup free; full check key or x402
Wicked Reputation5 (reputation_*)free, no key
Wicked Registry6 (registry_*)search/detail: key or x402; featured/badge/report free; register needs your signature
Wicked Identity8 (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 Sanity2 (sanity_check, sanity_check_batch)key or x402
Wicked Memory8 (memory_prepare, memory_store, memory_search, …)wallet signature on every call; only search is metered
x402 Paywall8 (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 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 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's llms.txt
  • wickedapi://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, optional symbol) — token risk check + market sentiment + optional momentum read, before buying.
  • vet_dependency (slug, optional token_address, chain) — protocol health + optional contract-level risk check, before building on a DeFi protocol.
  • morning_briefing (optional symbol) — macro calendar + earnings calendar + sentiment + momentum verdict, as one digest.
  • fact_check (output, optional source) — 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, optional category, 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, optional days) — insider trades, insider summary and 8-K events for a stock.
  • trade_idea_check (symbol, optional timeframe) — verdict, volatility, positioning and news for a trade idea.

Environment variables

VarRequiredNotes
WICKEDAPI_API_KEYnoFree, rate-limited access across all four services (same key works everywhere).
WICKEDAPI_PAYER_PRIVATE_KEYnoBase-mainnet wallet private key. If set, every call auto-pays the x402 challenge in USDC — no key needed.
WICKEDAPI_BASE_URLnoOverride the Trading Data API base (default https://api.wickedapi.com).
WICKEDAPI_PROTOCOL_HEALTH_URLnoOverride the Protocol Health Oracle base (default https://protocol-health-oracle.wickedapi.com).
WICKEDAPI_TOKEN_RISK_URLnoOverride the Token Risk Oracle base (default https://token-risk-oracle.wickedapi.com).
WICKEDAPI_BROKER_SYNC_URLnoOverride the Broker Sync API base (default https://broker-sync-api.wickedapi.com).
REGISTRY_API_KEY / IDENTITY_API_KEY / SANITY_API_KEY / MEMORY_API_KEYnoFree-tier keys for the paid calls of Registry, Identity, Sanity and Memory search. Omit to get the x402 challenge instead.
PAYWALL_API_KEYfor 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_URLnoOverride the matching service base (defaults are the *.wickedapi.com hosts).
WICKEDAPI_SHOWCASE_URLnoOverride 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.

Reviews

No reviews yet

Be the first to review this server!