# Althemax

> Althemax is an AI-agent-native marketplace and AI-commerce hub at https://www.althemax.com. One unified product catalogue is exposed to shoppers, merchants, and AI agents through a shared public API (product search, product detail, availability) and an agent-native cart + checkout. Currency: GBP. Merchants list from one dashboard across eBay, Shopify, TikTok Shop, Etsy, Amazon, Meta (Facebook/Instagram), Printify, and Google Shopping. Checkout completes on Althemax itself via embedded Stripe (GBP), and agents can transact programmatically via the UCP cart + checkout API (AP2 payment mandates).

## Agent API

- [Health probe](https://www.althemax.com/api/agent/health) — service + catalogue liveness (active product count, brands, categories).
- [Product search](https://www.althemax.com/api/agent/search?q=controller) — full-text product search; supports `q`, `first` (1-50), `after` (cursor).
- [Product detail](https://www.althemax.com/api/agent/product/for-xbox-series-x-s-bluetooth-wireless-controller-gamepad-joystickblack) — full product detail by handle.
- [Availability](https://www.althemax.com/api/agent/availability?handle=for-xbox-series-x-s-bluetooth-wireless-controller-gamepad-joystickblack) — current stock and per-variant availability.

## Agent cart + checkout (UCP)

- `POST /api/agent/cart` — create a cart (opaque cartToken). Optional body `{ items: [{ handle, optionId?, quantity? }] }` seeds it. Prices are resolved server-side.
- `GET /api/agent/cart/{cartToken}` — cart contents + subtotal.
- `POST|PATCH|DELETE /api/agent/cart/{cartToken}/items` — add / set quantity / remove a line.
- `POST /api/agent/cart/{cartToken}/checkout` — create a checkout session; `PATCH` to update; `POST …/checkout/complete` to complete against a verified AP2 mandate chain. Totals include shipping + tax. Payment is Stripe, GBP, platform-collected.

## Model Context Protocol (MCP)

- `POST https://www.althemax.com/api/agent/mcp` — remote MCP server (Streamable HTTP, no authentication). Exposes the same catalogue + cart + checkout as tools: `search_products`, `get_product`, `check_availability`, `create_cart`, `get_cart`, `add_cart_item`, `set_cart_item`, `remove_cart_item`, `create_checkout`, `update_checkout`, `complete_checkout`. Add it as a custom/remote MCP connector in Grok, ChatGPT or Claude to search and buy programmatically. For a human hand-off, share each product's `url`.

## Discovery files

- [/.well-known/api-catalog](https://www.althemax.com/.well-known/api-catalog) — RFC 9727 API catalog (RFC 9264 linkset). Primary discovery entry point. Returns `application/linkset+json` listing every machine-readable surface.
- [/openapi.json](https://www.althemax.com/openapi.json) — OpenAPI 3.1 description of the agent REST API.
- [/.well-known/agents.json](https://www.althemax.com/.well-known/agents.json) — agents.json action manifest.
- [/.well-known/ai-plugin.json](https://www.althemax.com/.well-known/ai-plugin.json) — OpenAI-compatible plugin manifest.
- [/.well-known/ucp](https://www.althemax.com/.well-known/ucp) — Universal Commerce Protocol profile (catalog + cart + checkout + MCP, AP2 payment).
- [/api/agent/mcp](https://www.althemax.com/api/agent/mcp) — commerce MCP server (Streamable HTTP; POST only).
- [/sitemap.xml](https://www.althemax.com/sitemap.xml) — XML sitemap of public pages.

## For humans

- [For agents — overview](https://www.althemax.com/for-agents)
- [For merchants — multi-channel selling, AlthemaxAI Suite (GEO + Subscription + Printify)](https://www.althemax.com/merchant)
- [Blog — guides, feature announcements, platform updates](https://www.althemax.com/blog)
- [Printify Bulk Design Tool guide](https://www.althemax.com/blog/printify-bulk-design-tool)
- [Merchants / sellers](https://www.althemax.com/merchants)
- [Pricing](https://www.althemax.com/pricing)

## Channels supported

Althemax merchants can list and sell across: Shopify, eBay, TikTok Shop, Etsy, Amazon (Seller Central + affiliate), Meta (Facebook/Instagram), Printify (print-on-demand), and Google Shopping. Payments on Althemax itself are Stripe (GBP).

## Notes for agents

- Currency: GBP (multi-currency display via viewer locale; `?currency=<ISO>` forces a currency on product pages).
- Marketplace product detail pages live at `https://www.althemax.com/products/{merchant}/{handle}` — the `url` field in each product API response is the canonical marketplace URL. Use it to render inline cards or link buyers.
- Availability is best-effort and refreshed on each request (cache up to 60s at the edge).
- Programmatic checkout IS available via the UCP agent cart + checkout endpoints above (Stripe, GBP, AP2 mandates). For a human hand-off, link the canonical product/marketplace URL where on-site checkout completes.
- Blog posts are human-readable guides at https://www.althemax.com/blog/{slug}.
- Use the `www.` host throughout — the apex `althemax.com` is not a guaranteed canonical host.