Repository avatar
AI Tools
v0.1.1
active

singlebrain-gateway

io.github.SingleGrain-Team/singlebrain-gateway

One key for your own accounts and 1,000+ paid tools. Connect, call, pay per use; every call logged.

Documentation

SingleBrain Gateway

SingleBrain Gateway is a remote MCP server. One connection reaches the marketing and sales accounts you connect yourself (Google Analytics, Search Console, HubSpot, Slack, and others) plus paid data tools that run on our accounts (such as DataForSEO, Perplexity, Exa, Apollo, and Hunter). Connected accounts are free. Paid tools are billed per call from one balance. There is no subscription, and every call is logged.

This repository is the public plugin and install shell. It is not the server source. The live server is at the address below.

Docs · Website · Support

Install

Add to Cursor Install in VS Code Install in VS Code Insiders

Those badges add the remote server with no key in the link. The first time the client connects, a SingleBrain page opens so you can sign in with OAuth.

The remote address

https://gateway.singlebrain.com/mcp

Use that address as written, with no query string. The server speaks MCP over streamable HTTP. The sign-in token is issued for the plain address, and a token for an address that includes a query is refused.

Official MCP registry name (once published from the server repo): io.github.SingleGrain-Team/singlebrain-gateway.

Connect with OAuth

Paste the address into a client that supports a remote MCP server. The first time it connects, a SingleBrain page opens. Sign in or create an account, pick the organization, and choose Allow. No key is copied.

Claude (claude.ai and Claude desktop)

Open claude.ai/customize/connectors (or Settings, Connectors in the desktop app), choose Add custom connector, paste https://gateway.singlebrain.com/mcp, choose Add, then choose Connect. Leave the advanced settings empty.

Claude Code

claude mcp add --transport http singlebrain "https://gateway.singlebrain.com/mcp" --scope user

Then run /mcp in Claude Code, pick singlebrain, choose Authenticate, and finish sign-in on the SingleBrain page that opens.

To install this repo as a Claude Code plugin after it is on GitHub:

claude plugin marketplace add SingleGrain-Team/singlebrain-gateway-plugin
claude plugin install singlebrain-gateway@singlebrain-gateway

Cursor

Click Add to Cursor above, or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "singlebrain": {
      "url": "https://gateway.singlebrain.com/mcp"
    }
  }
}

A Cursor plugin manifest also lives in this repo (.cursor-plugin/plugin.json and root mcp.json) for the Cursor Marketplace and cursor.directory.

VS Code

Click Install in VS Code above, or add this to .vscode/mcp.json:

{
  "servers": {
    "singlebrain": {
      "type": "http",
      "url": "https://gateway.singlebrain.com/mcp"
    }
  }
}

Codex

Add this block to ~/.codex/config.toml. Codex defaults to OAuth for HTTP MCP servers when no bearer token is set:

[mcp_servers.singlebrain]
url = "https://gateway.singlebrain.com/mcp"

Cline

This is a hosted server. Do not run a local install from the repo. In Cline, open MCP Servers, use the Remote Servers tab, and add:

  • Server Name: singlebrain
  • Server URL: https://gateway.singlebrain.com/mcp
  • Transport Type: Streamable HTTP

If you edit the settings JSON yourself, set "type": "streamableHttp" on the entry. Omitting type makes Cline use legacy SSE. Step-by-step instructions for an agent are in llms-install.md.

Windsurf

Open MCP config (mcp_config.json) and add:

{
  "mcpServers": {
    "singlebrain": {
      "serverUrl": "https://gateway.singlebrain.com/mcp"
    }
  }
}

Windsurf supports OAuth for Streamable HTTP remotes. Refresh the MCP plugin list after you add it.

Goose

Goose can also install this server from the official MCP registry once it is published. To add it by hand, merge this into the extensions section of ~/.config/goose/config.yaml (Windows: %APPDATA%\Block\goose\config\config.yaml):

extensions:
  singlebrain:
    type: streamable_http
    name: singlebrain
    display_name: SingleBrain Gateway
    enabled: true
    uri: "https://gateway.singlebrain.com/mcp"
    timeout: 300

Connect with a key

Claude Code, Codex, Cursor, and VS Code can use a key instead. Sign in, create a key in the dashboard, and send it on the same address as an Authorization header, Bearer followed by the key. The key acts as the member who created it. Never put a key in a chat, an email, or a command other people can read.

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "singlebrain": {
      "url": "https://gateway.singlebrain.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SINGLEBRAIN_KEY"
      }
    }
  }
}

VS Code (.vscode/mcp.json). VS Code will prompt for the key:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "singlebrain-api-key",
      "description": "SingleBrain Gateway API key",
      "password": true
    }
  ],
  "servers": {
    "singlebrain": {
      "type": "http",
      "url": "https://gateway.singlebrain.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:singlebrain-api-key}"
      }
    }
  }
}

Codex (~/.codex/config.toml). Set the environment variable to the key only. Codex sends it as Authorization: Bearer <value>:

[mcp_servers.singlebrain]
url = "https://gateway.singlebrain.com/mcp"
bearer_token_env_var = "SINGLEBRAIN_API_KEY"

Cline and Windsurf use the same Authorization: Bearer YOUR_SINGLEBRAIN_KEY header. See configs/ for full examples.

Or let the device sign-in write the client entry for you:

npx -y singlebrain start --client cursor
npx -y singlebrain start --client vscode
npx -y singlebrain start --client codex
npx -y singlebrain start --client claude-code

It shows a code. Approve it in the browser, and it writes the server into that client. Cursor keeps it in ~/.cursor/mcp.json under mcpServers.singlebrain. VS Code keeps it in .vscode/mcp.json and prompts for the key. Codex keeps it in ~/.codex/config.toml.

What's in this repo

FilePurpose
.cursor-plugin/plugin.json, mcp.jsonCursor plugin (Marketplace and cursor.directory)
.claude-plugin/plugin.json, .claude-plugin/marketplace.json, .mcp.jsonClaude Code plugin marketplace in this repo
llms-install.mdAgent-oriented Cline install steps
assets/logo.png512x512 logo
assets/logo-400x400.png400x400 logo for the Cline marketplace
configs/Copy-paste snippets for Cursor, VS Code, Windsurf, Cline, Goose, and Codex

Help

License

MIT, copyright Single Grain.

No installation packages available.