@antseedstats/mcp-server

MCP server for AntSeedStats, the independent stats layer for AntSeed, a peer-to-peer AI-inference marketplace on Base. One tool per public API endpoint, generated from the same catalogue that drives antseedstats.com/developers and the OpenAPI file, so the tools cannot lag the API.

Ask your AI client things like "Where can I buy kimi-k3 on AntSeed, cheapest trusted seller first?", "How much did seller 0x… settle per day last week?" or "What is the projected $ANTS per USD this epoch?".

Quick start

Hosted (no install)

The server runs at https://antseedstats.com/mcp (Streamable HTTP, stateless, no auth).

# Claude Code
claude mcp add --transport http antseedstats https://antseedstats.com/mcp

Claude Desktop has no remote URL field yet; bridge it with mcp-remote in claude_desktop_config.json:

{
  "mcpServers": {
    "antseedstats": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://antseedstats.com/mcp"]
    }
  }
}

Local (stdio)

{
  "mcpServers": {
    "antseedstats": {
      "command": "npx",
      "args": ["-y", "@antseedstats/mcp-server"]
    }
  }
}

The same block works in Cursor (.cursor/mcp.json). VS Code wraps it as "mcp": { "servers": { … } } (.vscode/mcp.json). The local server calls the public API at https://antseedstats.com.

"Server disconnected" in a desktop app

Desktop apps start the command without your shell's PATH. With node from nvm, Volta, asdf or Homebrew a bare npx is not found and the client reports "Server disconnected". Use the full path (which npx in a terminal) and pass its directory as PATH:

{
  "mcpServers": {
    "antseedstats": {
      "command": "/full/path/to/npx",
      "args": ["-y", "mcp-remote", "https://antseedstats.com/mcp"],
      "env": { "PATH": "/full/path/to/node/bin:/usr/local/bin:/usr/bin:/bin" }
    }
  }
}

Self-hosted HTTP

npx @antseedstats/mcp-server --http            # 127.0.0.1:3200/mcp and /health
PORT=4000 ANTSEEDSTATS_API_URL=http://127.0.0.1:3199 npx @antseedstats/mcp-server --http

Tools (40)

Every result starts with a provenance line (the page on antseedstats.com, the Base block it is as of, and whether each figure is a chain fact, a seller's own announcement or antseedstats' judgement), then the API's data as JSON, then a one-line attribution. Field names and units are the API's: antseedstats.com/developers.

Lists return 20 rows by default and at most 100 (limit); the REST API goes to 1000.

Every tool declares an outputSchema (the API's own response schema) and returns structuredContent ({ data, meta }) next to the text, so clients that read typed results need no parsing.

Paid tool: antseedstats_ask

One question in plain language, one answer with sources, computed by the site from its own data. It costs $0.03 in USDC on Base per answer, paid with x402: the server signs a USDC authorisation for the exact price with a key from your environment and the facilitator settles it (no ETH needed). You pay only for a successful answer. Terms: antseedstats.com/developers#ask.

{
  "mcpServers": {
    "antseedstats": {
      "command": "npx",
      "args": ["-y", "@antseedstats/mcp-server"],
      "env": { "X402_PRIVATE_KEY": "0x… (a dedicated Base wallet with a little USDC)" }
    }
  }
}

The key is read only in local (stdio) mode and never leaves the process. The hosted server at antseedstats.com/mcp never pays; there the tool explains how to enable it. All the other tools stay free.

Resources (6)

The site's backstage, readable from inside the client: antseedstats://llms.txt (the front door), antseedstats://llms-full.txt (everything in one file), antseedstats://glossary, antseedstats://faq, antseedstats://openapi.json, antseedstats://changelog. One GET each, cached five minutes.

Prompts (3)

Recipes that chain the tools in the right order: compare_sellers_for_model (model, token mix), audit_seller (address or name), weekly_network_report.

Configuration

Development

npm install
npm run sync-catalog   # regenerate src/generated/catalog.ts from ../antseed-stats (ANTSEEDSTATS_REPO to point elsewhere)
npm run check-drift    # compare the generated catalogue with the live openapi.json
npm test               # unit tests, plus live stdio and HTTP tests when MCP_TEST_API (default http://127.0.0.1:3199) answers
npm run build

Links

• AntSeedStats · Developers · OpenAPI · llms.txt · For agents
• AntSeed, the marketplace
• Built by gekko.eth

License

The code is MIT. The data the tools return is published by AntSeedStats under CC BY 4.0: free to use with attribution to AntSeedStats (antseedstats.com).