x402-services

x402 Agent Kit

Integration materials for calling nine pay-per-call data APIs for AI agents — no API keys, no signup, USDC on Base via the x402 protocol. By Jebadiah.

• quickstart.md — the x402 payment flow in 3 steps, with a verified Python example and TypeScript one-liner
• openai-functions.json — 22 OpenAI function-calling tool definitions (one per priced endpoint)
• mcp-manifest.json — MCP-style tool manifest with x402 annotations
• langchain-tools.py — LangChain @tool wrappers with automatic 402 handling
• x402-services/SKILL.md — Claude Code skill: drop this folder into your skills directory

MCP server — run from source (no npm needed)

mcp-server/ is a stdio MCP server exposing all nine services as 22 MCP tools, with automatic x402 payment handling. There is no npm release yet, so run it straight from this repo:

git clone https://github.com/samgouffsm-crypto/x402-agent-kit
cd x402-agent-kit/mcp-server
npm install && npm run build

Point your MCP client at it:

{
  "mcpServers": {
    "x402-services": {
      "command": "node",
      "args": ["<repo>/mcp-server/dist/index.js"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_KEY" }
    }
  }
}

Fund your own Base wallet with a little USDC; the key only ever signs gasless EIP-3009 authorizations on your machine. Full setup in mcp-server/README.md.

The services

Service	Endpoint	Price
TenderWatch — gov procurement search + fit-scoring	https://x402-tenderwatch.onrender.com	$0.01–$0.02/call
EDGAR Lens — SEC filing search/extraction	https://x402-edgar-lens.onrender.com	$0.02–$0.05/call
TrialScope — clinical trial search/deltas	https://x402-trialscope.onrender.com	$0.01–$0.02/call
DocExtract — PDF → structured JSON	https://x402-docextract.onrender.com	≤$0.10/doc
PatentScope — patent search/prior-art	https://x402-patentscope.onrender.com	$0.02–$0.05/call
Alexandria — auto parts intelligence	https://x402-alexandria.onrender.com	$0.02–$0.05/call
InvoiceIQ — AP invoice extraction	https://x402-invoiceiq.onrender.com	$0.05/doc
TaxRate US — state sales-tax rate + nexus	https://x402-taxrate.onrender.com	$0.03 ($0.01 nexus)
EntityVerify — business verification	https://x402-entityverify.onrender.com	$0.07/check

Each service also serves /llms.txt, /openapi.json, and /.well-known/x402.