Skip to content
MCP server

three.ws Brain

List LLM providers and run chat completions through the three.ws multi-provider router.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.4
Listing updated
5 days ago

About three.ws Brain

three.ws Brain is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add brain-mcp --env THREE_WS_API_KEY='<THREE_WS_API_KEY>' -- npx -y @three-ws/brain-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "brain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/brain-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "brain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/brain-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "brain-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/brain-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "brain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/brain-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "brain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/brain-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
      }
    }
  }
}

Configuration

  • THREE_WS_BASEBase URL of the three.ws API that fronts the LLM router (/api/brain/chat). Override only when self-hosting or targeting a preview deployment.
  • THREE_WS_API_KEYOptional three.ws API key (sk_live_… / sk_test_…) or OAuth access token, sent as a Bearer token. Required only to use paid first-party flagships (Claude, GPT-5, o3, Grok, Qwen Plus, DeepSeek). Free open-weight tiers (GPT-OSS 120B, NVIDIA NIM models) work with no key. Create one at https://three.ws/dashboard/developers.
  • THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds. Chat completions stream server-side and are collapsed into a single reply, so this is generous by default to ride out a long flagship answer.

Pricing

Open source

Prices change. Check three.ws before you buy.

three.ws Brain FAQ

Is three.ws Brain free?

Yes. three.ws Brain is open source, so you can use and self-host it for free.

How do I add three.ws Brain to Claude Code?

Run this command in your terminal: claude mcp add brain-mcp --env THREE_WS_API_KEY='<THREE_WS_API_KEY>' -- npx -y @three-ws/brain-mcp