agentiam-mcp

Stdio MCP server wrapping all 18 AgentIAM x402 endpoints — agent identity, safety, and intelligence for autonomous agents on Base Mainnet.

What this is

agentiam-mcp exposes the AgentIAM HTTP catalog as a Model Context Protocol (MCP) server. Any MCP-capable client (Claude Desktop, Cursor, VS Code, LangChain, etc.) can call the 18 endpoints as tools.

Endpoints:

• Safety pillars — noleak, memguard, riskoracle, secureexec, flowcore
• Audit / policy — audit, validate, risk-check
• Intelligence — research, intelligence-report
• DELPHI knowledge graph — delphi, delphi.entity, delphi.query, delphi.timeline, delphi.contradictions
• Signals — latest-signals, signal-query, publish-signal

Pricing: $0.001–$0.05 USDC per call, settled on Base via x402.

Status

v0.1.0 — discovery mode. All 18 tools are registered. Tool calls return the AgentIAM endpoint's decoded x402 challenge (resource URL, accepts array, bazaar extension, schema), so MCP clients can browse the catalog without holding USDC. Wallet-signed payment flow (per-call USDC settlement) ships in v0.2.

Install

git clone https://github.com/achilliesbot/agentiam-mcp.git
cd agentiam-mcp
npm install

Run (standalone)

node src/index.mjs
# stdio MCP server — speaks JSON-RPC over stdin/stdout

Configure in Claude Desktop / Cursor / VS Code

Add to your MCP config (claude_desktop_config.json on macOS at ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "agentiam": {
      "command": "node",
      "args": ["/absolute/path/to/agentiam-mcp/src/index.mjs"]
    }
  }
}

Restart the client. The 18 AgentIAM tools (noleak, memguard, riskoracle, secureexec, flowcore, audit, validate, risk_check, research, intelligence_report, delphi, delphi_entity, delphi_query, delphi_timeline, delphi_contradictions, latest_signals, signal_query, publish_signal) appear in the tool picker.

Run via Docker

docker build -t agentiam-mcp .
docker run -i agentiam-mcp

Smoke test

( echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0.1"}}}'
  sleep 0.3
  echo '{"jsonrpc":"2.0","method":"notifications/initialized"}'
  sleep 0.3
  echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
  sleep 1
) | node src/index.mjs

You should see a JSON-RPC response listing 18 tools.

Discovery references

• AgentIAM x402 manifest: https://achillesalpha.com/.well-known/x402
• AgentIAM MCP discovery: https://achillesalpha.com/.well-known/mcp.json
• MCP Registry: io.github.achilliesbot/ep-agentiam
• x402scan: https://www.x402scan.com/server/de9dbadb-6475-43f2-a621-a805fb1c661e
• 402index: https://402index.io

License

MIT.