Wicked MCP

WickedAPI MCP Server

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

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

Service	Tools	Auth
交易数据 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 项免费
协议健康预言机	6（protocol_health_*）	API 密钥或 x402，记分板免费
代币风险预言机	1（token_risk）	完全免费，无需密钥
经纪账户同步 API	6（broker_sync_*）	API 密钥或 x402
申报文件预言机	7（filings_search、filings_8k_events、filings_insider_trades、filings_insider_summary、……）	数据新鲜度和预览免费；其余需密钥或 x402
钱包预言机	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 付费墙	8（paywall_*）	paywall_signup 开放使用；其余需要租户密钥

此外还有 6 个资源（平台目录、llms.txt 以及各服务的在线端点目录）和 7 个提示词（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 工具。

远程端点（无需安装）

相同的 90 个工具也通过**https://mcp.wickedapi.com/mcp** 提供流式 HTTP 服务（无状态，按 IP 限流；公共部署不会携带个人密钥，因此付费调用会返回 x402 挑战）。将任何流式 HTTP MCP 客户端指向该端点即可。若要自托管，请构建 Dockerfile（或运行 npm run build && npm run start:http）；有关 RATE_LIMIT_PER_MINUTE、ALLOWED_HOSTS 和 TRUSTED_CLIENT_IP_HEADER，请参阅 .env.example。

无需注册

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

• 零配置 — 无凭据也能调用；付费端点会将真实的 402 付款挑战（价格、网络、payTo）作为工具结果返回。
• 自动按次付费 — 设置 WICKEDAPI_PAYER_PRIVATE_KEY，值为已注资的 Base 主网钱包私钥，即可让每次调用自动支付约 $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 提供 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）— 根据真实的在线率、延迟和架构评分搜索注册表。
• agent_memory_guide（wallet、task）— 向模型解释两步式签名 Memory 流程。

环境变量

变量	必需	说明
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 本身提供。