Generate social images with a single tool call. The SnapOG MCP server gives any AI assistant direct access to all 10 templates — no API docs to read, no fetch logic to write.
The Model Context Protocol is an open standard that lets AI assistants use external tools directly. Instead of reading API docs and writing HTTP requests, your AI calls generate_image and gets a PNG back instantly.
Add the MCP server to your AI tool
“Generate an OG image for my blog post”
PNG saved to disk + inline preview
Choose your AI client and follow the setup instructions. The server communicates over stdio and requires Node.js 20+.
claude mcp add snapog -- npx tsx /path/to/packages/mcp/src/index.ts
With an API key for authenticated endpoints:
claude mcp add snapog \ -e SNAPOG_API_KEY=sk_live_xxxxx \ -- npx tsx /path/to/packages/mcp/src/index.ts
Add to your claude_desktop_config.json:
{
"mcpServers": {
"snapog": {
"command": "npx",
"args": ["tsx", "/path/to/packages/mcp/src/index.ts"],
"env": {
"SNAPOG_API_URL": "https://api.snapog.dev",
"SNAPOG_API_KEY": "sk_live_xxxxx"
}
}
}
}Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"snapog": {
"command": "npx",
"args": ["tsx", "/path/to/packages/mcp/src/index.ts"],
"env": {
"SNAPOG_API_URL": "https://api.snapog.dev",
"SNAPOG_API_KEY": "sk_live_xxxxx"
}
}
}
}Add to .vscode/mcp.json:
{
"servers": {
"snapog": {
"command": "npx",
"args": ["tsx", "/path/to/packages/mcp/src/index.ts"],
"env": {
"SNAPOG_API_URL": "https://api.snapog.dev",
"SNAPOG_API_KEY": "sk_live_xxxxx"
}
}
}
}Add to your Windsurf MCP configuration:
{
"mcpServers": {
"snapog": {
"command": "npx",
"args": ["tsx", "/path/to/packages/mcp/src/index.ts"],
"env": {
"SNAPOG_API_URL": "https://api.snapog.dev",
"SNAPOG_API_KEY": "sk_live_xxxxx"
}
}
}
}The SnapOG MCP server exposes 5 tools. Your AI assistant can discover these automatically — just ask it to generate an image and it will figure out the right tool and parameters.
list_templatesList all available SnapOG image templates with their parameters and defaults. Call this first to discover which templates and parameters are available.
get_templateGet detailed info about a specific template including all parameter definitions and default values.
template_idstringrequiredTemplate identifier, e.g. "blog-post"generate_imageAuthGenerate a social image using a SnapOG template. Returns the image as a file saved to disk plus an inline preview.
templatestringrequiredTemplate ID, e.g. "blog-post", "github-repo"paramsobjectrequiredTemplate parameters as key-value pairswidthnumberImage width in pixels (default: 1200)heightnumberImage height in pixels (default: 630)format"png" | "svg"Output format (default: png)get_image_urlAuthGet a direct URL for a SnapOG image that can be used in HTML meta tags, markdown, or anywhere an image URL is needed.
templatestringrequiredTemplate IDparamsobjectrequiredTemplate parameters as key-value pairspreview_templateGenerate a quick preview of a template with its default parameters. No API key needed.
template_idstringrequiredTemplate ID to previewMCP resources provide context to the AI without requiring a tool call. These are automatically available when the server is connected.
snapog://docsComplete API documentation as markdown — every endpoint, every template, code examples in Node.js, Python, and Next.js.
snapog://templatesAll 10 templates with full parameter schemas, types, defaults, and descriptions.
Once connected, just describe what you need in natural language. Your AI assistant will choose the right template and parameters automatically.
| Variable | Default | Description |
|---|---|---|
SNAPOG_API_URL | https://api.snapog.dev | SnapOG API base URL |
SNAPOG_API_KEY | — | API key for authenticated endpoints (generate_image, get_image_url) |
Without an API key, you can still use list_templates, get_template, and preview_template.
The MCP server wraps the same REST API. See the full API documentation for endpoints, code examples, and more. You can also point any AI assistant to https://api.snapog.dev/v1/docs for the complete API as markdown.