Wicked MCP (moved)

WickedAPI MCP 服务

为整个 Wicked 套件提供的 MCP 服务，涵盖交易数据、DeFi 协议健康状况、代币安全、券商同步、Agent 身份、声誉、工具可靠性注册表、幻觉检查、持久化 Agent 记忆和 x402 付费墙，集于一体。

涵盖 12 项在线服务的 100 多个工具。前 4 项会根据各服务实时提供的 openapi.json 自动生成，因此工具列表始终与已部署的服务一致；其余工具为手动编写，因为它们使用钱包签名和非 /v1 路由：

服务	工具	身份验证
Trading Data API	28 个（无前缀：price、ohlcv、fvg、momentum_score、macro_calendar 等，以及链上读取工具 chain_balance、chain_token_balance、chain_nonce、chain_block、chain_ens、chain_tx）	API 密钥或 x402，5 个免费
Protocol Health Oracle	6 个（protocol_health_*）	API 密钥或 x402，记分板免费
Token Risk Oracle	1 个（token_risk）	完全免费，无需密钥
Broker Sync API	6 个（broker_sync_*）	API 密钥或 x402
Filings Oracle	7 个（filings_search、filings_8k_events、filings_insider_trades、filings_insider_summary 等）	实时性检查和预览免费；其余需密钥或 x402
Wallet Oracle	2 个（wallet_sanctions_check、wallet_check）	OFAC 制裁查询免费；完整检查需密钥或 x402
Wicked Reputation	5 个（reputation_*）	免费，无需密钥
Wicked Registry	6 个（registry_*）	搜索/详情需密钥或 x402；精选内容/徽章/报告免费；注册需要你的签名
Wicked Identity	8 个（identity_*）	没有钱包？从 identity_sandbox_register 开始（无需签名）；通过 identity_get_test_key 获取免费测试密钥；真实钱包调用需要你对 nonce 进行签名
Wicked Sanity	2 个（sanity_check、sanity_check_batch）	密钥或 x402
Wicked Memory	8 个（memory_prepare、memory_store、memory_search 等）	每次调用都需钱包签名；只有搜索会计费
x402 Paywall	8 个（paywall_*）	paywall_signup 无需授权；其余需要租户密钥

此外还有 6 项资源（平台目录、llms.txt 和各服务的实时端点目录）以及 10 个提示词（rug_check、vet_dependency、morning_briefing、fact_check、verify_agent、find_reliable_tool、agent_memory_guide），可像 操作手册 一样串联各工具。

这些工具绝不会签名或持有密钥。没有钱包的 Agent 仍可通过沙盒身份（identity_sandbox_register，然后传入 sandbox_token 而非签名）端到端试用 Wicked Identity；沙盒结果仅用于测试，不会被报告为已验证。Identity（真实钱包）、Registry 注册和 Memory 均需要使用你自己的钱包生成签名（identity_get_nonce / memory_prepare 会返回要签名的确切消息）。需要 x402 付款的调用会返回真实的 402 挑战（x402 v2 的内容会解码到 payment_required 中），而不会自动付款；WICKEDAPI_PAYER_PRIVATE_KEY 自动付款仅适用于 Trading、Protocol Health、Token Risk 和 Broker Sync 工具。

远程端点（无需安装）

也可在 Glama、官方 MCP Registry（io.github.WickedAPI/wicked-mcp）和 Smithery 上找到。

同样的 107 个工具也通过流式 HTTP 在 https://mcp.wickedapi.com/mcp 上提供（无状态，按 IP 限流；公共部署不携带个人密钥，因此付费调用会返回 x402 挑战）。将任何支持流式 HTTP 的 MCP 客户端指向该地址即可。要自托管，请构建 Dockerfile 并使用 node dist/http.js 运行（镜像默认使用 stdio 入口），或运行 npm run build && npm run start:http；请参阅 .env.example 了解 RATE_LIMIT_PER_MINUTE、ALLOWED_HOSTS 和 TRUSTED_CLIENT_IP_HEADER。

无需注册

每个工具都会调用由 x402 控制的真实端点（基于 HTTP 的按次付费，使用 Base 上的 USDC），并支持 API 密钥作为备用方式；无论如何，Token Risk Oracle 工具始终免费：

• 零配置 — 无凭据也能调用；付费端点会将真实的 402 付款挑战（价格、网络、payTo）作为工具结果返回。
• 自主按次付费 — 将已注资的 Base 主网钱包私钥设为 WICKEDAPI_PAYER_PRIVATE_KEY，每次调用都会自动支付约 $0.001 的 USDC 并返回真实数据。无需账户，也无需订阅。
• 合作伙伴 API 密钥 — 设置 WICKEDAPI_API_KEY，即可免费、限流地访问全部四项服务（同一个密钥可用于所有服务）。

安装

{
  "mcpServers": {
    "wickedapi": {
      "command": "npx",
      "args": ["-y", "@wickedlabs/wicked-mcp"],
      "env": {
        "WICKEDAPI_API_KEY": "your-key-here"
      }
    }
  }
}

或者，使用自主按次付费，而非密钥：

{
  "mcpServers": {
    "wickedapi": {
      "command": "npx",
      "args": ["-y", "@wickedlabs/wicked-mcp"],
      "env": {
        "WICKEDAPI_PAYER_PRIVATE_KEY": "0xyour-base-wallet-private-key"
      }
    }
  }
}

没有进行任何配置？Token Risk Oracle 工具和 Trading Data API 的 5 个免费端点（sentiment、macro_calendar、market_overview、gas、kalshi_probability）仍可在零配置下使用。

资源

无需调用工具即可读取——适用于在 UI 中展示资源的客户端：

• wickedapi://platform/services — 完整的服务目录（JSON）
• wickedapi://platform/llms — 平台的 llms.txt
• wickedapi://trading/status、wickedapi://protocol_health/status、wickedapi://token_risk/status、wickedapi://broker_sync/status — 各服务的实时端点目录

快速开始

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 配置和各框架的入门示例，请参阅 cookbooks。远程服务还在 / 提供落地页，在 /llms.txt 提供平台说明，在 /.well-known/mcp/server-card.json 提供 MCP 服务卡，并在 /stats 提供各工具调用次数汇总（仅计数；不含参数或 IP）。

提示词

一键式工作流，可串联真实工具调用（Claude Desktop 和其他支持提示词的客户端会直接展示这些工作流）：

• rug_check（address、chain、可选的 symbol）— 购买前检查代币风险、市场情绪以及可选的动量情况。
• vet_dependency（slug、可选的 token_address、chain）— 基于协议健康状况，以及可选的合约级风险检查，在基于 DeFi 协议构建前进行评估。
• morning_briefing（可选的 symbol）— 汇总宏观日历、财报日历、市场情绪和动量判断。
• fact_check（output、可选的 source）— 将答案拆分为各项声明，并使用 Wicked Sanity 逐一核实。
• verify_agent（wallet）— 与 Agent 进行交易前，检查身份声明和信誉质押／等级。
• find_reliable_tool（need、可选的 category、min_score）— 按真实的正常运行时间、延迟和架构评分搜索 Registry。
• agent_memory_guide（wallet、task）— 向模型说明两步签名 Memory 工作流。
• counterparty_check（address）— 付款前进行 OFAC 筛查和钱包风险检查（以及身份／信誉检查）。
• insider_watch（ticker、可选的 days）— 获取某只股票的内幕交易、内幕交易摘要和 8-K 事件。
• trade_idea_check（symbol、可选的 timeframe）— 获取交易想法的判断、波动性、持仓情况和新闻。

环境变量

变量	必需	说明
WICKEDAPI_API_KEY	否	免费访问所有四项服务，但有速率限制（同一个密钥可用于所有服务）。
WICKEDAPI_PAYER_PRIVATE_KEY	否	Base 主网钱包私钥。如果设置，每次调用都会自动以 USDC 支付 x402 挑战，无需密钥。
WICKEDAPI_BASE_URL	否	覆盖 Trading Data API 的基础 URL（默认 https://api.wickedapi.com）。
WICKEDAPI_PROTOCOL_HEALTH_URL	否	覆盖 Protocol Health Oracle 的基础 URL（默认 https://protocol-health-oracle.wickedapi.com）。
WICKEDAPI_TOKEN_RISK_URL	否	覆盖 Token Risk Oracle 的基础 URL（默认 https://token-risk-oracle.wickedapi.com）。
WICKEDAPI_BROKER_SYNC_URL	否	覆盖 Broker Sync API 的基础 URL（默认 https://broker-sync-api.wickedapi.com）。
REGISTRY_API_KEY / IDENTITY_API_KEY / SANITY_API_KEY / MEMORY_API_KEY	否	用于 Registry、Identity、Sanity 和 Memory 搜索付费调用的免费层密钥。不提供密钥则会收到 x402 挑战。
PAYWALL_API_KEY	paywall_* 必需	paywall_signup 返回的一次性租户 Bearer 密钥。
REPUTATION_BASE_URL / REGISTRY_BASE_URL / IDENTITY_BASE_URL / SANITY_BASE_URL / MEMORY_BASE_URL / PAYWALL_BASE_URL	否	覆盖对应服务的基础 URL（默认使用 *.wickedapi.com 主机）。
WICKEDAPI_SHOWCASE_URL	否	覆盖资源使用的平台目录基础 URL（默认 https://wickedapi.com）。

如果未设置 WICKEDAPI_API_KEY 和 WICKEDAPI_PAYER_PRIVATE_KEY，付费调用在协议层面仍会成功——工具结果会返回真实的 402 挑战，而不是数据。如果某项服务的规范加载失败（网络故障或该服务不可用），本次会话将跳过其工具，其余工具仍会正常注册。

本地开发

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)

这不是什么

此服务不会重新实现任何数据逻辑——它只是将 MCP 工具调用转发到全部十项服务的实时 Wicked HTTP 端点。实际的市场数据、指标、评分和风险信号都由 API 本身提供。