MCP Server

Let AI coding assistants generate App Store screenshots directly. FrameFast exposes a remote MCP server that works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools over HTTP. Instead of copy-pasting API keys and writing fetch calls, your AI assistant discovers FrameFast as a tool and calls it natively. You describe what you want in plain English and the assistant handles the rest.

Setup

FrameFast runs as a remote HTTP MCP server. No local installation required. Add the URL to your MCP client configuration.

Claude Code

Add FrameFast to your project .mcp.json:

{
  "mcpServers": {
    "framefast": {
      "type": "url",
      "url": "https://api.framefast.app/mcp"
    }
  }
}

Or add it to your global ~/.claude/settings.json:

{
  "mcpServers": {
    "framefast": {
      "type": "url",
      "url": "https://api.framefast.app/mcp"
    }
  }
}

Cursor / Windsurf

Add the same URL in your editor's MCP settings panel. The server URL is:

https://api.framefast.app/mcp

Tool: generate_screenshot

Generate an App Store screenshot with a device frame, captions, and styling. Returns a PNG image.

Parameters

Parameter	Type	Default	Description
screenshot_url	string	required	Public URL of the raw screenshot image
template	string	dark-gradient	Template ID: dark-gradient, light-clean, colorful, minimal-black, neon
device	string	iphone-16-pro	Device frame: iphone-16-pro, iphone-16, ipad-pro
caption_top	string	—	Main caption text
caption_bottom	string	—	Subtitle text
badge	string	none	Badge overlay: none, new, free, rating, pro
blur_background	boolean	false	Use screenshot as blurred background
width	number	1290	Output width in pixels
height	number	2796	Output height in pixels

Usage in Claude Code

Once configured, ask your assistant to generate a screenshot in natural language. The assistant will discover the generate_screenshot tool and call it automatically.

> Generate an App Store screenshot for my habit tracker app.
  Use the "colorful" template, iPhone 16 Pro frame,
  caption "Track your habits" and subtitle "Simple and beautiful".
  The screenshot is at https://example.com/screen.png

The assistant will call the MCP tool and return the generated PNG inline in the conversation.

Discovery endpoints

The MCP server exposes standard discovery methods:

GET/mcp

Returns server info and available tools.

POST/mcp

Handle tool calls. Supports tools/list and tools/call methods.

Example: tools/call

POST /mcp
Content-Type: application/json

{
  "method": "tools/call",
  "params": {
    "name": "generate_screenshot",
    "arguments": {
      "screenshot_url": "https://example.com/screen.png",
      "template": "dark-gradient",
      "device": "iphone-16-pro",
      "caption_top": "Track your habits",
      "badge": "new"
    }
  }
}

Response

{
  "content": [
    {
      "type": "image",
      "data": "iVBORw0KGgo...",
      "mimeType": "image/png"
    }
  ]
}

← CLI All docs