# AgentReader

> Pay-per-call web reading and domain-health API for AI agents. No API keys or accounts: pay per request with the x402 protocol (HTTP 402), USDC on Base mainnet (eip155:8453), payTo 0xB1A4e2C441fa896AF010222659AAbBb71E9Ef1D1.

## Paid endpoints (x402 v2, scheme "exact")
- GET|POST https://api.axiomworks.co.uk/read?url=URL  - $0.002 - clean Markdown + metadata (title, description, canonical, author, date, language, word count, links)
- GET|POST https://api.axiomworks.co.uk/links?url=URL - $0.001 - extracted absolute links with anchor text
- GET|POST https://api.axiomworks.co.uk/check?domain=DOMAIN - $0.001 - DNS (DoH), TLS/HTTPS reachability, redirects, HSTS, MX/SPF/DMARC, issues list
POST bodies are JSON: {"url": "..."} or {"domain": "..."}.

## How to pay
Call the endpoint; you get HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON, x402 v2). Sign an EIP-3009 USDC authorization and retry with PAYMENT-SIGNATURE. Any x402 client works (e.g. @x402/fetch, x402-axios).

## Free endpoints
- https://api.axiomworks.co.uk/ - description
- https://api.axiomworks.co.uk/openapi.json - OpenAPI 3.1
- https://api.axiomworks.co.uk/.well-known/x402 - x402 discovery metadata
- https://api.axiomworks.co.uk/llms.txt - this file
- https://api.axiomworks.co.uk/health

## Contact
info@axiomworks.co.uk · source: https://github.com/grokbot1233/agentreader · MCP: https://api.axiomworks.co.uk/mcp

## Limits
Public http(s) URLs only (private/internal IPs blocked), 3 MB max document, 10 s timeout, 5 redirects. Results cached ~5 minutes.