Give Claude & Copilot the power to design
The Ridvay MCP server connects your AI assistant to Ridvay Studio. Ask for a poster, flyer or social post in chat — get back a finished, editable design with working share links. Your assistant can even compose the design itself; Ridvay stores, renders and shares it.
Three steps to poster powers
2. Add the server
Add mcp.ridvay.com as a connector by URL, or run it locally via npx with one command in Claude Code / a short JSON snippet in Claude Desktop or VS Code.
3. Ask for a design
"Make a story-size poster for our weekend sale." Links to view, share and edit come back in chat.
Hosted endpoint — no install
The same server runs at mcp.ridvay.com. Add it to claude.ai, ChatGPT, Cursor or Claude Code with a URL, or with a header where your client supports one.
By signing in (claude.ai, ChatGPT, Claude Code, Cursor)
Add https://mcp.ridvay.com/mcp as a connector with no key. The client sends you to ridvay.com to approve the connection (OAuth) and then holds a key named “Claude (OAuth)” in your account — delete it on your API keys page to disconnect.
By URL (claude.ai custom connectors, ChatGPT connectors)
Paste this URL with your own key as the connector address:
https://mcp.ridvay.com/mcp/sk-ridvay-...The URL contains your key — treat it like a password. Revoke it any time on your API keys page.
By header (Claude Code, Cursor, most desktop clients)
Point the client at https://mcp.ridvay.com/mcp and send your key as a Bearer token:
claude mcp add --transport http ridvay https://mcp.ridvay.com/mcp --header "Authorization: Bearer sk-ridvay-..."Quickstart
Claude Code
claude mcp add ridvay --env RIDVAY_API_KEY=sk-ridvay-... -- npx -y ridvay-mcpClaude Desktop — claude_desktop_config.json
{
"mcpServers": {
"ridvay": {
"command": "npx",
"args": ["-y", "ridvay-mcp"],
"env": { "RIDVAY_API_KEY": "sk-ridvay-..." }
}
}
}GitHub Copilot (VS Code) — user mcp.json
{
"servers": {
"ridvay": {
"type": "stdio",
"command": "npx",
"args": ["-y", "ridvay-mcp"],
"env": { "RIDVAY_API_KEY": "sk-ridvay-..." }
}
}
}Then enable ridvay in the Copilot Chat tools picker.
The tools your assistant gets
Your assistant is the designer; Ridvay is the save, render and share backend.
Returns the design-authoring guide so your assistant can compose designs itself.
Saves a design your assistant composed — full creative control, fast, no generation credits.
Fallback: Ridvay’s AI designs from a text brief (uses your account’s generation credits). Pass brand_id to design on a specific brand kit.
Turns a poster photo, screenshot or old export into an editable design — live text in matching fonts.
Natural-language edits to an existing design: "make the headline red", "add opening hours".
Reports when a design’s AI images finish rendering and returns its links.
Renders the design to a downloadable PNG or JPEG at its native pixel size, up to 4× scale.
Turns a static design into an animated one — entrances, page transitions and morphing between pages.
Renders the animation timeline to a downloadable H.264 MP4 — takes minutes, so it returns a job ID.
Polls an export job from export_poster or export_video and returns the download URL when done.
Lists the account’s designs with their IDs — find the one to refine, export, share or update.
Shares a design and returns its view, edit, live-image and full-screen “screen” links for TVs and tablets.
Reads a living design’s variables ({{price}}, {{stock}}…) with defaults and current values.
Updates those variables from any workflow — the shared page, live image and screen refresh within a minute.
Lists the account’s brand kits so generate_poster can design on a specific brand.
Frequently asked questions
What is the Ridvay MCP server?
It is a Model Context Protocol (MCP) server that connects AI assistants — Claude, GitHub Copilot, Cursor and others — to Ridvay Studio. Once added, you can ask your assistant to create a poster, flyer or social post and get back working view, share and edit links.
Which AI assistants work with it?
Any MCP-capable client: Claude Code, Claude Desktop, GitHub Copilot agent mode in VS Code, Cursor, and more. Setup is one command or a short JSON snippet.
Do I need a Ridvay account?
Yes — designs are saved to your Ridvay account. Sign in at ridvay.com, open your account page and create an API key; the key goes into your assistant’s MCP configuration.
Can my assistant design the poster itself?
Yes — that is the preferred mode. The server ships a design guide your assistant reads, then it composes the full design (layout, colors, fonts, copy) and Ridvay stores, renders and shares it. There is also a fallback tool where Ridvay’s own AI generates the design from a text brief.
Do I have to install anything?
No. The hosted endpoint at mcp.ridvay.com works from claude.ai, ChatGPT, Cursor and Claude Code with just a URL or a header. If you prefer to keep the key on your machine, the same server runs locally via npx.
Can an agent keep a design up to date?
Yes. A design can declare variables such as {{price}}; the set_values tool changes them from any workflow, and the shared page, the live-image PNG and the full-screen /screen view refresh within a minute — a menu board or price board that an agent maintains.
Is it open source?
Yes. The server is MIT-licensed at github.com/tom-tgr/ridvay-mcp. The hosted endpoint runs the same code; running it locally via npx keeps your API key on your machine.
Where do the designs end up?
In your Ridvay account, like any other design: they appear in My designs, are editable in Ridvay Studio, and each one gets an unlisted share link you can send to anyone (or keep private).
Design without leaving the conversation
Create your API key, add one line of config, and your assistant can ship posters.
Get started free