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, 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. Enter URL: https://mcp.orshot.com/mcp
4. When prompted, complete OAuth authorization in your browser

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:

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

Claude Code

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

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "orshot": {
      "serverUrl": "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 9 tools for managing templates and generating images:

Workspace & Auth

Template Management

Image Generation

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'"

Template Management:

• "List all my studio templates"
• "Show me the details of template 222"
• "Create a new social media template at 1080x1080"
• "Update template 100 with a new background color"

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