MCP Server

MCP Server URL: https://mcp.orshot.com/mcp

Add to VS Code

Add to Cursor

Install in ChatGPT

Introduction#

Every template also has an MCP tab in its Automate panel — it gives you the server config and a ready prompt to render that specific template from Claude, Cursor, VS Code, Codex, or ChatGPT.

The Orshot MCP Server gives an AI agent 66 tools across the whole loop: design a template from a brief, render images, PDFs and videos from your data, keep assets on brand and organised in folders, mint signed URLs for OG images and embeds, and build workflows that keep running on a schedule. All in natural language, directly inside AI tools like Cursor, VS Code (GitHub Copilot), Claude Desktop, Claude Code, Windsurf, ChatGPT, Codex, Cline, LM Studio, Zed, Goose, Antigravity, OpenCode, Hermes, and any other MCP-compatible client.

No API keys needed. Authentication is handled automatically via OAuth — just connect and approve access through your browser.

Connect + Generate Templates#

Setup#

Connect to the hosted Orshot MCP server. Authentication happens automatically via OAuth when you first use a tool.

Cursor#

1. Open Settings → General → MCP Servers
2. Click + Add new MCP server
3. Select Type: URL
4. Enter URL: https://mcp.orshot.com/mcp
5. Click Add
6. When prompted, complete OAuth authorization in your browser

Or add manually to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "orshot": {
      "url": "https://mcp.orshot.com/mcp"
    }
  }
}

VS Code (GitHub Copilot)#

Add to your .vscode/mcp.json (workspace) or global settings:

{
  "servers": {
    "orshot": {
      "url": "https://mcp.orshot.com/mcp"
    }
  }
}

Or use the Command Palette:

1. Press Cmd+Shift+P (macOS) / Ctrl+Shift+P (Windows/Linux)
2. Run MCP: Add Server
3. Select HTTP
4. Enter URL: https://mcp.orshot.com/mcp
5. Name it Orshot

Claude Desktop#

Add to your Claude Desktop MCP configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "orshot": {
      "url": "https://mcp.orshot.com/mcp"
    }
  }
}

Restart Claude Desktop after saving.

Claude.ai (Web)#

1. Go to claude.ai → Settings → Integrations
2. Click Add Integration
3. Enter URL: https://mcp.orshot.com/mcp
4. Complete OAuth authorization when prompted

Claude Code#

claude mcp add orshot --transport http https://mcp.orshot.com/mcp

Windsurf#

1. Click the MCP icon in the Cascade panel (top right)
2. Click Manage plugins → View raw config
3. Add the Orshot configuration and save

Config file location: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "orshot": {
      "serverUrl": "https://mcp.orshot.com/mcp"
    }
  }
}

ChatGPT#

The fastest way: Orshot is in the ChatGPT plugin directory. Open the Orshot plugin listing and click Install plugin.

Or add it manually as a connector:

1. Go to chatgpt.com → Settings → Connections
2. Click Add Connection
3. Enter URL: https://mcp.orshot.com/mcp
4. Complete OAuth authorization when prompted

Codex (OpenAI CLI)#

The fastest way: ChatGPT and Codex share one plugin directory, so you can install the Orshot plugin in Codex in one click, or run /plugins in Codex, search for Orshot, and select Install plugin.

Or add the MCP server to ~/.codex/config.json:

{
  "mcpServers": {
    "orshot": {
      "url": "https://mcp.orshot.com/mcp"
    }
  }
}

Or add via CLI:

codex mcp add orshot --url https://mcp.orshot.com/mcp

Cline#

1. Open Cline settings in VS Code
2. Go to MCP Servers section
3. Click Add Server
4. Enter:
   • Name: orshot
   • URL: https://mcp.orshot.com/mcp
5. Click Save

LM Studio#

1. Open Settings → MCP
2. Add a new MCP server with this configuration:

{
  "orshot": {
    "url": "https://mcp.orshot.com/mcp"
  }
}

Zed#

Add to your Zed settings (~/.config/zed/settings.json):

{
  "context_servers": {
    "orshot": {
      "url": "https://mcp.orshot.com/mcp"
    }
  }
}

Goose#

goose mcp add orshot --transport http https://mcp.orshot.com/mcp

Or add to ~/.config/goose/config.yaml:

extensions:
  orshot:
    type: http
    url: https://mcp.orshot.com/mcp

Antigravity#

1. Open Antigravity and go to Settings → MCP Servers
2. Add a new server with URL: https://mcp.orshot.com/mcp
3. Complete OAuth authorization when prompted

OpenCode#

opencode mcp add orshot --url https://mcp.orshot.com/mcp

Or add it to the mcp block of your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orshot": {
      "type": "remote",
      "url": "https://mcp.orshot.com/mcp",
      "enabled": true
    }
  }
}

OpenCode detects the auth challenge and registers itself over dynamic client registration, so there is no client ID to paste — it just opens your browser. Re-authenticate with opencode mcp auth orshot, or diagnose a bad connection with opencode mcp debug orshot.

Hermes#

hermes mcp add orshot --url https://mcp.orshot.com/mcp --auth oauth

Or add it to ~/.hermes/config.yaml by hand:

mcp_servers:
  orshot:
    url: "https://mcp.orshot.com/mcp"
    auth: oauth

auth: oauth is all Hermes needs — it handles discovery, dynamic client registration, PKCE and token refresh itself.

If you edited the YAML by hand, authenticate from a fresh terminal:

hermes mcp login orshot

Run it outside a running session: editing the config from inside one triggers a reload that times out after 30 seconds, which is not long enough to finish the browser flow.

Other MCP Clients#

Any client that supports remote MCP servers can connect using:

URL: https://mcp.orshot.com/mcp

Look for "Remote MCP", "HTTP", or "Streamable HTTP" in your client's MCP settings and enter the URL above.

For example, you can ask it to generate a tweet screenshot from a Tweet URL, update the copy, and render the final image without leaving your AI client.

Authentication#

The MCP server uses OAuth to securely connect to your Orshot account. No API keys to copy or manage.

How It Works#

1. Connect — Add the MCP server URL to your client
2. Authorize — When you first use an Orshot tool, your browser opens to the Orshot login page
3. Select workspaces — Choose which workspace(s) the MCP server can access
4. Done — Your client receives an OAuth token and all subsequent tool calls are authenticated

Token Details#

• Access tokens are short-lived (15 minutes) and automatically refreshed
• If your session expires, you'll be prompted to re-authorize
• You can revoke access anytime from your Orshot dashboard
• Each user's data is completely isolated — the server never stores tokens

Available Tools#

The MCP server provides 66 tools across ten categories:

Workspace & Auth#

Template Management#

Template Folders#

One flat level of folders per workspace, shared with the dashboard sidebar. Names are unique and capped at 50 characters. Creating a folder requires a paid plan; listing, renaming, deleting and filing are available on every plan that already has folders. Deleting a folder never deletes templates — they return to All templates.

Image Generation#

Dynamic URLs#

Public, signed render links for a template. Unlike a one-off render, a dynamic URL is stable and cacheable — the right fit for Open Graph images, email images and embeds. Pass modification values as query parameters to vary the output from one URL.

Library Templates#

Brand Assets#

Manage your workspace brand kit — images, colors, fonts, and videos used across templates.

Workflows#

Build and run the automations that render on their own — a trigger, an Orshot render, and one or more destinations.

Social Publishing#

Use orshot_list_social_accounts to get the numeric account IDs, then pass them in the publish parameter of orshot_generate_image to post renders directly to connected social accounts.

Activity#

Example Prompts#

Once connected, try natural language prompts like:

Image Generation:

• "Generate a website screenshot of github.com using Orshot"
• "Create an ad banner with heading 'Grow your business' using studio template 64"
• "Generate a tweet screenshot of this tweet https://x.com/example/status/123"
• "Render my certificate template with the name 'Jane Doe'"
• "Generate a PNG and a PDF of template 100 with my updated headline"

Template Management:

• "List all my studio templates"
• "Show me the details of template 222"
• "What modification parameters does template 150 accept?"
• "Create a new social media template at 1080x1080 with my brand colors"
• "Update template 100 with a new background color"
• "Duplicate template 200 so I can create a variant"
• "Delete template 300"

Brand Assets:

• "Show me all my brand assets"
• "What brand colors do I have tagged as 'primary'?"
• "Upload this logo image to my brand kit with tags 'logo' and 'dark'"
• "Add a new brand color #FF5733 tagged as 'accent'"
• "Create a social media post template using my brand fonts and colors"
• "Design a YouTube thumbnail using my brand images tagged 'product'"

Workspace:

• "Which workspaces do I have access to?"
• "Switch to my marketing workspace"

Need Help?#

• Check the Orshot API documentation
• Contact support at hi@orshot.com
• Use the chat button in your Orshot dashboard