TryMermaid MCP server

Claude Code

Run in a terminal:

claude mcp add --transport http --scope user trymermaid https://trymermaid.app/mcp \
  --header "Authorization: Bearer tm_live_YOUR_KEY"

Drop --scope user to add it to the current project only.

Xcode does not yet document remote MCP servers for its agents. This uses the same format as Claude Code, which Xcode’s Claude Agent is built on. If it does not load, tell us.

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project, or run “MCP: Open User Configuration” for all projects:

{
  "inputs": [
    { "type": "promptString", "id": "trymermaid-key", "description": "TryMermaid API key", "password": true }
  ],
  "servers": {
    "trymermaid": {
      "type": "http",
      "url": "https://trymermaid.app/mcp",
      "headers": { "Authorization": "Bearer ${input:trymermaid-key}" }
    }
  }
}

VS Code uses the key "servers", not "mcpServers", and asks for your key the first time it connects.

Cursor

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "trymermaid": {
      "url": "https://trymermaid.app/mcp",
      "headers": { "Authorization": "Bearer ${env:TRYMERMAID_API_KEY}" }
    }
  }
}

Set the TRYMERMAID_API_KEY environment variable so the key stays out of the file.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "trymermaid": {
      "serverUrl": "https://trymermaid.app/mcp",
      "headers": { "Authorization": "Bearer ${env:TRYMERMAID_API_KEY}" }
    }
  }
}

Windsurf uses "serverUrl", not "url". Set the TRYMERMAID_API_KEY environment variable.

Google Antigravity

In the agent panel, open the … menu, choose MCP Servers → Manage MCP Servers → View raw config, and add (the file is ~/.gemini/config/mcp_config.json):

{
  "mcpServers": {
    "trymermaid": {
      "serverUrl": "https://trymermaid.app/mcp",
      "headers": { "Authorization": "Bearer tm_live_YOUR_KEY" }
    }
  }
}

Antigravity uses "serverUrl". The same file is shared by the Antigravity IDE and CLI.

Zed

Add to your Zed settings.json:

{
  "context_servers": {
    "trymermaid": {
      "url": "https://trymermaid.app/mcp",
      "headers": { "Authorization": "Bearer tm_live_YOUR_KEY" }
    }
  }
}

Leave out "headers" and Zed signs you in with OAuth instead, with no key needed. You can also use Settings → AI → MCP Servers → Add Remote Server.

JetBrains IDEs (IntelliJ, PyCharm, WebStorm…)

In Settings → Tools → AI Assistant → Model Context Protocol (MCP), add a server as JSON:

{
  "mcpServers": {
    "trymermaid": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://trymermaid.app/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer tm_live_YOUR_KEY" }
    }
  }
}

JetBrains does not document authentication headers for remote servers, so this uses the mcp-remote bridge, which needs Node.js installed.

Xcode (Claude Agent)

Add to ~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/.claude.json:

{
  "mcpServers": {
    "trymermaid": {
      "type": "http",
      "url": "https://trymermaid.app/mcp",
      "headers": { "Authorization": "Bearer tm_live_YOUR_KEY" }
    }
  }
}

Restart Xcode, then type /context in the agent panel to check that TryMermaid loaded.

Xcode (Codex)

Add to ~/Library/Developer/Xcode/CodingAssistant/codex/config.toml:

[mcp_servers.trymermaid]
url = "https://trymermaid.app/mcp"
http_headers = { "Authorization" = "Bearer tm_live_YOUR_KEY" }

The key is written directly because Xcode, as an app, does not see environment variables set in your shell. Restart Xcode after saving.

Xcode does not yet document remote MCP servers for its agents. This uses the standard Codex format. If it does not load, tell us.

Cline

Click the MCP Servers icon in the Cline panel, open Configure → Configure MCP Servers, and add to cline_mcp_settings.json:

{
  "mcpServers": {
    "trymermaid": {
      "type": "streamableHttp",
      "url": "https://trymermaid.app/mcp",
      "headers": { "Authorization": "Bearer tm_live_YOUR_KEY" }
    }
  }
}

Cline needs "type": "streamableHttp" for remote servers.

Gemini CLI

Run in a terminal:

gemini mcp add --transport http --header "Authorization: Bearer tm_live_YOUR_KEY" trymermaid https://trymermaid.app/mcp

Or add "trymermaid": { "httpUrl": "…", "headers": { … } } to ~/.gemini/settings.json. Gemini CLI uses "httpUrl".

OpenAI Codex (CLI and IDE extension)

Run in a terminal:

codex mcp add trymermaid --url https://trymermaid.app/mcp --bearer-token-env TRYMERMAID_API_KEY

Set the TRYMERMAID_API_KEY environment variable before starting Codex. This writes to ~/.codex/config.toml.

Any other MCP client

Use the URL above, or bridge it through a local command:

npx -y mcp-remote https://trymermaid.app/mcp --header "Authorization: Bearer tm_live_YOUR_KEY"

If your client supports remote servers, give it the URL and an Authorization: Bearer header. If it only runs local commands, use this mcp-remote bridge (needs Node.js). Without --header, mcp-remote signs you in with OAuth instead.