MCP Setup

Get Converra connected to your AI assistant in under a minute.

Get Your API Key

1. Go to converra.ai/settings
2. Click Create API Key
3. Copy the key (starts with sk_)

Claude Code

One command:

claude mcp add converra https://converra.ai/api/mcp --header "Authorization: Bearer sk_your_key_here"

Verify it works:

claude mcp list
# Should show: converra - https://converra.ai/api/mcp

Test it:

You: List my Converra prompts
AI: [Uses list_prompts tool and shows results]

Cursor

Create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "converra": {
      "url": "https://converra.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_key_here"
      }
    }
  }
}

Restart Cursor, then test:

You: List my Converra prompts

Claude Desktop

Edit your config file:

OS	Location
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/claude/claude_desktop_config.json

Add Converra:

{
  "mcpServers": {
    "converra": {
      "url": "https://converra.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_key_here"
      }
    }
  }
}

Restart Claude Desktop to apply.

Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "converra": {
      "serverType": "sse",
      "url": "https://converra.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_key_here"
      }
    }
  }
}

AntiGravity (Gemini)

Google's AntiGravity IDE supports MCP. Edit ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "converra": {
      "url": "https://converra.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_key_here"
      }
    }
  }
}

Or use the MCP Store in AntiGravity:

1. Click the ... menu in the Agent pane
2. Select MCP Servers
3. Click Manage MCP Servers > View raw config
4. Add the Converra configuration

Verify Connection

After setup, test with any of these:

"List my prompts"
"Show my Converra account info"
"What optimization tools do I have?"

Your AI should use the Converra MCP tools to respond.

Troubleshooting

"Unauthorized" or "Invalid API key"

• Double-check your API key is correct
• Make sure there are no extra spaces
• Verify the key is active at converra.ai/settings

"Server not responding"

• Check your internet connection
• Verify the URL is exactly https://converra.ai/api/mcp
• Remove and re-add the server

Tools not appearing

• Restart your AI assistant after config changes
• Check for JSON syntax errors (missing commas, brackets)
• Run claude mcp list to verify the server is registered

"Unknown tool" errors

• The AI may need a hint: "Use the Converra MCP tools"
• Try being specific: "Use list_prompts to show my prompts"

What's Next?

Once connected, try these workflows:

Create your first prompt:

"Create a prompt called 'Sales Assistant' for gpt-4o with content:
You are a helpful sales assistant..."

Optimize an existing prompt:

"Optimize my Sales Assistant prompt with 3 variants focused on improving clarity"

Check results:

"Show me the optimization results and apply the winner"

See Available Tools for the complete tool reference.