# Amazap

> Amazap (amazap.com) is the storefront for economic agents: an Amazon-style catalog of pay-per-call APIs that AI agents search and buy through one MCP server, paid in Bitcoin Lightning sats via L402. Amazap is a flagship user of the Amboss API and an Amboss referral partner.

Amazap lists about 1,400 API listings from public L402 and x402 directories (402 Index, PayPerQ, Coinbase's x402 Bazaar) plus Amazap's own first-party services, Amazap Basics. Listings payable over Lightning (all L402 listings and Lightning-payable x402 listings) can be bought in sats. USDC-only x402 listings are shown but not yet buyable. Amazap is the merchant of record: it buys each call from the seller and returns the seller's response to your agent.

Install the MCP:

- MCP URL: https://amazap.com/mcp (Streamable HTTP, OAuth sign-in with dynamic client registration)
- Claude Code: `claude mcp add --transport http amazap https://amazap.com/mcp`
- Claude (web/desktop): Customize, Connectors, Add custom connector, paste the MCP URL, Add
- Cursor, VS Code: use the install buttons at https://amazap.com/mcp, or add an HTTP MCP server with the URL above
- ChatGPT: developer mode, create an app, paste the MCP URL, choose OAuth, Scan Tools
- Approving the connection opens an agent account with a balance of 0 sats. Ask the agent to top up, pay the Lightning invoice, then buy.
- Starter prompt: "Find me a weather API on Amazap and buy one current reading for Berlin."

MCP tools:

- `search_catalog`: find SKUs by keyword, with seller price, Amazap fee, and total sats per call
- `describe_sku`: parameters, schema confidence, and all-in price for a SKU
- `quote`: read-only all-in price with quoteId and expiry; spends nothing
- `buy`: pays for one SKU from the balance and returns the seller response; requires `total_cost` and `max_total_sats` from a quote, and charges nothing if the real total is higher
- `balance`: remaining sats, today's spend, per-call and per-day caps
- `top_up`: creates a Lightning invoice and QR for the human to pay; moves no sats itself
- `fee_schedule`: live fee in basis points, minimum sats, and formula
- `report_sku`: flag a bad schema, a junk response, or a dead SKU
- `claim_failed_call`: claim a re-credit for a failed paid call within 72 hours of the call; paid back as Amazap credits, not cash

Pricing and fees:

- Every quote is one all-in price: seller price plus the Amazap fee.
- Amazap fee on third-party listings: 20% of the seller price, minimum 3 sats. Healthy, high-volume listings: 5%. New or unreliable listings may carry a risk markup, always included in the quote.
- Amazap Basics are sold at their listed price with no Amazap fee. They are priced in USD and paid in sats at the rate locked in the quote.
- The balance is prepaid Amazap service credit. It stays valid while the account is used at least once a year. It can't be cashed out or transferred.
- A paid call that fails is credited back in full, fee included, as service credit: automatically when the failure is caught at call time, or by `claim_failed_call` within 72 hours. It is not refunded in sats or cash.

Amazap Basics (first-party L402 APIs, also callable directly with any L402 client):

- Page to Markdown: `GET https://amazap.com/basics/v1/markdown?url=` returns a public page as Markdown. $0.01 a page (13 sats).
- Page Metadata: `GET https://amazap.com/basics/v1/metadata?url=` returns title, description, canonical, share image, favicon, language, links, text. $0.01 a page.
- PDF to Markdown: `GET https://amazap.com/basics/v1/pdf?url=` returns PDF text (up to 20 MB) as Markdown. $0.02 a file.
- Feed Reader: `GET https://amazap.com/basics/v1/feed?url=` parses RSS or Atom, or finds a page's feed. $0.01 a feed.
- QR Code: `GET https://amazap.com/basics/v1/qr?data=` returns a QR image (png or svg). $0.01 an image.
- Page Screenshot: `GET https://amazap.com/basics/v1/screenshot?url=` returns a PNG of a public page. $0.03 a page.

## Start here

- [Install the Amazap MCP](https://amazap.com/mcp): MCP URL and per-client install steps
- [Agentic payments explained](https://amazap.com/agentic-payments): what agentic payments are, L402 vs x402 vs cards, and how Amazap works
- [Full documentation for agents](https://amazap.com/llms-full.txt): everything in this file, plus the HTTP API and receipts

## API

- [OpenAPI spec for Amazap Basics](https://amazap.com/openapi.json): first-party L402 endpoints with USD prices
- [Product search API](https://amazap.com/api/products): JSON catalog search (q, protocol, category, healthyOnly, limit, offset)
- [Catalog stats](https://amazap.com/api/meta): live listing counts by source and protocol

## Catalog

- [Storefront](https://amazap.com/): browse and search all listings
- [Page to Markdown](https://amazap.com/product/amazap-basics-page-to-markdown): flagship Amazap Basics listing
- [PDF to Markdown](https://amazap.com/product/amazap-basics-pdf-to-markdown): Amazap Basics listing
- [Page Metadata](https://amazap.com/product/amazap-basics-page-metadata): Amazap Basics listing
- [Feed Reader](https://amazap.com/product/amazap-basics-feed-reader): Amazap Basics listing
- [QR Code](https://amazap.com/product/amazap-basics-qr-code): Amazap Basics listing
- [Page Screenshot](https://amazap.com/product/amazap-basics-page-screenshot): Amazap Basics listing

## Optional

- [Credits and failed-call policy](https://amazap.com/credits): how the balance and re-credits work
- [Sell on Amazap](https://amazap.com/sell): list an L402 API
- [Amboss](https://amboss.tech): Amazap is a flagship user of the Amboss API and an Amboss referral partner
- [L402 protocol](https://docs.lightning.engineering/the-lightning-network/l402): Lightning Labs' spec for HTTP 402 with Lightning