# Counter

> A marketplace where AI agents buy handmade goods directly from makers in Mexico, the Philippines, Kenya and India. Agents search, ask, negotiate and check out over MCP; a human approves every payment on PayPal, which holds the maker's money until the order ships and arrives.

## MCP server

- URL: https://counter-2cdt.onrender.com/api/mcp
- Transport: Streamable HTTP, stateless, no sign-in

## Tools

- search_products (Search handmade products): Search handmade goods sold directly by makers in Mexico, the Philippines, Kenya and India.
- get_product (Get product details): Full listing for one product: description, materials, care, the maker's provenance story (in English and the maker's language), dimensions, photos, units available, and shipping to buyerCountry.
- ask_question (Ask about a product): Ask a question about one product (size, materials, care, who made it, shipping, stock).
- make_offer (Make a price offer): Offer the maker a price per item (USD, shipping not included) when get_product shows negotiable.
- create_checkout (Create a PayPal checkout): Creates a PayPal checkout plus flat shipping to buyerCountry: pass productId to buy at the listed price, or offerId from make_offer to buy at the agreed price.
- get_order_status (Get order status): Status of an order from create_checkout: payment state, what happens next, tracking once shipped, and whether the maker has been paid.

## How to buy

1. search_products with the buyer's words and buyerCountry
2. get_product for the full listing and shipping to the buyer
3. Optional: ask_question, or make_offer when the product is negotiable
4. create_checkout with productId (list price) or offerId (agreed price)
5. A human approves every payment on PayPal at approvalUrl; nothing is charged before that
6. get_order_status with the statusToken once the buyer says they approved

## ACP checkout

- https://counter-2cdt.onrender.com/api/acp/checkout_sessions: Agentic Commerce Protocol checkout (API-Version 2025-09-29), one product per session at list price. complete returns a PayPal approval link instead of taking a payment token

## Rules

- Prices and totals are in USD. create_checkout requires buyerCountry (ISO 3166-1 alpha-2)
- Limits per agent: calls 120 per min, checkouts 20 per 10 min, offers 10 per 10 min (at most 3 per product per day), questions 30 per h

## Links

- [Product feed](https://counter-2cdt.onrender.com/feed.json): every product for sale, OpenAI product feed fields
- [Sample product](https://counter-2cdt.onrender.com/p/wool-coaster-set): product page with schema.org JSON-LD