Connect Claude or Cursor to Cinevva (MCP Server)

Cinevva ships a hosted MCP server that lets Claude, Claude Code, Cursor, or any MCP client build your games. The AI you already use becomes the brain: it reads and edits your games' files directly on our servers, no browser tab needed. Open your game in the Cinevva creator too and the session goes live: the AI can then import assets from our CC0 library, rig and animate 3D models, take screenshots, simulate input to test the running game, and refresh the preview while every change streams onto your screen.

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.

Editing works anywhere. Go live to watch and test.

File editing needs nothing but the connection. The file tools read and write the authoritative copy of your games on our servers, so your assistant can fix a bug or add a feature while no Cinevva tab exists anywhere. Name the game you want (or let the AI pick from your games) and prompt away.

Going live is the upgrade, not the requirement. Open the game at cinevva.com/create, 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 switches to "Agent live" once connected. A live session gives the AI eyes and hands on the running game: screenshots, console logs, simulated input, asset import, and 3D rigging. It also streams every edit onto your screen the moment it lands, whether the edit came through this tab or headless. The live link stays on for future visits until you click "Stop live session".

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. Ask Claude something like "list my Cinevva game files" to confirm the link. For live testing, open your game at cinevva.com/create in another tab and click External agent in the toolbar.

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. It works straight from the terminal with no browser tab open.

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	Needs a live session?
Read the game	list_game_files, read_files, search_game_file	No, reads the server copy of any of your games
Edit the game	edit_files, write_files, delete_files, rename_files	No, edits land server-side and stream to an open tab
Preview	game_ready	Refreshes a live tab's preview, saves headless otherwise
Watch the game	read_console_logs, take_screenshot	Yes
Testing	execute_js, simulate_input, get_task_status	Yes
Assets	search_assets, list_asset_packs, import_asset, search_fonts	Yes. ~7,000 CC0 props, audio, HDRIs
3D rigging	rig_model, apply_animation	Yes, spends credits
Docs	list_library_docs, search_library_docs, read_library_docs, list_animations	Yes

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" only comes from the runtime tools (screenshots, console, input, assets, rigging). It means no browser tab has that game open with the live link on. Open your game, click External agent in the toolbar, and try again. File tools never need this: with no session they work on any of your games by gameId, and list your games if you don't pass one.

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

Questions or problems: [email protected].