Setup

Configuration examples

Copy-ready MCP config for every supported client. If you haven't set up yet, start with a quickstart guide instead.

Before You Start

You need an API key from the dashboard Keys tab. Inject AGENT_CENTRAL_API_KEY from your environment or secret manager. Claude custom connectors use the signed connector URL from the same tab instead.

Client	Auth shape
Claude custom connector	Signed `/mcp/connect/<token>` URL
Claude Code	Bearer header from `AGENT_CENTRAL_API_KEY`
OpenClaw	`mcp.servers` entry with bearer header
Hermes Agent	`mcp_servers` entry with bearer header
Cursor	Bearer header from `AGENT_CENTRAL_API_KEY`
Custom agent	Remote HTTP MCP endpoint plus bearer header

Claude Custom Connector

Paste the signed connector URL from your dashboard into Claude > Customize > Connectors > Add custom connector. Full walkthrough in the Claude quickstart.

https://mcp.agentcentral.to/mcp/connect/<signed-token>

Claude Code

Set your key, then register the server. See the Claude quickstart for scope options (--scope project vs --scope user).

export AGENT_CENTRAL_API_KEY="ac_live_..."

claude mcp add --transport http agentcentral https://mcp.agentcentral.to/mcp \
  --header 'Authorization: Bearer ${AGENT_CENTRAL_API_KEY}'

JSON form:

claude mcp add-json agentcentral '{
  "type": "http",
  "url": "https://mcp.agentcentral.to/mcp",
  "headers": {
    "Authorization": "Bearer ${AGENT_CENTRAL_API_KEY}"
  }
}'

OpenClaw

Set your key, then register agentcentral. Restart OpenClaw if you set the variable after launch. Full details in the OpenClaw quickstart.

export AGENT_CENTRAL_API_KEY="ac_live_..."

openclaw mcp set agentcentral '{"transport":"streamable-http","url":"https://mcp.agentcentral.to/mcp","headers":{"Authorization":"Bearer ${AGENT_CENTRAL_API_KEY}"}}'

Manual config form:

{
  "mcp": {
    "servers": {
      "agentcentral": {
        "transport": "streamable-http",
        "url": "https://mcp.agentcentral.to/mcp",
        "headers": {
          "Authorization": "Bearer ${AGENT_CENTRAL_API_KEY}"
        }
      }
    }
  }
}

Hermes Agent

Add your key to ~/.hermes/.env, then add agentcentral to ~/.hermes/config.yaml. Restart Hermes or run /reload-mcp after saving. See the Hermes quickstart.

AGENT_CENTRAL_API_KEY=ac_live_...

mcp_servers:
  agentcentral:
    url: "https://mcp.agentcentral.to/mcp"
    headers:
      Authorization: "Bearer ${AGENT_CENTRAL_API_KEY}"
    enabled: true
    timeout: 120
    connect_timeout: 60

Cursor

Save as .cursor/mcp.json (project) or ~/.cursor/mcp.json (user). Restart Cursor after saving.

{
  "mcpServers": {
    "agentcentral": {
      "url": "https://mcp.agentcentral.to/mcp",
      "headers": {
        "Authorization": "Bearer ${AGENT_CENTRAL_API_KEY}"
      }
    }
  }
}

Generic MCP Client

Most MCP clients accept an mcpServers object with a URL and headers.

{
  "mcpServers": {
    "agentcentral": {
      "url": "https://mcp.agentcentral.to/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AGENT_CENTRAL_API_KEY}"
      }
    }
  }
}

Custom Agent

For agents that manage their own MCP client, point at the endpoint and inject the API key from your secret manager.

{
  "name": "agentcentral",
  "transport": "http",
  "url": "https://mcp.agentcentral.to/mcp",
  "headers": {
    "Authorization": "Bearer ${AGENT_CENTRAL_API_KEY}"
  },
  "capabilities": {
    "tools": true,
    "resources": true
  }
}