The Orshot MCP Server enables dynamic image, PDF, and video generation from templates through Claude, Cursor, or any MCP-compatible application.
Capabilities:
Template Discovery: List available library and studio templates, retrieve modifiable parameters and data fields for any template, and reference templates by ID or name.
Media Generation: Generate images, PDFs, and videos from library or studio templates with automatic template type detection and support for multiple formats (PNG, JPG, PDF, MP4, WebM, GIF).
Dynamic Customization: Provide text replacements, color changes, and variable data, with automatic URL-to-image mapping for studio templates.
Flexible Output: Choose from multiple response types (URL, base64, binary) and configure webhooks for asynchronous rendering notifications.
API Management: Validate API connectivity and check API key status.
Documentation Access: Fetch Orshot documentation and list available topics directly within the MCP environment.
Deployment Options: Connect to a hosted server or run locally for development and customization.
Enables generating website screenshots of GitHub pages through the Orshot API
Mentioned as a potential environment for running the MCP server, which may require specific node path configuration
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Orshotgenerate a website screenshot of orshot.com using the 'Website Mockup' template"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Orshot MCP Server
Orshot is an Image, PDF and Video Generation API which lets you generate dynamic images from pre-designed and AI generated templates via API and Integrations
Orshot's MCP Server lets you dynamically generate images from your templates from your prompts in Claude, Cursor or any app that supports MCP Servers
How to Use
Video Demo
https://github.com/user-attachments/assets/1b9641ba-41cd-4f0b-9538-c71171c29e24
Quick Connect (Remote)
The easiest way to use the Orshot MCP Server is to connect to our hosted remote server.
Server URL: https://mcp.orshot.com/sse
Since the remote server is shared, you must provide your Orshot API Key in your prompt (e.g., "Generate a website screenshot of apple.com. Here is my API key: os-...") or configure your MCP client to send it.
Cursor (Agent Mode)
Settings > General > MCP Servers
Add new MCP server
Select SSE and enter
https://mcp.orshot.com/sse
VS Code (MCP Extension)
Add to .vscode/mcp.json or your global configuration:
Local Installation (Advanced)
For developers who want to run the server locally or contribute.
Clone and Build:
git clone https://github.com/rishimohan/orshot-mcp-server cd orshot-mcp-server npm install && npm run buildConfigure Claude Desktop: Add to
claude_desktop_config.json:{ "mcpServers": { "orshot": { "command": "node", "args": ["/absolute/path/to/orshot-mcp-server/build/index.js"], "env": { "ORSHOT_API_KEY": "your-api-key" } } } }
Related MCP server: Image Generator MCP Server
Examples
Here are some example prompts you can use with Orshot's MCP Server
generate a mockup using studio template id 64 with this image https://example.com/logo.png
generate a website screenshot of github.com using orshot
generate image using orshot from "Ad banner" studio template with heading "Grow your business" and subheading "Get your ebook now"
list all studio templates in orshot
generate this tweet's screenshot using orshot https://x.com/TheCatsX/status/1941620988279652599
Features
This MCP server exposes nine tools for working with Orshot:
Template Discovery
Get Library Templates - List all available library templates for your account
Get Studio Templates - List all available studio templates for your account
Get Template Modifications - Get available parameters/modifications for any template
Image & Media Generation
Generate Image - Unified tool with automatic template detection (recommended). Supports Images (PNG, JPG, WEBP), PDFs, and Videos (MP4, WEBM, GIF).
Generate Image From Library Template - Generate images from Orshot library templates
Generate Image From Studio Template - Generate images, PDFs or videos from Orshot Studio templates
Documentation & Help
Get Orshot Docs - Fetch the latest documentation directly from Orshot
List Docs Topics - List available documentation topics
Utilities
Check API Status - Test API connectivity and validate your API key
New Capabilities
Video Generation: Create MP4, WebM, or GIF videos from Studio templates.
PDF Generation: Generate multi-page PDFs with custom DPI and margins.
Documentation Integration: Ask the agent to look up Orshot documentation for you.
Local Development
Getting Help
If you experience any issues:
Check the Orshot API documentation
Verify your account status at Orshot Dashboard
Contact Orshot support at hi@orshot.com if API issues persist
Development
License
ISC