MCP Server

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

Add to VS Code

Add to Cursor

Introduction#

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, and any other MCP-compatible client.

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

Video Tutorial#

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

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.

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 31 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.

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