# Cults — how to use (mcp.ai)

Connect your Cults account and use 3 tools for ecommerce straight from your AI agent. Connect with your own API key. Cults is a digital marketplace for 3D printing models, offering a platform for designers to share and sell their creations.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_cults?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `cults_get_approved_origins`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/cults`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/cults/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/cults/get/approved/origins` — Inspects the Cults creation page to detect any sharing origin information. Note: Cults requires origins to be manually approved via support contact before use with the Share on Create feature. This ac
- `POST https://api.mcp.ai/api/cults/graph/ql/post` — Execute GraphQL queries and mutations against the Cults3D API. Cults3D is a marketplace for 3D printable models. This tool provides access to: - Browse and search 3D model designs (creations) - View u
  - body: { query: string, variables?: object, operationName?: string }
- `POST https://api.mcp.ai/api/cults/share/on/create/fr` — Generate a one-click share URL for publishing a 3D file to Cults (French locale). This tool constructs a shareable link that, when clicked by users, takes them to the Cults creation page with the 3D f
  - body: { origin: string, file_url: string }

## Example prompts
- "What can I do in Cults?"
- "Show me a summary of my Cults account"

## More
- Page: https://mcp.ai/cults
- Agent spec (llms.txt): https://mcp.ai/cults/llms.txt
- Postman collection: https://mcp.ai/cults/postman.json