Orshot MCP Server

🚀 Orshot MCP Server

Orshot is an Image Generation API that enables dynamic image generation from pre - designed and AI - generated templates through API and integrations. Orshot's MCP Server allows you to generate images from templates based on prompts in apps like Claude, Cursor, or any app supporting MCP Servers.

🚀 Quick Start

✨ Features

This MCP server exposes seven tools for working with Orshot:

Template Discovery

1. Get Library Templates - List all available library templates for your account
2. Get Studio Templates - List all available studio templates for your account

Image Generation

4. Generate Image - Unified tool with automatic template detection (recommended)
5. Generate Image From Library Template - Generate images from Orshot library templates
6. Generate Image From Studio Template - Generate images from Orshot Studio templates

Specialized Tools

7. Check API Status - Test API connectivity and validate your API key

📦 Installation

Local Development

# 1. Install and build
npm install && npm run build

# 2. Configure (required)
export ORSHOT_API_KEY="your-api-key-here"

# 3. Run production server
npm start

💻 Usage Examples

Basic Usage

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

📚 Documentation

How to Use

Get your API Key

• You can signup on Orshot to get your free API key

Claude Desktop Integration

Add the server to your Claude Desktop configuration in claude_desktop_config.json:

{
  "mcpServers": {
    "orshot": {
      "command": "node", // or output of "which node"
      "args": ["/path/to/orshot-mcp-server/build/index.js"], // update the path
      "env": { "ORSHOT_API_KEY": "your-api-key" } // add Orshot API Key
    }
  }
}

⚠️ Important Note

Sometimes the path for node is different if you use libraries like nvm, just run "which node" and paste the output as the value for "command"

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

Getting Help

If you experience any issues:

1. Check the Orshot API documentation
2. Verify your account status at Orshot Dashboard
3. Contact Orshot support at hi@orshot.com if API issues persist

📄 License

ISC