For the Cult — API for AI agents

API-first store. Browse products, optional Sign in with Moltbook, checkout with crypto. Start with GET /api/agent/capabilities.

Quick start

GET /api/agent/capabilities — endpoints, payment options, limits.
Optional: header X-Moltbook-Identity for /api/agent/me, /api/agent/me/orders, /api/agent/me/preferences; same header at checkout links order to agent.
GET /api/agent/products or POST /api/products/semantic-search → POST /api/checkout.

Checkout flow

Discover products: GET /api/agent/products or POST /api/products/semantic-search (JSON body: {"query": "..."}).
Create order: POST /api/checkout with items, email, payment (chain, token), shipping address.
Poll until paid: GET /api/orders/{orderId}/status every few seconds until status is "paid" (payment window 1 hour).

Endpoints (one per line)

GET https://ai.forthecult.store/api/agent/capabilities
POST https://ai.forthecult.store/api/agent/shop
GET https://ai.forthecult.store/api/agent/products
POST https://ai.forthecult.store/api/checkout
GET https://ai.forthecult.store/api/agent/me
GET https://ai.forthecult.store/api/agent/me/orders
GET / PATCH https://ai.forthecult.store/api/agent/me/preferences
LINK https://moltbook.com/auth.md?app=ForTheCult&endpoint=https%3A%2F%2Fai.forthecult.store%2Fapi%2Fagent%2Fme
LINK https://ai.forthecult.store/api/openapi.json

Endpoint reference

Capabilities(GET): Start here. Returns what the API can do, payment options, and quick-start steps.; https://ai.forthecult.store/api/agent/capabilities
Shop (AI assistant)(POST): Natural language shopping. Send a message, get AI reply + structured products.; https://ai.forthecult.store/api/agent/shop
Products (agent-optimized)(GET): Minimal product list for bots. Optional ?q=... and ?limit=...; https://ai.forthecult.store/api/agent/products
Checkout(POST): Create an order with card or crypto. Supports x402 autonomous payment.; https://ai.forthecult.store/api/checkout
Me (Moltbook identity)(GET): Requires X-Moltbook-Identity header. Returns the verified agent profile.; https://ai.forthecult.store/api/agent/me
My orders(GET): Requires Moltbook auth. Lists orders placed with your agent identity.; https://ai.forthecult.store/api/agent/me/orders
My preferences(GET / PATCH): Requires Moltbook auth. Get or update key-value preferences (e.g. default_shipping_country).; https://ai.forthecult.store/api/agent/me/preferences
Auth instructions: Moltbook-hosted instructions for bots: how to get and send an identity token.; https://moltbook.com/auth.md?app=ForTheCult&endpoint=https%3A%2F%2Fai.forthecult.store%2Fapi%2Fagent%2Fme
OpenAPI spec: Machine-readable API specification.; https://ai.forthecult.store/api/openapi.json

Error handling

API error responses (4xx/5xx) may include a _suggestions array with recommended next steps for agents.

Links

https://ai.forthecult.store/api/agent/summary
https://ai.forthecult.store/api/agent/capabilities
https://ai.forthecult.store/api/openapi.json
https://ai.forthecult.store/api/docs