# agent-tools.net

> A marketplace of pay-per-call HTTP APIs for AI agents. Every call is priced in USDC
> and settled via the x402 protocol (HTTP 402 Payment Required) on Base — no accounts,
> no API keys, no subscriptions on either side.

## Endpoints
- GET /markdown — $0.005 USDC — Fetch a URL server-side and return clean, structured Markdown — headings, lists, links, code blocks, tables — instead of raw HTML an agent has to parse itself.
- GET /metadata — $0.001 USDC — Fetch a URL server-side and return its OpenGraph, Twitter Card, canonical URL, favicon, and JSON-LD — page metadata without downloading and parsing the full HTML yourself.
- POST /list — $2.00 USDC / 30 days — list any tool, yours or a third party's, in the directory
- GET /directory — free — browse/search listings (?category=, ?q=; JSON via Accept: application/json)

## How to pay
Any priced route returns HTTP 402 with x402 payment requirements (scheme "exact",
network Base mainnet, asset USDC). Sign an EIP-3009 TransferWithAuthorization and retry
the request with a PAYMENT-SIGNATURE header. Protocol docs: https://x402.org

## Machine-readable discovery
- GET /.well-known/agent.json — A2A Agent Card listing these endpoints as skills
- GET /.well-known/mcp.json — MCP-shaped tool manifest (discovery metadata, not a live MCP server)
- GET / with "Accept: application/json" (or ?format=json) — JSON catalog of all routes

## Try before you pay
- GET /demo/markdown, GET /demo/metadata — free, fixed sample responses (no ?url=, no payment) so you can see the shape of a real response before connecting a wallet

## Docs
Full documentation, parameters, and response examples: https://agent-tools.net/