io.github.0xAxiom/axiom-agentic-tools

Official9 tools

by 0xAxiom · JavaScript

Axiom Agentic Tools

x402-paid Base agent tools (USDC). 5 deterministic tools. No API keys. No NFT pass.

Base network agent tools with USDC payment and deterministic on-chain operations.

Topics

agenticbasecoinbase-bazaarerc-8004mcpmodel-context-protocolserverlessusdcvercelx402

Captured live from the server via tools/list.

agent-revenue-optimizer

Audit an x402-gated endpoint by probing its 402 envelope, agent-card.json, well-known surfaces, and response headers. Returns a closed-vocabulary verdict plus 3-7 scored recommendations across pricing, bundling, discoverability, envelope correctness, rate limiting, tier expansion, facilitator choice, and schema clarity. Each recommendation cites the observed current-state value as evidence.

Parameters (2)

endpoint_urlstringrequired
Public HTTP(S) URL of the x402-gated endpoint to audit. Must respond with an HTTP 402 envelope on an unauthenticated GET (or POST). Example: https://x402.org or any /api/tools/<slug> on a deployed x402 service.
assumed_monthly_paid_callsinteger
Optional estimate of how many paid calls per month the endpoint currently receives. Used to scale recommendation impact_usd_per_month from a per-call delta to a monthly figure. Defaults to 1000 if omitted.

agent-token-strategy

Design a non-security token strategy for an autonomous agent. Returns a deployable spec: symbol, supply, distribution allocations summing to 100, OpenZeppelin contract templates (ERC20, ERC4626, ERC721), fair-launch defaults, a six-criterion non-security checklist, an estimated Base deploy cost, and a curated risks list covering Sybil, LP rug, and key-compromise vectors.

Parameters (5)

agent_namestringrequired
Display name of the agent the token represents.
symbolstringrequired
Ticker symbol, 2-10 chars, A-Z and digits, leading letter.
patternstringrequired
Which template to base the strategy on.
total_supplyinteger
Optional total supply override. Defaults to template default.
include_nftboolean
Include an ERC721 access pass alongside the ERC20.

base-builder-grant-finder

Returns a ranked, deadline-aware list of open Base ecosystem funding programs (grants, accelerators, hackathons, retro-funding). Each result cites source_url, deadline, funding_range_usd, and last_verified_at. Stale entries are flagged. Designed for agents and builders shipping on Base who need a single call to surface the next applicable funding deadline.

Parameters (4)

categorystringrequired
Project category. Used to match grant program eligibility and scope. 'ai-agent' covers agent infrastructure, autonomous agents, and agent-economy projects; 'tooling' covers dev tools and SDKs; 'any' returns programs that accept all categories. Required.
stagestring
Current project stage. 'idea' is pre-prototype; 'prototype' has working demo; 'mainnet' has deployed Base contracts; 'scaling' has live users and revenue. Used as an additional eligibility filter against grant stage requirements. Defaults to 'any'.
has_live_base_contractboolean
True if the project already has at least one deployed contract on Base mainnet. Several grants (Base Builder Grants, Coinbase Developer Grants) score higher for live-on-Base projects. Defaults to false.
max_resultsinteger
Maximum number of ranked program results to return. Programs are scored by match against category, stage, has_live_base_contract, and deadline proximity. Defaults to 10.

base-gas-tracker

Live Base network gas tracker. Returns current gas price in gwei, base fee, priority fee (tip), and a block history showing recent gas trends. Useful for timing transactions and estimating costs. $0.01/call.

Parameters (1)

blocksinteger
Number of recent blocks to include in history (1-20, default 10)

mcp-security-scanner

Scans an MCP server manifest or endpoint for security vulnerabilities — prompt injection in tool descriptions, exfiltration vectors, unbounded resource access, privilege escalation, schema mismatches, transport security issues, and over-permissive scopes. Returns a structured risk report with severity levels and remediation guidance.

Parameters (3)

manifestUrlstring
URL of the MCP server manifest (e.g. https://example.com/.well-known/agentic/manifest.json). Mutually exclusive with manifestJson.
manifestJsonobject
Raw MCP manifest JSON object to scan. Mutually exclusive with manifestUrl.
checksarray
Specific check categories to run. Omit to run all checks.

multi-agent-workflow-designer

Compose a directed acyclic graph of public x402, MCP, and A2A tools that achieves a stated agent goal. Returns step-by-step plan with tool slug, endpoint URL, protocol, inputs, dependencies, per-step cost and latency, total estimated cost, and an executable plan in either a2a-json-rpc or shell-curl form. Useful for autonomous agents that need to pick which paid tools to chain.

Parameters (5)

goalstringrequired
Plain-English agent goal, e.g. 'sweep top 5 floor NFTs in collection X if contract is safe and gas is low'.
budget_usdnumber
Maximum total spend across all chained tool calls. Steps over budget are pruned.
max_stepsinteger
Cap on number of steps in the returned DAG.
output_formatstring
Executable plan format. Defaults to a2a-json-rpc.
preferred_protocolsarray
Restrict catalog selection to these protocols. Empty = all.

polymarket-odds

Fetch live prediction market odds from Polymarket. Returns current probabilities, volume, liquidity, and resolution status for any active or resolved market. Accepts a market slug or keyword search term. $0.01/call.

Parameters (1)

questionstringrequired
Polymarket market slug (e.g. 'will-trump-win-2024') or keyword search term

repo-health-for-agents

Comprehensive GitHub repository health audit. Scores repos 0-100 across 8 categories: activity, community, maintenance, contributors, security (via OpenSSF Scorecard), CI/CD, documentation, and popularity. Returns letter grade, per-category scores, 20+ individual checks with evidence, and prioritized recommendations sorted by impact. All checks run via GitHub API — no clone required. Free: 50 calls/IP/day.

Parameters (1)

repostringrequired
GitHub owner/name (e.g. vercel/next.js)

wallet-portfolio

Fetch token balances for an Ethereum/Base wallet address. Returns ETH, USDC, WETH, AXIOM, and BNKR balances on Base with current USD values from DeFiLlama price data. $0.01/call.

Parameters (1)

addressstringrequired
Ethereum/Base wallet address (0x...)

README.md12 KBView on GitHub

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

Slug	Price	Returns
`agent-revenue-optimizer`	$0.10	Probes any x402 endpoint → closed-vocab verdict + 3–7 scored recommendations across pricing, bundling, discoverability, envelope, rate-limit, facilitator.
`agent-token-strategy`	$0.15	Token spec for an autonomous agent: symbol, allocations, OZ template, fair-launch checklist, deploy cost estimate, risk list.
`multi-agent-workflow-designer`	$0.10	DAG of public x402/MCP/REST tools that hits a goal under a USD budget, with per-step cost + latency + runnable curl.
`base-builder-grant-finder`	$0.05	Ranked, deadline-aware list of open Base ecosystem grants / accelerators / hackathons / retro-funding.
`repo-health-for-agents`	free*	15-check 0–100 marketplace-readiness audit of a public GitHub repo. Each check carries pass/fail + URL evidence.

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

bash

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

Cursor

Cursor → Settings → MCP → New MCP server:

json

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

Cline

Cline → Settings → MCP servers → Configure MCP servers:

json

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

Windsurf

Windsurf → Settings → MCP → Add server:

json

{
  "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

bash

# 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.

bash

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:

bash

vercel link                       # one-time
vercel --prod

Production smoke:

bash

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

Configuration

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

Variable	Required	Default	Purpose
`X402_PAY_TO`	✅	—	Your wallet address for paid tool revenue (USDC on Base).
`X402_FACILITATOR_URL`	—	`https://api.cdp.coinbase.com/platform/v2/x402`	Facilitator endpoint. CDP is what Bazaar indexes.
`CDP_API_KEY_ID`	✅ (if CDP)	—	CDP server-side credentials. Get them at portal.cdp.coinbase.com.
`CDP_API_KEY_SECRET`	✅ (if CDP)	—	—
`X402_NETWORK`	—	`base`	`base` or `base-sepolia`.
`BASE_RPC_URL`	—	`https://mainnet.base.org`	Base mainnet RPC. Use a private RPC in production.
`PUBLIC_BASE_URL`	—	(Vercel default)	Absolute base URL of your deployment. Populates manifest/OpenAPI/discovery links.
`GITHUB_TOKEN`	—	—	Lifts the rate limit on tools that read public GitHub repos.

Usage examples

MCP `tools/list`

bash

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`

bash

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`

bash

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

code

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

bash

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

bash

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

Surface	URL
MCP endpoint	`https://agentic.clawbots.org/api/agentic/mcp`
Tool manifest	`https://agentic.clawbots.org/api/agentic/manifest`
OpenAPI 3.1	`https://agentic.clawbots.org/api/agentic/openapi.json`
Health probe	`https://agentic.clawbots.org/api/agentic/health`
`.well-known/agentic/tools/<slug>.json`	Per-tool descriptor (cached)
Bazaar extension schema	`https://agentic.clawbots.org/.well-known/schemas/x402-extension-bazaar-v2.json`

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.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "axiom-agentic-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agentic.clawbots.org/api/agentic/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

agent-revenue-optimizer

agent-token-strategy

base-builder-grant-finder

base-gas-tracker

mcp-security-scanner

multi-agent-workflow-designer

polymarket-odds

repo-health-for-agents

wallet-portfolio

Axiom Agentic Tools

Overview

Features

Tools

Quick start

From an MCP-aware editor

Claude Code

Cursor

Cline

Windsurf

Smithery Toolbox

From AgentKit

From raw HTTP

Installation (self-host)

Configuration

Usage examples

MCP tools/list

MCP tools/call

Free tier — repo-health-for-agents

Architecture

Development

Verifying x402 v2 compliance

Discovery surfaces

Security

Contributing

License

Install

MCP `tools/list`

MCP `tools/call`

Free tier — `repo-health-for-agents`