Connect your agent

Coming soon, launching with the agent release

Billr exposes a remote MCP server at https://mcp.billr.cc, authenticated with a bearer token:

Authorization: Bearer billr_sk_...

Any MCP-compatible agent can connect. Create a key from Settings → API in your dashboard, then follow the guide for your agent below.

Set up per agent

Claude Code

Add the server with one command, replacing YOUR_API_KEY with the key you created in Settings → API:

claude mcp add --transport http billr https://mcp.billr.cc --header "Authorization: Bearer YOUR_API_KEY"

Or install the plugin, which walks you through key creation and connection:

/plugin install billr

claude.ai connectors

Go to Settings → Connectors in claude.ai, add a custom connector, and point it at https://mcp.billr.cc with your API key as the bearer token.

Codex & other MCP clients

Any client that speaks streamable-HTTP MCP works the same way. For Codex, add a server entry to your config:

[mcp_servers.billr]
url = "https://mcp.billr.cc"
headers = { Authorization = "Bearer YOUR_API_KEY" }

Other clients follow the same pattern: URL https://mcp.billr.cc, header Authorization: Bearer billr_sk_....

Tool surface at a glance

Every tool is business-scoped to the key that calls it. Mutating tools return the entity plus a link your agent can hand back to you.

Clients

  • list_clients
  • get_client
  • create_client
  • update_client

Invoices

  • list_invoices
  • get_invoice
  • create_invoice
  • update_draft_invoice
  • send_invoice
  • record_payment

Work

  • log_time
  • log_expense
  • list_unbilled

Info

  • get_business
  • revenue_summary
  • get_invoice_link

Skills, per-agent guides, and examples live in the public billr-agents repo.

Coming soon, launching with the agent release