briqbriq
Setup

Clients

Add briq to your MCP client and sign in.

Add briq to your client by hand. Your agent can also do it for you: see the Quickstart. Building your own agent? See Frameworks.

Agent on a server or in a chat app? It signs in with a device code: see For agents.

Claude Code

1. Add briq
claude mcp add --scope user --transport http briq https://api.briq.cloud/mcp
2. Sign in
claude mcp login briq

Your browser opens to sign in.Or run /mcp inside Claude Code and pick briq.

1. Add briq
claude mcp add --scope user --transport http briq-stg https://api.stg.briq.cloud/mcp
2. Sign in
claude mcp login briq-stg

Your browser opens to sign in.Or run /mcp inside Claude Code and pick briq-stg.

1. Add briq
claude mcp add --scope user --transport http briq-local http://localhost:3001/mcp
2. Sign in
claude mcp login briq-local

Your browser opens to sign in.Or run /mcp inside Claude Code and pick briq-local.

Cursor

Add to Cursor
Or add to ~/.cursor/mcp.json
{
  "mcpServers": {
    "briq": {
      "url": "https://api.briq.cloud/mcp"
    }
  }
}

On first use, your browser opens to sign in.

Add to Cursor
Or add to ~/.cursor/mcp.json
{
  "mcpServers": {
    "briq-stg": {
      "url": "https://api.stg.briq.cloud/mcp"
    }
  }
}

On first use, your browser opens to sign in.

Add to Cursor
Or add to ~/.cursor/mcp.json
{
  "mcpServers": {
    "briq-local": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

On first use, your browser opens to sign in.

VS Code

Install in VS Code
Or add it for your user
code --add-mcp '{"name":"briq","type":"http","url":"https://api.briq.cloud/mcp"}'

On first use, your browser opens to sign in.

Install in VS Code
Or add it for your user
code --add-mcp '{"name":"briq-stg","type":"http","url":"https://api.stg.briq.cloud/mcp"}'

On first use, your browser opens to sign in.

Install in VS Code
Or add it for your user
code --add-mcp '{"name":"briq-local","type":"http","url":"http://localhost:3001/mcp"}'

On first use, your browser opens to sign in.

Codex

1. Add briq
codex mcp add briq --url https://api.briq.cloud/mcp
2. Sign in
codex mcp login briq

Your browser opens to sign in.

1. Add briq
codex mcp add briq-stg --url https://api.stg.briq.cloud/mcp
2. Sign in
codex mcp login briq-stg

Your browser opens to sign in.

1. Add briq
codex mcp add briq-local --url http://localhost:3001/mcp
2. Sign in
codex mcp login briq-local

Your browser opens to sign in.

Claude

In Claude (web or desktop): Settings → Connectors → Add custom connector.Name it briq and paste this URL, then click Connect.

Remote MCP server URL
https://api.briq.cloud/mcp

Your browser opens to sign in.

In Claude (web or desktop): Settings → Connectors → Add custom connector.Name it briq-stg and paste this URL, then click Connect.

Remote MCP server URL
https://api.stg.briq.cloud/mcp

Your browser opens to sign in.

In Claude (web or desktop): Settings → Connectors → Add custom connector.Name it briq-local and paste this URL, then click Connect.

Remote MCP server URL
http://localhost:3001/mcp

Your browser opens to sign in.

Gemini CLI

1. Add briq
gemini mcp add --scope user --transport http briq https://api.briq.cloud/mcp
2. Sign in, inside Gemini CLI
/mcp auth briq

Your browser opens to sign in.

1. Add briq
gemini mcp add --scope user --transport http briq-stg https://api.stg.briq.cloud/mcp
2. Sign in, inside Gemini CLI
/mcp auth briq-stg

Your browser opens to sign in.

1. Add briq
gemini mcp add --scope user --transport http briq-local http://localhost:3001/mcp
2. Sign in, inside Gemini CLI
/mcp auth briq-local

Your browser opens to sign in.

Antigravity

1. Add briq to ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "briq": {
      "serverUrl": "https://api.briq.cloud/mcp"
    }
  }
}

Then in Agent Settings → Customizations, click Authenticate next to briq.Sign in, then paste the code back into Antigravity.

1. Add briq to ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "briq-stg": {
      "serverUrl": "https://api.stg.briq.cloud/mcp"
    }
  }
}

Then in Agent Settings → Customizations, click Authenticate next to briq-stg.Sign in, then paste the code back into Antigravity.

1. Add briq to ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "briq-local": {
      "serverUrl": "http://localhost:3001/mcp"
    }
  }
}

Then in Agent Settings → Customizations, click Authenticate next to briq-local.Sign in, then paste the code back into Antigravity.

OpenCode

1. Add briq to ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "briq": {
      "type": "remote",
      "url": "https://api.briq.cloud/mcp",
      "enabled": true
    }
  }
}
2. Sign in
opencode mcp auth briq

Your browser opens to sign in.

1. Add briq to ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "briq-stg": {
      "type": "remote",
      "url": "https://api.stg.briq.cloud/mcp",
      "enabled": true
    }
  }
}
2. Sign in
opencode mcp auth briq-stg

Your browser opens to sign in.

1. Add briq to ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "briq-local": {
      "type": "remote",
      "url": "http://localhost:3001/mcp",
      "enabled": true
    }
  }
}
2. Sign in
opencode mcp auth briq-local

Your browser opens to sign in.

Hermes

1. Add briq to ~/.hermes/config.yaml
mcp_servers:
  briq:
    url: "https://api.briq.cloud/mcp"
    auth: oauth
2. Sign in
hermes mcp login briq
Or sign in on a server, or behind a chat app
hermes mcp login briq --flow device

Your browser opens to sign in.With --flow device, it prints a link and a code instead: open the link on any device, check the code and approve.

1. Add briq to ~/.hermes/config.yaml
mcp_servers:
  briq-stg:
    url: "https://api.stg.briq.cloud/mcp"
    auth: oauth
2. Sign in
hermes mcp login briq-stg
Or sign in on a server, or behind a chat app
hermes mcp login briq-stg --flow device

Your browser opens to sign in.With --flow device, it prints a link and a code instead: open the link on any device, check the code and approve.

1. Add briq to ~/.hermes/config.yaml
mcp_servers:
  briq-local:
    url: "http://localhost:3001/mcp"
    auth: oauth
2. Sign in
hermes mcp login briq-local
Or sign in on a server, or behind a chat app
hermes mcp login briq-local --flow device

Your browser opens to sign in.With --flow device, it prints a link and a code instead: open the link on any device, check the code and approve.

OpenClaw

1. Add briq
openclaw mcp set briq '{"url":"https://api.briq.cloud/mcp","transport":"streamable-http","auth":"oauth"}'
2. Sign in
openclaw mcp login briq

Your browser opens to sign in.On a server, sign in from the link it prints, then finish with the --code command it gives.

1. Add briq
openclaw mcp set briq-stg '{"url":"https://api.stg.briq.cloud/mcp","transport":"streamable-http","auth":"oauth"}'
2. Sign in
openclaw mcp login briq-stg

Your browser opens to sign in.On a server, sign in from the link it prints, then finish with the --code command it gives.

1. Add briq
openclaw mcp set briq-local '{"url":"http://localhost:3001/mcp","transport":"streamable-http","auth":"oauth"}'
2. Sign in
openclaw mcp login briq-local

Your browser opens to sign in.On a server, sign in from the link it prints, then finish with the --code command it gives.

Pi

Pi reaches MCP servers through the pi-mcp-adapter extension.

1. Install the MCP adapter
pi install npm:pi-mcp-adapter
2. Add briq to ~/.config/mcp/mcp.json
{
  "mcpServers": {
    "briq": {
      "url": "https://api.briq.cloud/mcp"
    }
  }
}
3. Sign in, inside Pi
/mcp-auth briq

Your browser opens to sign in.

Pi reaches MCP servers through the pi-mcp-adapter extension.

1. Install the MCP adapter
pi install npm:pi-mcp-adapter
2. Add briq to ~/.config/mcp/mcp.json
{
  "mcpServers": {
    "briq-stg": {
      "url": "https://api.stg.briq.cloud/mcp"
    }
  }
}
3. Sign in, inside Pi
/mcp-auth briq-stg

Your browser opens to sign in.

Pi reaches MCP servers through the pi-mcp-adapter extension.

1. Install the MCP adapter
pi install npm:pi-mcp-adapter
2. Add briq to ~/.config/mcp/mcp.json
{
  "mcpServers": {
    "briq-local": {
      "url": "http://localhost:3001/mcp"
    }
  }
}
3. Sign in, inside Pi
/mcp-auth briq-local

Your browser opens to sign in.

Any MCP client

Any client that supports remote MCP servers (Streamable HTTP): add this URL.

MCP server URL
https://api.briq.cloud/mcp

Clients with MCP sign-in (OAuth) open your browser on first use.Others can send an API key: see API key, below.

Any client that supports remote MCP servers (Streamable HTTP): add this URL.

MCP server URL
https://api.stg.briq.cloud/mcp

Clients with MCP sign-in (OAuth) open your browser on first use.Others can send an API key: see API key, below.

Any client that supports remote MCP servers (Streamable HTTP): add this URL.

MCP server URL
http://localhost:3001/mcp

Clients with MCP sign-in (OAuth) open your browser on first use.Others can send an API key: see API key, below.

API key

For CI, containers and scripts, where no browser can sign in.Create a key on the Agents page, then send it as a Bearer token.

MCP: the URL, with the key in a header
{
  "mcpServers": {
    "briq": {
      "url": "https://api.briq.cloud/mcp",
      "headers": {
        "Authorization": "Bearer ${BRIQ_API_KEY}"
      }
    }
  }
}
Or call the REST API
curl https://api.briq.cloud/v1/briqs \
  -H "Authorization: Bearer $BRIQ_API_KEY"

How a client reads the key from the environment varies: see its docs.

For CI, containers and scripts, where no browser can sign in.Create a key on the Agents page, then send it as a Bearer token.

MCP: the URL, with the key in a header
{
  "mcpServers": {
    "briq-stg": {
      "url": "https://api.stg.briq.cloud/mcp",
      "headers": {
        "Authorization": "Bearer ${BRIQ_API_KEY}"
      }
    }
  }
}
Or call the REST API
curl https://api.stg.briq.cloud/v1/briqs \
  -H "Authorization: Bearer $BRIQ_API_KEY"

How a client reads the key from the environment varies: see its docs.

For CI, containers and scripts, where no browser can sign in.Create a key on the Agents page, then send it as a Bearer token.

MCP: the URL, with the key in a header
{
  "mcpServers": {
    "briq-local": {
      "url": "http://localhost:3001/mcp",
      "headers": {
        "Authorization": "Bearer ${BRIQ_API_KEY}"
      }
    }
  }
}
Or call the REST API
curl http://localhost:3001/v1/briqs \
  -H "Authorization: Bearer $BRIQ_API_KEY"

How a client reads the key from the environment varies: see its docs.

On this page

Free to try

Let your agent try it, on us.

Every new account starts with €10 of credits. No card.

Connect your agent

How can we help?

Message to the briq team
hello@briq.cloud