# Orshot — how to use (mcp.ai)

Connect your Orshot account and use 8 tools for AI content generation straight from your AI agent. Connect with your own API key. Orshot generates images, PDFs, and videos from templates and manages workspace templates, brand assets, and social publishing.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/orshot/add/brand/color` — Save a hex, RGB, HSL, or gradient color to the workspace brand assets and return its new ID.
  - body: { tags?: string[], value: string, color_type?: string }
- `POST https://api.mcp.ai/api/orshot/delete/brand/color` — Permanently delete one saved workspace brand color by ID. This deletion cannot be undone; use it only for a color the caller explicitly intends to remove.
  - body: { color_id: integer }
- `POST https://api.mcp.ai/api/orshot/get/profile` — Return the authenticated Orshot profile and the IDs, names, and slugs of its accessible workspaces.
- `POST https://api.mcp.ai/api/orshot/get/studio/template` — Return one Studio template's metadata, pages, and available render modifications by template ID. A 403 response can mean the template is missing or is not owned by the connected workspace; the API doe
  - body: { template_id: integer }
- `POST https://api.mcp.ai/api/orshot/list/brand/assets` — List one category of workspace brand assets, optionally requiring all supplied tags. Brand colors are limited by Orshot to the 200 most recent values.
  - body: { tags?: string[], asset_type: string }
- `POST https://api.mcp.ai/api/orshot/list/social/accounts` — Return connected social-account IDs and platforms, optionally checking whether each account needs reconnection.
  - body: { include_health?: boolean }
- `POST https://api.mcp.ai/api/orshot/list/studio/templates` — Return one filtered page of Studio templates in the API key's workspace, with an opaque cursor for the next page.
  - body: { tags?: string[], limit?: integer, search?: string, embed_id?: string, next_cursor?: string, embed_user_id?: string }
- `POST https://api.mcp.ai/api/orshot/render/studio/template` — Render an owned Studio template as an image or PDF URL/base64 result. This consumes render credits and does not publish to social accounts.
  - body: { scale?: number, width?: integer, height?: integer, file_name?: string, template_id: integer|string, include_pages?: integer[], modifications?: object, output_format?: string, response_type?: string }

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

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