Connect Claude or Cursor to Cinevva (MCP Server)

Cinevva ships a hosted MCP server that lets Claude, Claude Code, Cursor, or any MCP client drive your Game Creator session. The AI you already use becomes the brain: it reads your game's files, edits them, imports assets from our CC0 library, rigs and animates 3D models, takes screenshots, and refreshes the preview you're watching. You keep the Cinevva tab open, and every change lands in the real game in front of you.

What you need

A Cinevva account (free works, 3D rigging spends credits from your balance) and an MCP client that supports remote servers with OAuth. The server URL is:

https://api.cinevva.com/create/mcp

It speaks Streamable HTTP and authenticates with OAuth 2.0. When you connect, your client opens a Cinevva login page in the browser. Approve it once and the client stays connected.

The one rule: open your game and turn on sharing

The MCP server edits a live session, not a copy on our servers. Tools only work while you have a game open at cinevva.com/create in a browser tab. Open the game you want to work on, wait for the preview to load, then click External agent in the creator toolbar (the plug icon, also in the "more" menu on small screens). The panel shows the server URL and switches to "MCP Server (live)" once the session is shared. Sharing stays on for future visits until you click "Stop sharing".

With that done, start prompting your assistant. If you see errors like "no live session", the game tab is missing or asleep, or sharing is off. The list_live_sessions tool shows what's connected, and when exactly one game is open it's targeted automatically.

Setup in Claude (claude.ai and desktop)

1. Open Settings, then Connectors, and choose "Add custom connector".
2. Name it Cinevva and paste https://api.cinevva.com/create/mcp as the URL. Watch for stray characters, the URL must end in /create/mcp.
3. Click Add, then Connect. Log in with your Cinevva account when the authorization page opens (the same account your game tab is logged into).
4. Open your game at cinevva.com/create in another tab, click External agent in the toolbar, then ask Claude something like "list my live Cinevva sessions" to confirm the link.

Setup in Claude Code

claude mcp add --transport http cinevva https://api.cinevva.com/create/mcp

Claude Code prompts you through the OAuth login on first use. After that, ask it to read your game files or make a change, with your game open in the browser.

Setup in Cursor

Add this to .cursor/mcp.json (per project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "cinevva": {
      "url": "https://api.cinevva.com/create/mcp"
    }
  }
}

Cursor detects the server, runs the OAuth flow in your browser, and lists the tools in its MCP settings.

What the tools do

Group	Tools	Notes
Read the game	list_game_files, read_files, search_game_file, read_console_logs, take_screenshot	Read-only, safe to call anytime
Edit the game	edit_files, write_files, delete_files, rename_files	Change the live game's source
Preview	game_ready	Refreshes the preview you're watching
Assets	search_assets, list_asset_packs, import_asset, search_fonts	~7,000 CC0 props, audio, HDRIs
3D rigging	rig_model, apply_animation	Rig models for animation, spends credits
Testing	execute_js, simulate_input, get_task_status	Probe and play the running game
Docs	list_library_docs, search_library_docs, read_library_docs, list_animations	Reference material for the client

Rigging costs the same credits as the in-app Game Creator. Everything else is free. The in-app creator also generates images, music, sound effects, and skyboxes with AI; those tools live in the Cinevva app itself and aren't part of the MCP connector.

Troubleshooting

"No MCP server was found at the provided URL" during setup usually means the URL has a typo or an extra character on the end. It must be exactly https://api.cinevva.com/create/mcp.

"No live session" from the tools means no browser tab has a game open at cinevva.com/create with sharing enabled. Open your game, click External agent in the toolbar, and try again.

If tools stall on a fresh connection, refresh the game tab so it reconnects, then call list_live_sessions.

Questions or problems: [email protected].