VS Code and Cursor

Connect your editor's AI agent to Cinara's MCP server. It can then make voice-overs, sound effects, music and images for your project while you work.

You need a Cinara API key. Create one on the API Keys page. See Before you start.

VS Code

Cinara works with GitHub Copilot Chat in agent mode.

Add Cinara to a project

Create .vscode/mcp.json in your project:

json

{
  "servers": {
    "cinara": {
      "type": "http",
      "url": "https://api.cinara.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:cinara-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "cinara-api-key",
      "description": "Cinara API key",
      "password": true
    }
  ]
}

Choose Start above the "cinara" entry in the file. Or open the Command Palette, run MCP: List Servers, pick cinara and start it.
When VS Code asks for the Cinara API key, paste your key. VS Code stores it securely and doesn't write it into the file, so .vscode/mcp.json is safe to commit.
Open Chat, switch to Agent mode, and choose the tools button to check that Cinara's tools are turned on.

Use Cinara in every project

Open the Command Palette, run MCP: Open User Configuration, and add the same servers and inputs entries.

Cursor

Open ~/.cursor/mcp.json to use Cinara in every project (create the file if it doesn't exist). For one project only, use .cursor/mcp.json in that project instead.

Add Cinara under mcpServers:

json

{
  "mcpServers": {
    "cinara": {
      "url": "https://api.cinara.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer cin_..."
      }
    }
  }
}

Replace cin_... with your key.
Open Cursor Settings and find the MCP section. Check that cinara is turned on and shows its tools.
Ask for something in the Agent chat.

Don't commit your key

~/.cursor/mcp.json stays on your computer. If you use a project .cursor/mcp.json, add it to .gitignore, or read the key from your environment with "Authorization": "Bearer ${env:CINARA_API_KEY}".

Other MCP clients

Any client that connects to remote MCP servers over Streamable HTTP with custom headers can use Cinara:

URL: https://api.cinara.ai/v1/mcp
Header: Authorization: Bearer <your Cinara API key>

Clients that only start local servers can use mcp-remote, as in the Claude Desktop setup.

Try it

"Make a 2-second soft UI click sound and save it to assets/sounds/click.mp3."
"Read the text in docs/intro.md in the Haven voice and save the audio to public/audio/intro.mp3."
"Create a 16:9 hero image of a sunrise over mountains for the landing page."
"Write a 45-second ambient instrumental for the app's loading screen."

To save a file into your project, the agent downloads it from the link Cinara returns. Cinara can't take files from your project: uploads aren't available through the MCP server, so the agent passes text, not files.

Songs and videos can take a few minutes. If one isn't ready after about 40 seconds, the agent gets its id and can check it later with get_generation.
See what the MCP server can do for the full tool list.
Credits come from your workspace's balance, at the same rates as the app.
Results are listed in History under the key's name, and files appear in Drive.
File links expire after 6 hours. Ask the agent for a fresh link, or find the file in Drive.

For error messages, see Troubleshooting.

VS Code and Cursor ​

VS Code ​

Add Cinara to a project ​

Use Cinara in every project ​

Cursor ​

Other MCP clients ​

Try it ​

Related ​