ridvay-mcp

MCP (Model Context Protocol) server that lets AI assistants — Claude Code, Claude Desktop, GitHub Copilot (VS Code agent mode), Cursor, and any other MCP client — create and edit Ridvay Studio posters, flyers, and social designs straight from a chat conversation.

Every design comes back as a working share link (ridvay.com/d/…) plus links to open and edit it in the Studio editor.

Tools

Two modes, one server: generate_poster delegates creativity to Ridvay's generation pipeline; create_poster + get_design_guide make your AI client the designer and use Ridvay as a pure save/render/share backend. Client-authored designs may still include prompt image slots — Ridvay renders those server-side after creation.

size accepts 1080x1080 (default), 1080x1920 / story, 1080x1350, 1920x1080, a4, slide, or any WxH.

Related MCP server: Image MCP Server

Get an API key

Sign in and create a key at ridvay.com/user/api-keys. Designs generated through MCP appear in your own My designs.

Quickstart

Claude Code

claude mcp add --scope user ridvay --env RIDVAY_API_KEY=sk-ridvay-… -- npx -y ridvay-mcp

Claude Desktop — add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "ridvay": {
      "command": "npx",
      "args": ["-y", "ridvay-mcp"],
      "env": { "RIDVAY_API_KEY": "sk-ridvay-…" }
    }
  }
}

VS Code / GitHub Copilot agent mode — add to your user mcp.json (Command Palette → "MCP: Open User Configuration"), then enable ridvay in the Copilot Chat tools picker:

{
  "servers": {
    "ridvay": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ridvay-mcp"],
      "env": { "RIDVAY_API_KEY": "sk-ridvay-…" }
    }
  }
}

Then ask your assistant things like:

Generate a story-size poster for our weekend flash sale — 30% off everything, Saturday only.

Environment

Behavior notes

• Sharing: generate_poster / create_poster create an unlisted public share link by default so the chat reply contains a working /d/{id} URL. Pass share: false to keep a design private to your account (only the Studio edit link is returned).

• Deferred images: generation returns as soon as the layout is ready; AI/stock images render server-side in the background (~1 min). check_poster reports on and, if needed, re-triggers that pass.

Development

npm install
npm run build     # emits dist/
npm test          # vitest unit suite
node dist/index.js  # run the stdio server directly (needs RIDVAY_API_KEY)

MIT © Ridvay