# Doc Tools

> PDF to text, RSS/Atom feeds to JSON, sitemaps to URL lists. No signup: pay per request with x402 (USDC on Algorand or Base) or with prepaid credits.

Document utilities agents otherwise have to install libraries for: extract per-page text from a PDF URL, normalize RSS/Atom/JSON feeds into JSON items, and crawl a site's sitemaps (via robots.txt) into a URL list.

- GET https://agentpay-tools.agentpay-apis.workers.dev/tools/v1/pdf-text?url=https%3A%2F%2Fexample.com%2Ffile.pdf — Extract per-page text from a PDF URL (up to 20MB). ($0.01 per call)
    - url (required): URL of a PDF
- GET https://agentpay-tools.agentpay-apis.workers.dev/tools/v1/feed?url=https%3A%2F%2Fhnrss.org%2Ffrontpage — Parse an RSS, Atom or JSON Feed into normalized JSON items. ($0.005 per call)
    - url (required): Feed URL
    - limit: Max items (default 50)
- GET https://agentpay-tools.agentpay-apis.workers.dev/tools/v1/sitemap?url=https%3A%2F%2Fexample.com — List a site's URLs from its sitemaps (follows robots.txt and sitemap indexes). ($0.005 per call)
    - url (required): Site origin or sitemap URL
    - limit: Max URLs (default 5000)

## Payment

Standard x402 v2. Call an endpoint without payment to get HTTP 402 with a base64 PaymentRequired object in the PAYMENT-REQUIRED header, then retry with PAYMENT-SIGNATURE. Any x402 v2 client (e.g. @x402/fetch) works. Invalid input is rejected before payment, and payments are only settled if the call succeeds.

- USDC on Base (eip155:8453), exact scheme (EIP-3009), payTo 0x5d5d827D899CdcaCbD2b2e80162D805B3783C9D8. Settled via facilitator.
- USDC on Algorand (algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73k), exact scheme, ASA 31566704, payTo F2ZYO2DDPQXOACUYBYQIHMQRAB3TJFZVCNUD3OU3CR5OOJUKFZOF5EYVJ4. Send a signed paymentGroup (client pays its own fee); settled directly by this server.

## Prepaid credits (cheapest for repeated use)

- Buy: GET https://agentpay-tools.agentpay-apis.workers.dev/credits/buy?usd=5 — pay once via x402 on either network, receive {"apiKey"}. Any amount $1-$500; bonus credit +10% at $5+, +20% at $20+.
- Or send USDC on Algorand to F2ZYO2DDPQXOACUYBYQIHMQRAB3TJFZVCNUD3OU3CR5OOJUKFZOF5EYVJ4 with note `agentpay:<sha256 hex of a secret>`, then POST https://agentpay-tools.agentpay-apis.workers.dev/credits/redeem {"txid","secret"}.
- Use: header `Authorization: Bearer <apiKey>`. Calls cost the Algorand price. Failed calls are refunded. Balance: GET https://agentpay-tools.agentpay-apis.workers.dev/credits/balance.

## Integrations

- OpenAPI: https://agentpay-tools.agentpay-apis.workers.dev/tools/openapi.json
- MCP server (Streamable HTTP): https://agentpay-tools.agentpay-apis.workers.dev/tools/mcp — x402 via params._meta["x402/payment"], or header "Authorization: Bearer <apiKey>"
- x402 index: https://agentpay-tools.agentpay-apis.workers.dev/.well-known/x402
- Docs and example clients: https://github.com/noah-silver/agentpay