Get started

Five steps to get an agent creating and sending invoices on your behalf, with you approving every send from the dashboard.

1. 1

   Create your account

   Sign up at billr.cc (or sign in if you already have an account). Sign up in seconds.

2. 2

   Create an API key

   Go to Agents → API Keys in your Billr dashboard and generate a key. Scope it to a single business if you run more than one. The key is shown once, at creation, so copy it somewhere safe before you close the dialog.

   More on scoping and revoking keys.

3. 3

   Connect

   Billr exposes an MCP endpoint at https://mcp.billr.cc authenticated with a header:

   Authorization: Bearer billr_sk_...

   Claude Code

   Add the server with one command, then replace 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"

   claude.ai: add Billr under Settings → Connectors as a custom connector, using the same MCP endpoint with your API key as the bearer token. Any other MCP client follows the same pattern; see Connect your agent.

4. 4

   Your first invoice

   Try a prompt with your agent once it's connected:

   Create a client called Test Co with my email, draft a $100 invoice for "Setup test", and send it to me.

   The invoice lands as a draft in your dashboard first. You review and approve the send.

   Rather quote before you bill? Ask for an estimate instead, then convert it once the client accepts. See Estimates and items.

5. 5

   Turn on online payments

   In Agents → Payments, connect your own Stripe account. Clients then pay on the Billr invoice page, carrying your branding, and the money goes straight into your Stripe. Billr charges 0% and never holds the funds.

   Before you send anything to a real client, run Test your checkout. It charges a test card against your own connected account so you can watch the payment land. Full detail in Getting paid.