BrainGrid

Installing BrainGrid MCP

Step-by-step guide to install BrainGrid MCP

Add BrainGrid to your Claude Code configuration:

claude mcp add --transport http braingrid https://mcp.braingrid.ai/mcp

Then restart your Claude Code session. You'll see that the BrainGrid MCP is available but needs authentication.

BrainGrid MCP in Claude Code

Enter /mcp to manage your MCP servers:

/mcp

Then you'll see "BrainGrid disconnected - enter to login"

Manage MCP servers

Hit "Enter", this will open a browser window to login to BrainGrid. Once you log in, you can approve the BrainGrid MCP to connect to your account.

Login to BrainGrid

Once the authentication is complete, you'll see "Authentication successful. Connected to BrainGrid." and you can start using the BrainGrid MCP.

BrainGrid MCP connected

You can now use the BrainGrid MCP to create requirements and tasks.

To install the BrainGrid MCP server in Codex:

  1. Install mcp-remote globally

    npm install -g mcp-remote
  2. Open the Codex configuration file

    • Open ~/.codex/config.toml in your preferred text editor
  3. Add the BrainGrid MCP configuration

    • Add the following configuration:
[mcp_servers.braingrid]
command = "npx"
args = ["-y", "mcp-remote@latest", "https://mcp.braingrid.ai/mcp"]
  1. Restart Codex

    • Restart Codex to load the new MCP server configuration
    • Once restarted, you will need to authenticate with BrainGrid
  2. Authenticate

    • Follow the authentication prompts to connect your BrainGrid account
    • Once authenticated, you can start using the BrainGrid MCP

To install the BrainGrid MCP server in Cursor, click the button below.

Add braingrid MCP server to Cursor

Once you click, you'll be taken to the Cursor MCP settings.

Cursor MCP settings

Click "Install" and you'll see the BrainGrid MCP server installed with a "Needs login" message.

BrainGrid MCP installed

Click on the "Needs login" message and you'll be taken to the BrainGrid login page. Once you log in, you can approve the BrainGrid MCP to connect to your account.

BrainGrid login approval page

Once you're logged in, you can start using the BrainGrid MCP.

BrainGrid MCP connected

To install the BrainGrid MCP server in Windsurf:

  1. Install mcp-remote globally

    npm install -g mcp-remote
  2. Open Windsurf Settings

    • Click the Settings -> Windsurf Settings, or
Windsurf settings
  1. Scroll down to the MCP Servers section
    • Click Open MCP Marketplace
Windsurf MCP settings
  1. In the Installed MCPs sub section
    • Click the gear icon on the right.
Windsurf settings
  1. Configure the Server
    • Enter the following configuration:
{
  "mcpServers": {
    "braingrid": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.braingrid.ai/mcp"]
    }
  }
}
  1. Complete Setup
    • Close all tabs
    • Reopen the Windsurf Settings
    • Go to the MCP Marketplace, click open
    • You will see the BrainGrid MCP server listed
BrainGrid MCP in Windsurf
  1. Troubleshooting
    • If you are having connection or auth issues, disable it and re-enable it.

To install the BrainGrid MCP server in Warp:

  1. Open MCP Settings

    • Click on the Settings menu in Warp
    • Navigate to FeaturesAIModel Context Protocol (MCP)MCP settings
    • Or visit the MCP settings documentation for more details
  2. Add the Server Configuration

    • In the MCP settings, add the following configuration:
{
  "braingrid": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote@latest",
      "https://mcp.braingrid.ai/mcp"
    ],
    "env": {},
    "working_directory": null
  }
}
  1. Complete Setup
    • Save the configuration
    • Restart Warp to load the new MCP server
    • You will need to authenticate with BrainGrid on first use

For other tools, add BrainGrid MCP to your JSON configuration:

{
  "mcpServers": {
    "braingrid": {
      "url": "https://mcp.braingrid.ai/mcp",
      "transport": "httpStream"
    }
  }
}