Connect AgentBill to your AI tools

Custom connectors are on the Free, Pro, Max, Team and Enterprise plans; Free has one custom connector. Claude reaches AgentBill from Anthropic's cloud, not from your computer.

Team and Enterprise: an Owner adds it once under Organization settings, Connectors: Add, Custom, Web, then the server URL. Each member then finds it under Customize, Connectors and presses Connect.

In a chat: press +, then Connectors, and turn AgentBill on.

Claude has no link that adds a connector for you, so this button opens the page where you add it.

A new app shows under Drafts.

ChatGPT has no link that adds an app for you, so this button opens the page where you add it.

With an API key instead of a sign-in. Put your key in AGENTBILL_API_KEY. Your shell fills it in when the command runs, and Claude Code keeps it in its own config:

claude mcp add --transport http agentbill https://agentbill.dev/mcp --header "Authorization: Bearer $AGENTBILL_API_KEY"

Or in a project's .mcp.json, where Claude Code reads the variable each time it starts:

{
  "mcpServers": {
    "agentbill": {
      "type": "http",
      "url": "https://agentbill.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${AGENTBILL_API_KEY}"
      }
    }
  }
}

With an API key instead of a sign-in. In ~/.codex/config.toml, name the variable that holds your key, and set AGENTBILL_API_KEY where Codex runs:

[mcp_servers.agentbill]
url = "https://agentbill.dev/mcp"
bearer_token_env_var = "AGENTBILL_API_KEY"

In the IDE extension: the gear menu, MCP servers, Add server, then Streamable HTTP and the server URL.

With an API key instead of a sign-in. In .cursor/mcp.json for one project, or ~/.cursor/mcp.json for all of them. Cursor reads AGENTBILL_API_KEY from your environment:

{
  "mcpServers": {
    "agentbill": {
      "url": "https://agentbill.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AGENTBILL_API_KEY}"
      }
    }
  }
}

The file is ~/.gemini/config/mcp_config.json, or .agents/mcp_config.json in a workspace. The field is serverUrl; Antigravity does not read url here.

With an API key instead of a sign-in. Antigravity's documentation does not say it reads environment variables in this file, so the key goes in it: put yours where agb_your_key_here is, and keep the file out of version control.

{
  "mcpServers": {
    "agentbill": {
      "serverUrl": "https://agentbill.dev/mcp",
      "headers": {
        "Authorization": "Bearer agb_your_key_here"
      }
    }
  }
}

Antigravity has no install link, so this button copies the config.

The package is @agentbill/openclaw; its plugin id, the key under plugins.entries, is agentbill. The ceiling is per session, 500,000 tokens by default, and subagents spawned from a session draw on the same ceiling.

Every option, and what a refusal looks like, is on the OpenClaw guide.

VS Code with an API key. In .vscode/mcp.json. VS Code asks for the key once and keeps it out of the file:

{
  "inputs": [
    { "type": "promptString", "id": "agentbill-key", "description": "AgentBill API key", "password": true }
  ],
  "servers": {
    "agentbill": {
      "type": "http",
      "url": "https://agentbill.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${input:agentbill-key}"
      }
    }
  }
}

Any client. The endpoint is Streamable HTTP. With no credentials it answers 401 with a WWW-Authenticate header that points at its OAuth metadata, which is how a client learns to sign you in. A client that takes a static header sends Authorization: Bearer and your key.

On your own machine, over stdio. The Python package runs locally with your key in its environment:

uvx agentbill-mcp

{
  "mcpServers": {
    "agentbill": {
      "command": "uvx",
      "args": ["agentbill-mcp"],
      "env": {
        "AGENTBILL_API_KEY": "agb_your_key_here"
      }
    }
  }
}

Put your key where agb_your_key_here is. Its record_event takes no task_ref, so a job's reservations are settled from code with the SDK or POST /events; the remote server's record_event takes task_ref and reservation_id and settles them itself.