Integrations · Live on npm
Your AI assistant can now ask who's on the other side.
chainward-mcp-server puts ChainWard's check inside your AI assistant. MCP (Model Context Protocol) is how assistants such as Claude Desktop, Cursor, Claude Code and Codex call outside tools. Install it once and your assistant can check an address on Base or BNB Chain before paying it, look up known AI agent wallets, and search our decodes, before you sign a single transaction.
$ npx -y chainward-mcp-server
read-onlyno api key requirednpm: chainward-mcp-server
What it doesYour assistant asks before it pays.
When your assistant is about to pay an address, it calls check_counterparty and gets one answer: Pay or Hold, with the reason behind it. When there isn't enough history to judge, it says so (Inactive, No track record or Couldn't check) instead of guessing. The check reads on-chain behavior only, so Pay means nothing turned up against paying, not a guarantee.
The other tools answer the questions around a payment: is this address a known AI agent, what has it been doing lately, and has ChainWard written about it?
The tools10 tools. All read-only.
Your assistant picks the right tool from the description. No prompting required.
- check_counterparty
- Before paying 0x…: Pay or Hold with the one reason, the flags behind it, and the EAS attestation on Base when ChainWard has published one. When there is too little to judge it says Inactive, No track record or Couldn't check. Since 0.2.3, chain: 'bsc' checks a BNB Chain address. On-chain behavior only; Pay isn't a guarantee.
- lookup_agent
- Is 0x… a known AI agent? Returns its label, framework, its ACP profile (its listing on Virtuals’ agent marketplace) and related decodes. Fast.
- get_agent_profile
- 24h/7d stats, hourly balance history, daily gas, 20 most recent transactions, matching decodes.
- get_agent_economics
- Lifetime ACP revenue, aGDP (Virtuals’ total of the value that passed through an agent’s jobs, trading volume included), jobs and success rate; 30-day on-chain revenue, gas, profit and loss, and gas efficiency.
- get_observatory_overview
- Ecosystem-wide stats: agents tracked, gas burned, portfolio value, recent volume.
- get_top_agents
- Leaderboard by activity. Who is doing what on Base, ranked.
- get_activity_feed
- Live feed of labeled-agent transactions across the ecosystem.
- list_decodes
- Every published ChainWard Decode, newest first. Each with its target addresses.
- rug_check
- Before buying a Base token: Hold, Review or No flags with the one reason, plus who launched it and whether that wallet sent out its launch tokens. Free up to 20 fresh checks an hour; $0.02 a call over x402 for volume. Hold when the launch wallet pulled the liquidity it added. No honeypot or sell simulation. Since 0.3.0.
- find_decodes_for_address
- Has ChainWard written about 0x…? Returns matching Decode URLs.
CompositionPair it with Base MCP. Read before you write.
ChainWard reads. Base MCP writes. Your assistant sees both and uses them together: check the address with ChainWard, then build the unsigned payment with Base MCP. You sign in your own Base Account. ChainWard never sees the key.
// claude_desktop_config.json or .cursor/mcp.json
{
"mcpServers": {
"chainward": {
"command": "npx",
"args": ["-y", "chainward-mcp-server"]
}
}
}
Base MCP is not an npm package: it is a hosted server at mcp.base.org. Add it to your client as a remote MCP server next to ChainWard.
InstallWorks in every MCP-capable surface today. No partnership required.
SurfaceTransportStatus
Claude Desktopstdiolive
Cursorstdiolive
Claude Codestdiolive
Codexstdiolive
Remote / your own clientstreamable HTTPlive
Nothing to install: any MCP client that connects by URL can use the hosted server at https://api.chainward.ai/mcp (Streamable HTTP, no API key). To run your own over HTTP: CHAINWARD_MCP_TRANSPORT=http PORT=3300 npx -y chainward-mcp-server.
Check before every payment.
ChainWard is that check. Install it next to whatever signs.