chainward-mcp-server

chainward-mcp-server

Model Context Protocol server for ChainWard: check an address on Base or BNB Chain before you pay it, and query ChainWard's intelligence on AI-agent wallets on Base.

ChainWard labels AI-agent wallets, tracks their on-chain activity in real time, and publishes investigative Decodes. This package lets any MCP-compatible assistant (Claude Desktop, Cursor, Claude Code, Codex, ChatGPT) query that intelligence in plain language, without leaving the chat.

This is the standalone distribution path. It works alongside Base MCP (which handles signing) but does not depend on Base MCP's web_request allowlist.

Tools

Tool	Purpose
check_counterparty	Before paying 0x…: ChainWard's verdict (label pay / hold / unknown, shown as Pay, Hold, Inactive, No track record or Couldn't check) with the one reason, the flags behind it, and the EAS attestation on Base (uid + explorer link) when one exists. Optional chain: base (default) or bsc for a BNB Chain address (since 0.2.3; BNB Chain reports are not attested yet). On-chain behavior only; Pay isn't a guarantee.
lookup_agent	Is 0x… a known AI agent? Returns label + Decode pointers. Cheap.
get_agent_profile	Full profile: 7d balance, 30d gas, recent 20 txs, related Decodes.
get_agent_economics	Lifetime ACP revenue, jobs and success rate, plus the last 30 days on-chain: revenue received, gas, profit (30-day revenue minus 30-day gas) and gas efficiency.
get_observatory_overview	Ecosystem-wide stats.
get_top_agents	Leaderboard by activity.
get_activity_feed	Recent labeled-agent activity.
list_decodes	Every published Decode, newest first.
find_decodes_for_address	All Decodes referencing a specific address.

All tools default to ChainWard's public endpoints (no auth). Setting CHAINWARD_API_KEY enables future authenticated tools.

Install + run

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"
      }
    }
  }
}

Remote HTTP transport

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

Then point your client at http://your-host:3300/mcp.

Env vars

Var	Default	Description
CHAINWARD_MCP_TRANSPORT	stdio	stdio or http
PORT	3300	HTTP transport listen port
CHAINWARD_API_URL	https://api.chainward.ai	API base URL
CHAINWARD_API_KEY	(none)	Optional ag_… Bearer key

Pair with Base MCP

This server is read-only. To act on what you learn (swap, lend, etc.), install Base MCP alongside this server. Recommended assistant prompt pattern:

Before paying or transacting with any unfamiliar address, call ChainWard's check_counterparty (and lookup_agent for agents). If a Decode exists, summarise it for the user before invoking any Base MCP plugin.

License

MIT