Agentreader MCP Server

Axiom Works AgentReader — pay-per-call APIs for AI agents (x402)

Live: https://api.axiomworks.co.uk · MCP: https://api.axiomworks.co.uk/mcp (streamable HTTP) · Contact: info@axiomworks.co.uk

No API keys, no accounts. Agents pay per request in USDC on Base mainnet using the x402 protocol (HTTP 402).

Big hitters

Supporting real-data checks: /uk-company-lite, /uk-charity, /sanctions, /au-company, /ca-company, /us-sec, /lei-full, /eu-vat.

All endpoints

Payment: x402 v2, scheme exact, network eip155:8453, asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x88b1c747c33A5868A34057D8C57318E5602b3ff6 (AgentReader treasury, Coinbase CDP Server Wallet; swept to the operator's Coinbase account in batches), facilitator: Coinbase CDP (Bazaar indexing), PayAI fallback. Mirror: https://agentreader.yasirawouda1.workers.dev · Payers sign EIP-3009 — no ETH gas needed.

Free discovery: /llms.txt · /openapi.json · /.well-known/x402 · /.well-known/agent.json · /health

Apify Store

Same data as no-wallet Apify Actors (pay per event, billed by Apify) — profile: https://apify.com/ultramarine_gusto

HTTP: @x402/fetch

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register("eip155:8453", new ExactEvmScheme(privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)));
const fetchPaid = wrapFetchWithPayment(fetch, client);
const r = await fetchPaid("https://api.axiomworks.co.uk/company?domain=stripe.com");
console.log(await r.json());

MCP (paid tools via @x402/mcp)

Remote MCP server, streamable HTTP, stateless: https://api.axiomworks.co.uk/mcp

Tools: read_url, read_batch, extract_links, check_domain, company_research, uk_company, uk_company_lite, company_full, uk_charity, uk_charity_full, lei_lookup, lei_full, convert_document, create_monitor, plus on-chain/FX/search/UK property tools (paid) and pricing (free).

import { createx402MCPClient } from "@x402/mcp";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
import { privateKeyToAccount } from "viem/accounts";

const client = createx402MCPClient({
  name: "my-agent", version: "1.0.0",
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)) }],
  autoPayment: true,
  onPaymentRequested: async ({ paymentRequired }) => BigInt(paymentRequired.accepts[0].amount) <= 250000n, // cap per call
});
await client.connect(new StreamableHTTPClientTransport(new URL("https://api.axiomworks.co.uk/mcp")));
const res = await client.callTool("company_research", { domain: "stripe.com" });

Glama / local stdio MCP

For Glama “Runs from source” checks and local clients that prefer stdio, this repo includes a minimal Node MCP server that answers initialize and tools/list with no secrets, and proxies paid tool calls to the live API (unpaid calls return x402 payment-required JSON).

# Without Docker
node glama-mcp/index.js

# With Docker
docker build -t agentreader-mcp .
docker run -i --rm agentreader-mcp

glama.json claims maintainers for the Glama listing. The hosted streamable-HTTP MCP remains https://api.axiomworks.co.uk/mcp.

Integrations

Copy-paste clients in examples/: MCP (Claude Desktop / Cursor), @x402/fetch, x402-axios, Python x402, LangChain, Vercel AI SDK, OpenAI Agents SDK, CrewAI.

Free quality proof: /samples/company (and uk-company, uk-company-lite, convert, read) — truncated, rate-limited, with the exact paid call to make. Or add &preview=1 on a paid GET.

npm packages (Axiom Works)

# Typed SDK
npm i @axiomworks/agentreader

# Stdio MCP (Claude Desktop / Cursor / Claude Code)
npx -y @axiomworks/agentreader-mcp

{
  "mcpServers": {
    "agentreader": {
      "command": "npx",
      "args": ["-y", "@axiomworks/agentreader-mcp"],
      "env": { "AGENTREADER_PRIVATE_KEY": "0xYOUR_BASE_USDC_PAYER_KEY" }
    }
  }
}

• @axiomworks/agentreader — createClient({ privateKey? }), one method per tool, auto x402, preview mode
• @axiomworks/agentreader-mcp — stdio MCP; set AGENTREADER_PRIVATE_KEY / EVM_PRIVATE_KEY to auto-pay

Unscoped agentreader-mcp on npm is a different product; use the @axiomworks scope.

Python packages (Axiom Works)

# LangChain tools (47 x402 tools, agent wallet pays USDC on Base)
pip install agentreader-tools

# Framework thin wrappers (same payment model)
pip install agentreader-crewai
pip install llama-index-tools-agentreader
pip install "agentreader-agents[all]"   # PydanticAI + OpenAI Agents SDK

from agentreader_tools import agentreader_tools
tools = agentreader_tools(private_key=KEY, max_price_usd=0.01)

• agentreader-tools — LangChain StructuredTools
• agentreader-crewai — CrewAI BaseTools
• llama-index-tools-agentreader — LlamaIndex FunctionTool / ToolSpec
• agentreader-agents — PydanticAI Tool + OpenAI Agents SDK function_tool

Pairs well with

• Japanese suppliers: JPVerify checks Japanese corporate numbers (法人番号) and qualified-invoice T-numbers. Resolve the supplier there, then screen its official English / romanized name with /sanctions-batch (OFAC, UK, UN and EU lists; best on Latin-script names, see the note below).

Name screening and non-Latin scripts: the public lists are matched mainly on their Latin-script names and aliases. Submit the romanized or official English name (e.g. Toyota Motor Corporation); Japanese, Cyrillic or Arabic script only matches where the list itself carries that script as an alias. Since v1.39.3 non-Latin input no longer produces spurious matches.

Limits

Public http(s) URLs only (private/internal IPs blocked), 3 MB max, timeouts 10–120 s by route, 5 redirects, read/links/check cached ~5 min, max 40 active monitors.

Self-host

Cloudflare Worker (Hono + @x402/hono + @x402/mcp). npm i && npx wrangler deploy; set PAY_TO in wrangler.toml, secrets STATS_SECRET, DASHBOARD_KEY, optional CDP_API_KEY_ID/CDP_API_KEY_SECRET. Hourly cron runs monitors.

MIT licensed.

On-chain micro-lookups (v1.4.0, Base/Ethereum/Arbitrum/Optimism/Polygon)

Open search and UK official data (new in 1.5)

Free validation: every paid route and MCP tool validates input before payment. Bad input gets a free 400 with an error and an example. You are only asked to pay (402) for well-formed requests. | /wallet, /tx, /token-check, /fx | wallet_balances, tx_status, token_check, fx_rates | $0.003, $0.003, $0.01, $0.002 |

All support ?preview=1 (free, truncated, 8/IP/day). Edge-cached per input (10 s gas … 1 h token metadata) with multi-provider RPC fallback.

Path aliases

Explorer-style paths map to the same paid routes/prices: /tx/:hash, /ens/:name|:address, /contract/:address, /wallet/:address (/address/, /balance/), /token/:address, /token-check/:address, /block/:number, /nft/:contract/:id, /gas/:chain, /check/:domain, /domain/:domain, /email-check/:email, /uk-company/:number, /uk-charity/:number, /us-sec/:ticker|:cik, /eu-vat/:vat, /lei/:lei. Add ?chain= / ?preview=1 as usual.

Operator note

Companies House lists a dissolved AXIOMWORKS LTD (company number 06990365). That company is not the operator of api.axiomworks.co.uk or Axiom Works AgentReader.