MCP server

HueChat exposes an account-scoped MCP server over streamable HTTP:

https://app.huechat.ai/v2/mcp

Getting a key

MCP uses its own, separately approved credential. As an account administrator, open Settings → Integrations → MCP, request access for the account, wait for approval, then copy the key when it is revealed. It is shown once.

A REST scoped key cannot be used for MCP, and an MCP key is rejected on the REST routes. The MCP key must carry mcp:use plus only the resource scopes the tools you enable actually need.

The requester must remain an active administrator; demotion, removal, key revocation or expiry disables the credential.

Required headers

Authorization: Bearer <MCP key>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25

Handshake

Initialize

curl -fsS https://app.huechat.ai/v2/mcp \
  -H "Authorization: Bearer $HUECHAT_MCP_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-integration","version":"1.0.0"}}}'

Send the initialized notification

{ "jsonrpc": "2.0", "method": "notifications/initialized", "params": {} }

List the tools your key may use

{ "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }

The list is filtered by the key’s scopes.

Call a read-only tool

{ "jsonrpc": "2.0", "id": 3, "method": "tools/call",
  "params": { "name": "get_contacts", "arguments": { "query": "Example", "limit": 10 } } }

Client configuration

Most MCP clients accept this shape:

{
  "mcpServers": {
    "huechat": {
      "type": "http",
      "url": "https://app.huechat.ai/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${HUECHAT_MCP_KEY}",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

Write tools create or change customer data. Grant the smallest scope set and review what an assistant is allowed to do before connecting it.

Get started

Working with the API

Integrate

Getting a key

Required headers

Handshake

Client configuration

​Getting a key

​Required headers

​Handshake

​Client configuration

Getting a key

Required headers

Handshake

Client configuration