Axiom Agentic Tools

Five JSON-output MCP tools for builders shipping agentic services on Base. x402-paid, no API keys, no accounts.

Live deployment: agentic.clawbots.org · MCP endpoint: /api/agentic/mcp · OpenAPI: /api/agentic/openapi.json

Overview

axiom-agentic-tools is a tiny, deterministic MCP server. Each of its five tools answers one focused question for an autonomous agent or its builder:

• "Where is this x402 endpoint leaking revenue?"
• "What does a deployable token spec look like for my agent?"
• "Which sequence of paid tools fits this budget?"
• "Is my repo ready for agent marketplaces?"
• "Which Base grant should I apply to next?"

The server is callable three ways:

• MCP — streamable-HTTP, current protocol 2025-11-25. Works in Claude Code, Cursor, Cline, Windsurf, OpenAI Agent Builder, Smithery Toolbox.
• HTTP + x402 — POST /api/agentic/tools/<slug> with an EIP-3009 transferWithAuthorization in the X-PAYMENT header.
• A2A — discoverable via /.well-known/agent-card.json on the parent.

Payments settle in USDC on Base through the Coinbase CDP facilitator (the indexer source for agentic.market and the Coinbase Bazaar).

Features

• ✅ x402 v2 envelope — top-level resource, extensions.bazaar, PAYMENT-REQUIRED response header per specs/transports-v2/http.md.
• ✅ MCP 2025-11-25 — initialize, tools/list, tools/call. Tool call dispatches in-process; payment runs once, not twice.
• ✅ Bazaar-ready — extensions.bazaar.info.input.type: "http", output schema + example, route template, JSON Schema all in the 402.
• ✅ GET discovery — unauthenticated GET returns a 402 with the envelope, so validators can introspect without a body.
• ✅ Deterministic — closed-vocabulary JSON outputs, schema-validated on every response. No "the model said…" drift.
• ✅ Free tier — repo-health-for-agents runs at 50/day per IP with no payment.
• ✅ Rate-limited — 60/hr per IP on paid tools, 10/hr on ?preview=1.

Tools

free at 50 calls/day/IP, then 402.

Quick start

From an MCP-aware editor

Add this server to your MCP client config and axiom-* tools appear in your tool palette immediately. No install, no auth.

Claude Code

claude mcp add --transport http axiom https://agentic.clawbots.org/api/agentic/mcp

Cursor

Cursor → Settings → MCP → New MCP server:

{
  "name": "axiom",
  "type": "http",
  "url": "https://agentic.clawbots.org/api/agentic/mcp"
}

Cline

Cline → Settings → MCP servers → Configure MCP servers:

{
  "mcpServers": {
    "axiom": {
      "type": "streamableHttp",
      "url": "https://agentic.clawbots.org/api/agentic/mcp"
    }
  }
}

Windsurf

Windsurf → Settings → MCP → Add server:

{
  "mcpServers": {
    "axiom": {
      "serverUrl": "https://agentic.clawbots.org/api/agentic/mcp"
    }
  }
}

Smithery Toolbox

Install from Smithery with one click.

From AgentKit

Use all 6 tools as native AgentKit actions. The wallet provider handles x402 payment automatically.

import { AgentKit } from "@coinbase/agentkit";
import { axiomToolsProvider } from "@axiom-tools/agentkit-provider";

const agentkit = await AgentKit.from({
  walletProvider,
  actionProviders: [axiomToolsProvider()],
});

See agentkit/ for the full action provider and docs.

From raw HTTP

# 1. Discovery — what does this endpoint cost?
curl -sX GET https://agentic.clawbots.org/api/agentic/tools/agent-revenue-optimizer \
  -D /tmp/h | head -10
#   HTTP/2 402
#   PAYMENT-REQUIRED: <base64 envelope>

# 2. Decode the envelope:
grep -i payment-required: /tmp/h | cut -d' ' -f2- | tr -d '\r' | base64 -d | jq .

# 3. Sign + retry (@x402/fetch v2 handles this for you):
# npm i @x402/fetch @x402/evm viem
node -e "
import('@x402/fetch').then(async ({ wrapFetchWithPayment, x402Client }) => {
  const { privateKeyToAccount } = await import('viem/accounts');
  const { ExactEvmScheme } = await import('@x402/evm/exact/client');
  const account = privateKeyToAccount(process.env.X402_PRIVATE_KEY);
  const client = new x402Client().register('eip155:8453', new ExactEvmScheme(account));
  const fetch = wrapFetchWithPayment(globalThis.fetch, client);
  const r = await fetch('https://agentic.clawbots.org/api/agentic/tools/agent-revenue-optimizer', {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({ endpoint_url: 'https://example.com/api/probe' }),
  });
  console.log(await r.json());
});
"

Installation (self-host)

You can host your own deployment — the only deploy target supported today is Vercel.

git clone https://github.com/0xAxiom/axiom-agentic-tools.git
cd axiom-agentic-tools
npm install
cp .env.example .env.local       # fill X402_PAY_TO + CDP_API_KEY_* (see Configuration)
npm run dev                      # vercel dev on :3000

Deploy:

vercel link                       # one-time
vercel --prod

Production smoke:

BASE=https://your-deployment.example npm test

Configuration

All configuration is via environment variables. Copy .env.example and fill in the blanks.

Usage examples

MCP tools/list

curl -s -X POST https://agentic.clawbots.org/api/agentic/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools[].name'

MCP tools/call

curl -s -X POST https://agentic.clawbots.org/api/agentic/mcp \
  -H 'content-type: application/json' \
  -H "x-payment: $X_PAYMENT_BASE64" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{"name":"agent-revenue-optimizer","arguments":{"endpoint_url":"https://example.com/api/probe"}}
  }'

Free tier — repo-health-for-agents

curl -s -X POST https://agentic.clawbots.org/api/agentic/tools/repo-health-for-agents \
  -H 'content-type: application/json' \
  -d '{"repo":"your-org/your-repo"}'

50/day/IP free; over the limit returns the standard 402.

Architecture

Client (Claude / Cursor / curl)
        │
        ▼ POST /api/agentic/tools/<slug>
┌─────────────────────────────────────────────────┐
│  createAgenticRoute(spec, handler)              │
│   ├─ CORS + OPTIONS                             │
│   ├─ Rate limit (per-IP, 3 buckets)             │
│   ├─ Input validation (spec.inputSchema)        │
│   ├─ checkAccess(req)  ──► gate.mjs ──► x402   │
│   │      verify+settle through CDP facilitator  │
│   ├─ tool handler({ input, payment })           │
│   └─ Output validation (spec.outputSchema)      │
└─────────────────────────────────────────────────┘
        │
        ▼ JSON result + X-PAYMENT-RESPONSE header

• api/agentic/mcp.mjs is an MCP transport. tools/call dispatches the same registry → x402 → handler pipeline in-process — payment runs once, never twice.
• api/_lib/x402.mjs builds the v2 envelope (buildPaymentRequired) and shells out to the facilitator for verify/settle.
• tools/<slug>/spec.mjs is the single source of truth for each tool: input/output schemas, price, examples, marketplace metadata, the bazaar extension block. Validated at boot and at prebuild.
• scripts/generate-manifest.mjs regenerates /api/agentic/manifest, /api/agentic/openapi.json, /.well-known/agentic/tools/*.json, and the /.well-known/mcp.json server card from the registry.

Full reference: docs/ARCHITECTURE.md, docs/DESCRIPTOR.md, docs/DISCOVERY.md.

Development

npm install
npm run prebuild   # regenerate manifest + OpenAPI + .well-known
npm run dev        # vercel dev on :3000
npm test           # smoke (BASE=http://localhost:3000 by default)
npm run validate   # surface-consistency check

To add a tool, follow CONTRIBUTING.md §"Adding a new tool".

Verifying x402 v2 compliance

curl -sD- -X GET https://agentic.clawbots.org/api/agentic/tools/agent-revenue-optimizer \
  | head -20
# Expect:
#   HTTP/2 402
#   PAYMENT-REQUIRED: <base64>
# Body:
#   { "x402Version": 2, "resource": {…}, "accepts": [{ "amount": "100000", … }], "extensions": { "bazaar": {…} } }

The full compliance matrix lives in docs/X402_V2_COMPLIANCE_REPORT.md.

Discovery surfaces

Security

See SECURITY.md for the disclosure process. Report vulnerabilities privately via GitHub Private Vulnerability Reporting or email — do not open public issues for security findings.

Contributing

Pull requests welcome. Read CONTRIBUTING.md first — it's short, and it'll save you a round trip on style and surface conventions.

License

MIT.