# AgentPay

> Pay-per-call AI microservices via the x402 protocol (HTTP 402 Payment Required). USDC on Base. No accounts, no API keys — wallet is auth.

Base URL: https://agentpay.help
Auth: x402 payment flow — any unauthenticated POST returns HTTP 402 with payment instructions; an x402 client pays and retries automatically.
Network: eip155:8453 | Settlement: USDC | Facilitator: https://facilitator.payai.network

## Services
- `POST /v1/summarize`: AI text summarization — crisp 250-word summary of any text up to 20k chars. Price: $0.01 per call. Body: {"text":"string (200-20000 chars, required)"}.
- `POST /v1/classify-insurance`: Insurance lead classifier — intent, urgency, line of business, confidence. Price: $0.02 per call. Body: {"text":"string (10-5000 chars, required)"}.
- `POST /v1/sentiment`: Sentiment analysis — positive/negative/neutral with emotions and keywords. Price: $0.02 per call. Body: {"text":"string (10-5000 chars, required)"}.
- `POST /v1/extract`: Structured field extraction — key-value pairs from emails, forms, documents. Price: $0.03 per call. Body: {"text":"string (required)","fields":"string[] (optional — fields to extract)"}.
- `POST /v1/translate`: Text translation — translate to any language. Price: $0.03 per call. Body: {"text":"string (10-5000 chars, required)","targetLanguage":"string (optional, default Spanish)"}.
- `POST /v1/code-review`: AI code review — bugs, security, performance, quality score. Price: $0.05 per call. Body: {"code":"string (10-4000 chars, required)","language":"string (optional)"}.
- `POST /v1/insurance-analysis`: Full insurance analysis bundle — classification + field extraction + summary in one call. Price: $0.10 per call. Body: {"text":"string (10-20000 chars, required)"}.
- `POST /v1/token-safety`: Token safety check - rug pull risk, honeypot detection, liquidity analysis. Price: $0.02 per call. Body: {"address":"string (0x... required)","chain":"string (optional)"}.
- `POST /v1/wallet-risk`: Wallet risk screening - OFAC sanctions, scam flags, tx patterns. Price: $0.02 per call. Body: {"address":"string (0x... required)","chain":"string (optional)"}.
- `POST /v1/web-scrape`: Extract clean text from any URL - agents read web pages. Price: $0.01 per call. Body: {"url":"string (required)","max_chars":"number (optional)"}.
- `POST /v1/crypto-price`: Real-time crypto prices - BTC, ETH, SOL + more. Price: $0.005 per call. Body: {"symbols":"string[]","vs_currency":"string (optional)"}.
- `POST /v1/image-describe`: Vision AI - describe any image from URL. Price: $0.03 per call. Body: {"image_url":"string (required)","detail":"string (optional)"}.
- `POST /v1/defi-yields`: DeFi yield data - APY, TVL, protocol info. Price: $0.01 per call. Body: {"protocol":"string (optional)","chain":"string (optional)"}.
- `POST /v1/threat-intel`: CVE/threat intelligence - vulnerability lookup, severity. Price: $0.02 per call. Body: {"cve_id":"string","keyword":"string (optional)"}.
- `POST /v1/sanctions-screen`: OFAC/EU sanctions screening - entity check. Price: $0.02 per call. Body: {"name":"string (required)","type":"string (optional)"}.
- `POST /v1/market-intel`: Macro/economic snapshot - GDP, inflation, rates. Price: $0.02 per call. Body: {"country":"string (optional)"}.
- `POST /v1/on-chain-events`: Decoded on-chain events - recent transfers. Price: $0.01 per call. Body: {"address":"string (0x... required)","chain":"string (optional)"}.
- `POST /v1/content-safety`: Content security scan - PII, toxicity, bias. Price: $0.02 per call. Body: {"text":"string (required)"}.
- `POST /v1/agent-reputation`: Agent reputation score - endpoint trustworthiness. Price: $0.01 per call. Body: {"endpoint_url":"string (required)"}.
- `POST /v1/legal-lookup`: Legal/regulatory lookup - company registration. Price: $0.03 per call. Body: {"query":"string (required)","jurisdiction":"string (optional)"}.
- `POST /v1/news-feed`: Real-time news feed - headlines by topic. Price: $0.005 per call. Body: {"query":"string (required)","limit":"number (optional)"}.
- `POST /v1/weather-data`: Weather data - current conditions and forecast. Price: $0.005 per call. Body: {"location":"string (required)","days":"number (optional)"}.
- `POST /v1/web-search`: Web search - top results for any query with title, url, snippet. Price: $0.01 per call. Body: {"query":"string (required)","max_results":"number (optional, default 8)"}.
- `POST /v1/memory`: Persistent key-value memory scoped to your wallet - agents remember across runs. Price: $0.005 per call. Body: {"action":"get|set|delete|list (required)","key":"string (required for get/set/delete)","value":"any (required for set)","namespace":"string (optional, default 'default')"}.
- `POST /v1/geocode`: Geocode place names to lat/lon; reverse geocode coordinates to addresses. Price: $0.005 per call. Body: {"query":"string (required - place name or 'lat,lon')","reverse":"boolean (optional)"}.
- `POST /v1/eth-gas`: Ethereum gas prices - rapid/fast/standard/slow in gwei plus ETH spot price. Price: $0.003 per call. Body: {}.
- `POST /v1/prediction-market`: Polymarket prediction market odds - live probabilities for any topic. Price: $0.01 per call. Body: {"query":"string (required)","limit":"number (optional, default 5)"}.
- `POST /v1/deep-research`: PREMIUM deep research - multi-source web research into a cited markdown report. Price: $0.25 per call. Body: {"topic":"string (required)","depth":"standard|deep (optional, default standard)"}.

## Machine discovery
- [x402 catalog](https://agentpay.help/.well-known/x402) — machine-readable endpoint catalog
- [OpenAPI spec](https://agentpay.help/openapi.json) — full OpenAPI 3.0
- [Agent card](https://agentpay.help/.well-known/agent.json)
- [Health](https://agentpay.help/health) — liveness probe
- [Stats](https://agentpay.help/stats) — live paid-request stats
- [GitHub](https://agentpay.help/github) — source code (Apache-2.0)

## MCP
Remote MCP server (Streamable HTTP, no install, no auth) exposing all 28 services as MCP tools: POST https://agentpay.help/mcp
Endpoint manifest: https://agentpay.help/.well-known/mcp-endpoint.json | Discovery: https://agentpay.help/.well-known/mcp.json
MCP server (stdio) that wraps all paid endpoints and handles x402 payment automatically: `npx github:ronaldanton/x402-shop mcp-server.js` (env: SHOP_URL=https://agentpay.help, BUYER_PRIVATE_KEY=<hex key>).

## Example
`curl -i -X POST https://agentpay.help/v1/summarize -H 'Content-Type: application/json' -d '{"text":"..."}'` → HTTP 402 with payment terms.