Connect your agent

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 Agents → API Keys 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 Agents → API Keys:

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

The same command, with your key already filled in, is on the Agents → Connect tab in your dashboard with a copy button.

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_....

All 33 tools 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: the client-facing invoice or estimate URL, the PDF, and the page in your dashboard.

Clients

Look up and maintain the client list.

  • list_clients
  • get_client
  • create_client
  • update_client

Invoices

Draft, edit, send, and settle invoices.

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

Estimates

Quote work up front, then turn an accepted quote into an invoice.

  • list_estimates
  • get_estimate
  • create_estimate
  • update_draft_estimate
  • send_estimate
  • convert_estimate_to_invoice

Saved items

The rate catalog invoices and estimates can bill from by name.

  • list_items
  • create_item
  • update_item

Time

Log and correct tracked time before it gets billed.

  • log_time
  • list_time_entries
  • update_time_entry
  • delete_time_entry

Expenses

Log and correct expenses, billable or not.

  • log_expense
  • list_expenses
  • update_expense
  • delete_expense

Payments

Check what has been paid, what is still due, and how to pay.

  • get_payment_status

Business and links

Business settings, revenue rollups, and shareable links.

  • get_business
  • list_businesses
  • revenue_summary
  • get_invoice_link
  • list_unbilled

Check that it worked

Ask your agent for something read-only first. If the key and the endpoint are right, this comes back with your own data and nothing is written:

List my Billr clients and tell me what is still unbilled.

If the key is missing or revoked, the server answers with a 401 rather than a silent empty list, so a wrong key never looks like an empty account.

Where to go next

  • Estimates and items: quote work up front, convert an accepted quote, and bill a saved rate by name.
  • Getting paid: connect Stripe, test your checkout, and read payment status from an agent.
  • Recipes: copy-paste patterns for a CLAUDE.md or AGENTS.md file.

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

Coming soon, launching with the agent release