AntFeed MCP

Give any AI agent — Claude Code, Cursor, Claude Desktop, Cline — a one-line door into the AntSeed network. The Model Context Protocol server wraps the explorer's REST API plus, optionally, a locally running AntSeed buyer so your agent can open and inspect payment channels without you writing any glue code.

Install

Paste into ~/.claude.json (Claude Code), claude_desktop_config.json (Claude Desktop), or your IDE's MCP config. Restart your MCP host.

{
  "mcpServers": {
    "antfeed": {
      "command": "npx",
      "args": ["-y", "@antfeed/mcp"],
      "env": {
        "ANTFEED_EXPLORER_URL": "https://antfeed.org",
        "ANTSEED_BUYER_URL": "http://localhost:8377"
      }
    }
  }
}

Node ≥ 20 required. The package ships as @antfeed/mcp on npm. npx -y auto-fetches the latest within the pinned range; restart your MCP host to upgrade.

Tools

All five tools return structured JSON. Inputs are validated with zod before any network call.

Name	Inputs	Output
`lookup`	query, limit?	matched providers — substring on address, displayName, OR service name
`list_providers`	offset?, limit?, sort? (score \| recent)	provider directory with displayName, services, per-service pricing, region, USDC earned, ghost rate
`get_pricing`	peerId, service	live $/M-token pricing (input + output) from the AntFeed directory; refreshed hourly
`get_session_status`	sessionId (channel id, hex)	on-chain channel state, balance, buyer/seller, settlement
`create_session`	providerPeerId, service, initialDepositUsdc, initialMessage?	Open buyer→seller session via local buyer. Hard-capped by `ANTSEED_MAX_DEPOSIT_USDC`. Only registered when a buyer responds to `/health`.

When no local buyer is detected, create_session is replaced by a diagnostic buyer_setup tool that returns install instructions.

Environment variables

Name	Default	Purpose
`ANTFEED_EXPLORER_URL`	https://antfeed.org	Base URL for the explorer REST API.
`ANTSEED_BUYER_URL`	http://localhost:8377	Local AntSeed buyer RPC. Use `:8378` for AntStation Desktop.
`ANTSEED_MAX_DEPOSIT_USDC`	10	Hard ceiling on `initialDepositUsdc`. Defense-in-depth against prompt-injected agents.
`ANTSEED_BUYER_STRICT`	0	Set to `1` to require the buyer's `/health` to identify itself. Recommended on shared dev boxes.
`ANTFEED_MCP_TIMEOUT_MS`	8000	Per-request timeout in milliseconds.
`ANTFEED_MCP_LOG_LEVEL`	info	`debug` · `info` · `warn` · `error`. Logs go to stderr.

Security model

The agent caller is treated as untrusted. Every tool argument is zod-validated before any network call: addresses must be 0x+40-hex, session IDs must be hex, deposit amounts are capped by ANTSEED_MAX_DEPOSIT_USDC.
Explorer responses are re-validated against a strict shape, with a 2 MB byte ceiling per response — a compromised or hijacked endpoint cannot inject arbitrary strings into your agent's context or exhaust memory.
The local buyer holds your signing key. The MCP never sees it. To prevent another local process from impersonating the buyer, set ANTSEED_BUYER_STRICT=1 and have your buyer respond to /health with {"service":"antseed-buyer"}.
Minimal install footprint. Tarball ships only the built JS, README and LICENSE — no postinstall scripts, no source maps that leak local paths. Dependencies are ~-pinned and published with npm provenance — verify with npm audit signatures.
Plain http:// is only permitted for loopback hosts; non-loopback explorer URLs must be https://.

For sellers