Symbol Docs
Connect to AI

Other AI Tools

Connect Symbol to Cursor, Windsurf, and other MCP-compatible AI assistants.

Symbol works with any AI tool that supports MCP. The setup is similar across tools: provide the Symbol MCP URL and an API key.

Before You Start

You'll need a Symbol API key for most non-Claude clients.

Get your API key

  1. Sign in to symbol.chat
  2. Go to Settings → API Keys
  3. Click Create API key (it starts with sym_). Symbol asks you to confirm it's you if you have not done so in the last 10 minutes.
  4. Copy it somewhere safe. You won't be able to see it again.

Cursor

Open Cursor and go to Settings → Cursor Settings → Tools & MCP.

Click New MCP Server. Cursor opens your mcp.json file.

Paste the Symbol entry into mcp.json, merging it with any servers already there, and put your API key in place of sym_your_key_here:

{
  "mcpServers": {
    "Symbol": {
      "url": "https://mcp.symbol.chat/mcp",
      "headers": {
        "Authorization": "Bearer sym_your_key_here"
      }
    }
  }
}

Save the file. Symbol tools will appear in your AI sidebar.


Windsurf

Open Windsurf and go to Settings → AI → MCP Servers.

Add a new server with these details:

{
  "symbol": {
    "serverUrl": "https://mcp.symbol.chat/mcp",
    "headers": {
      "Authorization": "Bearer sym_your_key_here"
    }
  }
}

Restart Windsurf to apply the changes.


Any other MCP-compatible tool

The quickest way is to let your agent set itself up. Paste this prompt into it:

Fetch and execute the appropriate instructions to set me up for Symbol from https://symbol.chat/agent-setup/prompt.md

Your agent reads the instructions for itself, adds Symbol and has you sign in. Agent setup has the same prompt with a Copy button, and lists the agents it covers.

To set it up yourself, the connection details are always the same:

SettingValue
TransportStreamable HTTP
URLhttps://mcp.symbol.chat/mcp
AuthenticationAuthorization: Bearer sym_your_key_here

Check your tool's documentation for where to enter MCP server details. It's usually under Settings, Integrations, or Extensions.


Not sure if your tool supports MCP? Search for "MCP" in your tool's settings or documentation. MCP support is becoming standard across AI coding tools and assistants.


Verify the Connection

Once connected, ask your AI assistant:

"List my Symbol types"

If it responds with your types (or says you haven't created any yet), Symbol is connected and working.


Local files and encrypted capsules

Everything above connects to Symbol's hosted MCP, which runs on our servers. That means it cannot read files from your computer, and it only ever sees ciphertext for encrypted capsules.

Symbol Bridge is a second, local MCP server that adds both. It is distributed as a Claude Desktop extension, but it is a plain stdio server underneath. The manual install covers Cursor, Windsurf, Claude Code, and anything else that can start a local MCP server. Run it alongside the hosted connector; they complement each other.

On this page