Get started

Five steps from a new account to an agent drafting invoices for you. Your agent can only send what you have given it permission to send.

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

   Connect your agent

   Billr is a remote MCP server at https://mcp.billr.cc. In most clients you add that URL and sign in. Signing in shows a consent screen that asks which business the agent may work in and which permissions it gets, with read and write on by default and send, payments and delete optional. Every connection shows up under Agents → API Keys and can be revoked there at any time.

   Client menus change, so the exact steps for Claude, Claude Code, Codex, Cursor, ChatGPT and other clients live in one maintained guide: Connect your agent.

   A client that cannot sign in can use an API key instead. Create one under Agents → API Keys; it is shown once, so copy it before closing the dialog. Send it with every request:

   >_ ExampleCopy

   Authorization: Bearer billr_sk_...

   More on key profiles, scoping and revoking keys.

3. 3

   Check the connection

   Ask for something read-only first. It answers with your own data and nothing is created or sent:

   >_ ExampleCopy

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

   A missing or revoked connection gets a 401, not an empty list.

4. 4

   Your first invoice draft

   Then ask for a draft:

   >_ ExampleCopy

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

   Invoices and estimates an agent creates start as drafts. With the default read and draft access the agent cannot send them: you review the draft in your dashboard and send it yourself.

   Sending is a separate permission. If you grant it on the consent screen, or use a billing or full access key, the agent can email an invoice or estimate to your client directly, without a dashboard step. Grant it only to an agent you trust to send, and revoke it under Agents → API Keys at any time. Task pricing and task invoice approval always need a person.

   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.