# Orshot — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/orshot

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_orshot?ms=1787291340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/orshot/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/orshot/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/orshot/skill.md
Postman collection (v2.1): https://mcp.ai/orshot/postman.json

## Tools
- orshot_add_brand_color(tags?: string[], value: string, color_type?: string) — Save a hex, RGB, HSL, or gradient color to the workspace brand assets and return its new ID.
- orshot_delete_brand_color(color_id: integer) — 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.
- orshot_get_profile() — Return the authenticated Orshot profile and the IDs, names, and slugs of its accessible workspaces.
- orshot_get_studio_template(template_id: integer) — 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
- orshot_list_brand_assets(tags?: string[], asset_type: string) — List one category of workspace brand assets, optionally requiring all supplied tags. Brand colors are limited by Orshot to the 200 most recent values.
- orshot_list_social_accounts(include_health?: boolean) — Return connected social-account IDs and platforms, optionally checking whether each account needs reconnection.
- orshot_list_studio_templates(tags?: string[], limit?: integer, search?: string, embed_id?: string, next_cursor?: string, embed_user_id?: string) — Return one filtered page of Studio templates in the API key's workspace, with an opaque cursor for the next page.
- orshot_render_studio_template(scale?: number, width?: integer, height?: integer, file_name?: string, template_id: integer|string, include_pages?: integer[], modifications?: object, output_format?: string, response_type?: string) — Render an owned Studio template as an image or PDF URL/base64 result. This consumes render credits and does not publish to social accounts.

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

## Links
Docs: https://mcp.ai/docs/mcps/orshot
Website: https://mcp.ai/mcps/orshot