MCP Server

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

Add to VS Code

Add to Cursor

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 lets you generate dynamic images, manage templates, and control your Orshot workspace using 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, 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#

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)#

Add 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

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 32 tools across six categories:

Workspace & Auth#

Template Management#

Image Generation#

Library Templates#

Brand Assets#

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

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.

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