chainward

chainward-mcp-server

适用于 ChainWard 的 Model Context Protocol 服务：付款前检查 Base 或 BNB Chain 上的地址，并查询 ChainWard 关于 Base 上 AI Agent 钱包的情报。

ChainWard 会标记 AI Agent 钱包、实时追踪其链上活动，并发布调查解码（Decode）。此软件包让任何兼容 MCP 的助手（Claude Desktop、Cursor、Claude Code、Codex、ChatGPT）都能用通俗语言查询这些情报，无需离开聊天界面。

这是独立分发方式。它可以与 Base MCP（负责签名）配合使用，但不依赖 Base MCP 的 web_request 允许列表。

工具

工具	用途
check_counterparty	向 0x… 付款前：获取 ChainWard 的判定（标签 pay / hold / unknown，显示为 Pay、Hold、Inactive、No track record 或 Couldn't check）、一条原因、判定依据的标记，以及存在时的 Base 上 EAS 证明（uid + 区块浏览器链接）。可选参数 chain：base（默认值）或 bsc，用于 BNB Chain 地址（自 0.2.3 起；BNB Chain 报告尚未提供证明）。仅反映链上行为；Pay 并非保证。
rug_check	购买 Base 代币前：获取 ChainWard 的 Rug 检查结果（hold / review / no_flags）、一条原因和发行事实：发行者、该钱包是否转出了发行代币、后续增发，以及发行钱包的制裁状态、钱包年龄和首个资金来源。每小时最多免费进行 20 次新检查；大量查询可使用付费接口 GET https://api.chainward.ai/api/risk/rugcheck?address=0x…（通过 x402，每次 $0.02）。若发行钱包撤走了自己注入的流动性，则判定为 Hold。不提供蜜罐或卖出模拟检查；无标记不代表安全。自 0.3.0 起提供。
lookup_agent	0x… 是否为已知 AI Agent？返回标签和 Decode 链接。成本低。
get_agent_profile	完整档案：7 天余额、30 天 Gas、最近 20 笔交易及相关 Decode。
get_agent_economics	ACP 累计收入、任务数和成功率，以及最近 30 天的链上数据：收到的收入、Gas、利润（30 天收入减去 30 天 Gas）和 Gas 效率。
get_observatory_overview	整个生态的统计数据。
get_top_agents	按活动情况排列的排行榜。
get_activity_feed	最近标记的 Agent 活动。
list_decodes	所有已发布的 Decode，按时间从新到旧排列。
find_decodes_for_address	所有提及指定地址的 Decode。

所有工具默认使用 ChainWard 的公共端点（无需身份验证）。设置 CHAINWARD_API_KEY 后，可启用未来推出的身份验证工具。

安装和运行

Claude Desktop / Cursor / Claude Code（stdio）

// claude_desktop_config.json or .cursor/mcp.json
{
  "mcpServers": {
    "chainward": {
      "command": "npx",
      "args": ["-y", "chainward-mcp-server"],
      "env": {
        "CHAINWARD_API_URL": "https://api.chainward.ai"
      }
    }
  }
}

远程 HTTP 传输

CHAINWARD_MCP_TRANSPORT=http PORT=3300 npx -y chainward-mcp-server
# MCP endpoint: http://localhost:3300/mcp
# Health: http://localhost:3300/healthz

然后将客户端指向 http://your-host:3300/mcp。

环境变量

变量	默认值	描述
CHAINWARD_MCP_TRANSPORT	stdio	stdio 或 http
PORT	3300	HTTP 传输监听端口
CHAINWARD_API_URL	https://api.chainward.ai	API 基础 URL
CHAINWARD_API_KEY	(none)	可选的 ag_… Bearer 密钥

与 Base MCP 配合使用

此服务为只读服务。如需对查询结果采取操作（兑换、借贷等），请在安装此服务的同时安装 Base MCP。推荐的助手提示词模式：

向任何不熟悉的地址付款或进行交易前，调用 ChainWard 的 check_counterparty（如果涉及 Agent，也调用 lookup_agent）。购买代币前，调用 rug_check。如果存在 Decode，请先向用户总结其内容，再调用任何 Base MCP 插件。

许可证

MIT