# Modelry — how to use (mcp.ai)

Connect your Modelry account and use 14 tools for ecommerce straight from your AI agent. Connect with your own API key. Modelry is a 3D visualization platform for eCommerce that creates custom 3D product models, AR experiences, and digital asset management.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_modelry?ms=1787295720000`
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. `modelry_create_workspace`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/modelry`
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/modelry/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/modelry/create/workspace` — Create a new workspace or return an existing one with the same name. Workspaces are used to organize products and embeds in Modelry. If workspace creation is not supported by the API, this tool will r
  - body: { name: string, description?: string }
- `POST https://api.mcp.ai/api/modelry/delete/embed` — Tool to delete an embed. Tries multiple common endpoint patterns and treats 404 as idempotent success after exhausting candidates (embed already deleted or not found).
  - body: { embedId: string, workspaceId?: string }
- `POST https://api.mcp.ai/api/modelry/delete/product` — Permanently deletes a product from Modelry by its ID. Use this action to remove a product that is no longer needed. This operation is idempotent - deleting an already-deleted product will succeed with
  - body: { productId: string }
- `POST https://api.mcp.ai/api/modelry/delete/product/repository` — Permanently delete a product repository from Modelry. This action is idempotent - deleting a non-existent repository returns success. Use the list product repositories action first to get valid reposi
  - body: { repositoryId: string }
- `POST https://api.mcp.ai/api/modelry/delete/workspace` — Permanently deletes a Modelry workspace. This action is idempotent - deleting a non-existent workspace will return success. Use the list workspaces action first to get valid workspace IDs. WARNING: Th
  - body: { workspaceId: string }
- `POST https://api.mcp.ai/api/modelry/get/embed` — Retrieve details of a specific Modelry embed (3D viewer or AR experience for eCommerce). Use MODELRY_LIST_EMBEDS first to obtain valid embed IDs. Returns embed metadata including status, workspace, an
  - body: { embed_id: string }
- `POST https://api.mcp.ai/api/modelry/get/workspace` — Retrieves details for a specific Modelry workspace by its ID or name. The workspace ID can be obtained from the List Workspaces action. This action fetches all workspaces and returns the matching one.
  - body: { workspace_id: string }
- `POST https://api.mcp.ai/api/modelry/list/embeds` — List embeds in Modelry. Embeds are 3D viewer/AR embed codes for products. Use to retrieve embed IDs for downstream actions (e.g., MODELRY_GET_EMBED, MODELRY_DELETE_EMBED). Returns empty list if no emb
  - body: { page?: integer, per_page?: integer, workspace_id?: string }
- `POST https://api.mcp.ai/api/modelry/list/modeling/requests` — List all 3D modeling requests in a workspace. Requires workspace_id to scope the request. Returns modeling requests with their status and metadata.
  - body: { page?: integer, per_page?: integer, workspace_id: string }
- `POST https://api.mcp.ai/api/modelry/list/product/repositories` — Tool to list all product repositories in a workspace. Use after confirming the workspace ID.
  - body: { page?: integer, per_page?: integer, workspace_id: string }
- `POST https://api.mcp.ai/api/modelry/list/products` — List all products in Modelry. Returns paginated product data including IDs, names, and metadata. Use this to retrieve product IDs needed for other product-related actions like delete or get details. O
  - body: { page?: integer, per_page?: integer, workspace_id?: string }
- `POST https://api.mcp.ai/api/modelry/list/workspaces` — Tool to list all workspaces in Modelry. Use when you need to retrieve available workspaces after authenticating.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/modelry/order/modeling/service` — Tool to place an order for 3D modeling services. Use when workspace and product IDs are known and modeling specifications are ready.
  - body: { notes?: string, due_date?: string, priority?: string, product_id: string, service_type: string, workspace_id: string, reference_images?: string[] }
- `POST https://api.mcp.ai/api/modelry/track/modeling/progress` — Tool to track the progress of a 3D modeling request. Use after initiating a modeling job to poll current status and completion percentage.
  - body: { request_id: string }

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

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