Chainward

io.github.saltxdPublished by GitHub account saltxdv0.2.3Updated Oct 24, 2026

Check a Base or BNB Chain address before you pay it: on-chain risk reports, EAS attestations.

VerifiedSTDIODesktop onlyFinanceSecurity & Monitoring

Overview

AI-generated overview

Read-only MCP server that lets an assistant check Base or BNB Chain addresses and tokens for risk, and query ChainWard's data on AI-agent wallets.

What you can do
  • Check a counterparty address before paying it, with a pay/hold/unknown verdict, reasons, flags and any EAS attestation on Base
  • Run a rug check on a Base token, with launch facts such as the launch wallet, token sends, later mints and sanctions status
  • Look up whether an address is a known AI agent and pull its profile, balance, gas, recent transactions and economics
  • Browse ecosystem statistics, top-agent leaderboards, recent labeled-agent activity and published Decodes
  • Find Decodes that reference a specific address
When to use it
Useful when an assistant is about to pay, transact with, or buy a token from an unfamiliar address on Base or BNB Chain and you want a quick on-chain risk read before acting. Also handy for research on AI-agent wallets and ChainWard's published investigations.
Requirements
Runs locally via npx (Node.js) over stdio, or as a local HTTP server with CHAINWARD_MCP_TRANSPORT and PORT. A hosted endpoint is also offered. Defaults to ChainWard's public API at CHAINWARD_API_URL with no authentication; CHAINWARD_API_KEY is optional.
Before you install
Read-only: it does not sign or send transactions, so acting on results needs a separate wallet server. Verdicts are on-chain heuristics only and are not guarantees; there is no honeypot or sell simulation. The rug check is free up to 20 fresh checks an hour, and the paid volume route costs $0.02 per request over x402. Addresses you query are sent to ChainWard's API.

Installation

In SourceWeft

  1. Open Chainward in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

chainward-mcp-server

[npm]

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

ToolPurpose
check_counterpartyBefore 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_checkBefore 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_agentIs 0x… a known AI agent? Returns label + Decode pointers. Cheap.
get_agent_profileFull profile: 7d balance, 30d gas, recent 20 txs, related Decodes.
get_agent_economicsLifetime 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_overviewEcosystem-wide stats.
get_top_agentsLeaderboard by activity.
get_activity_feedRecent labeled-agent activity.
list_decodesEvery published Decode, newest first.
find_decodes_for_addressAll 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)

jsonc
// 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

bash
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

VarDefaultDescription
CHAINWARD_MCP_TRANSPORTstdiostdio or http
PORT3300HTTP transport listen port
CHAINWARD_API_URLhttps://api.chainward.aiAPI 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). Before buying a token, call rug_check. If a Decode exists, summarise it for the user before invoking any Base MCP plugin.

License

MIT

Source: packages/mcp-server/README.md at commit f0ddfa2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

3
  1. v0.2.3LatestOct 12, 2026
  2. v0.2.1Oct 4, 2026
  3. v0.2.0Sep 29, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts