Check Base and BNB Chain addresses for risk, perform rug checks on tokens, and query intelligence on AI-agent wallets.
Also known as saltxd/chainward, chainward-mcp-server
- Stars
- 1
- Tools
- 9
- Downloads, 30 days
- —
- Latest version
- 0.2.3
- Last commit
- Nov 15, 2026
- License
- MIT
What is ChainWard MCP?
ChainWard checks Base and BNB Chain addresses for risk, perform rug checks on tokens, and query intelligence on AI-agent wallets. It exposes 9 tools, such as lookup_agent, get_agent_profile, get_agent_economics.
Summary generated from the project's README
About ChainWard MCP server
Chainward provides security intelligence for the Base and BNB Chain ecosystems. It allows developers and users to verify the risk levels of specific addresses and tokens through an MCP-compatible assistant like Claude Desktop, Cursor, or ChatGPT. The server functions as a read-only tool that identifies potential risks, such as rug pulls or suspicious counterparty behavior, by analyzing on-chain activity and launch facts.
Users can interact with the server via stdio or remote HTTP transport. While it works with public endpoints without authentication, providing a CHAINWARD_API_KEY enables access to authenticated tools. The server is designed to work alongside Base MCP, which handles transaction signing, while Chainward focuses on providing the necessary intelligence to decide whether to pay, hold, or avoid a specific address or token.
What you can do with it
- 1Analyze AI agent walletsQuery the economic performance and activity history of a known AI agent on Base.
Written from the project's README. Every use case is checked against a quote from it.
How to install ChainWard MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ChainWard MCP in Claude Code
$ claude mcp add chainward -- npx -y chainward-mcp-serverInstall ChainWard MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"chainward": {
"command": "npx",
"args": [
"-y",
"chainward-mcp-server"
]
}
}
}Install ChainWard MCP in VS Code
.vscode/mcp.json
{
"servers": {
"chainward": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"chainward-mcp-server"
]
}
}
}Install ChainWard MCP in VS Code CLI
$ code --add-mcp '{"name":"chainward","type":"stdio","command":"npx","args":["-y","chainward-mcp-server"]}'Install ChainWard MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"chainward": {
"command": "npx",
"args": [
"-y",
"chainward-mcp-server"
]
}
}
}Install ChainWard MCP in Codex
$ codex mcp add chainward -- npx -y chainward-mcp-serverInstall ChainWard MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.chainward] command = "npx" args = ["-y", "chainward-mcp-server"]
Install ChainWard MCP in Gemini CLI
$ gemini mcp add -s user chainward npx -- -y chainward-mcp-serverInstall ChainWard MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"chainward": {
"command": "npx",
"args": [
"-y",
"chainward-mcp-server"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for chainward-mcp-server 0.2.3 in an isolated container with no network and no keys. It answered and listed 9 tools.
ChainWard MCP tools 9
Read from the server with tools/listlookup_agentLook up an Ethereum address on Base to see if ChainWard labels it as a known AI agent. Returns the label (name, framework), any ACP profile data, and pointers to published Decodes that mention this address. Use this BEFORE the user transacts with an unfamiliar address or token deployer.
get_agent_profileFetch a full profile for a labeled agent on Base: identity, 24h/7d transaction stats, 7-day balance history (hourly buckets), 30-day gas history (daily), the most recent 20 transactions, and any related published Decodes. Returns 404 if ChainWard does not label this address. Heavier than lookup_agent — use when the user wants detail.
get_agent_economicsFetch economics for an ACP agent. From ACP (lifetime): revenue, agentic gross dollar product (aGDP), job count, success rate, unique buyer count. From the chain (last 30 days): revenue30d (USD value the wallet received), gasCost30d, txCount30d, profit30d (revenue30d minus gasCost30d) and gasEfficiency (revenue30d / gasCost30d). Do not compare lifetime revenue with 30-day gas. Use when the user asks about agent revenue, profitability, or whether on-chain activity justifies a market cap.
get_observatory_overviewEcosystem-wide stats: total tracked agents, 24h transaction volume across all agents, gas burned, active-agent count, total portfolio value. Use when the user asks broad questions like "how active is the AI agent economy on Base?".
get_top_agentsRanked leaderboard of agents on Base by transaction volume / revenue / activity. Use when the user asks "who are the top agents?" or "show me the most active agents".
get_activity_feedRecent labeled-agent activity across the ecosystem. Use when the user asks "what is happening right now?" or wants a live feed.
list_decodesList every published ChainWard Decode (investigative article on agent on-chain behavior), newest first. Each entry includes title, subtitle, date, URL, and the addresses that decode mentions.
find_decodes_for_addressFind every published ChainWard Decode that references a given Ethereum address. Returns an array (possibly empty) of decode metadata + URL. Use when the user asks "has ChainWard written about 0x...?".
check_counterpartyBefore paying or trusting an address on Base or BNB Chain, get ChainWard's verdict on it (the `verdict` field): a machine label pay / hold / unknown, a human text (Pay, Hold, Inactive, No track record or Couldn't check), the one reason it rests on, and its limits. The flags under it are the evidence. Pass chain: 'bsc' for a BNB Chain address (default 'base'). On Base, also the EAS attestation (uid + explorer link) when ChainWard has published one, so the result is verifiable on-chain (BNB Chain reports are not attested yet). Read from on-chain behavior only: Pay means nothing was found against paying, not a guarantee. If the address has no report yet, say so and point to the free check at https://chainward.ai (https://chainward.ai/?chain=bsc for BNB Chain).
Configuration
CHAINWARD_API_URLCHAINWARD_MCP_TRANSPORT
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubchainward-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. |
rug_check |
Before buying a Base token: ChainWard's rug check (hold / review / no_flags) with the one reason and the launch facts: who launched it, whether that wallet sent out its launch tokens, later mints, and the launch wallet's sanctions status, age and first funder. Free up to 20 fresh checks an hour; the paid route for volume is GET https://api.chainward.ai/api/risk/rugcheck?address=0x… ($0.02 over x402). Hold when the launch wallet pulled the liquidity it added. No honeypot or sell simulation; no flags isn't a guarantee. Since 0.3.0. |
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.
Hosted endpoint (no install)
We run one, so you do not have to:
https://api.chainward.ai/mcp
Same tools, no API key, nothing to install. It speaks Streamable HTTP, so the
request needs Accept: application/json, text/event-stream; a plain GET in a
browser answers 406 and that is correct, not an outage.
Run the package yourself instead when you want to pin a version, keep traffic
inside your own network, or point it at a different CHAINWARD_API_URL.
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(andlookup_agentfor agents). Before buying a token, callrug_check. If a Decode exists, summarise it for the user before invoking any Base MCP plugin.
License
MIT
ChainWard MCP questions
How do I add ChainWard MCP to Claude Code?
Run claude mcp add chainward -- npx -y chainward-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add ChainWard MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does ChainWard MCP provide?
It exposes 9 tools, including lookup_agent, get_agent_profile, get_agent_economics, get_observatory_overview, get_top_agents.
Can I check addresses on BNB Chain?
Yes, you can specify 'bsc' as the chain parameter for BNB Chain addresses, though reports are not yet attested.
Does the rug check simulate honeypots?
No, the rug check tool does not include honeypot or sell simulations.
Do I need an API key to use the tools?
All tools default to public endpoints that do not require authentication, though a key can be used for future authenticated tools.
Is this server capable of executing transactions?
No, this server is read-only and is intended to be used alongside a server like Base MCP for acting on information.