The Model Context Protocol (MCP) is the standard way to give an AI assistant a set of tools it can call. Wrenbase exposes its own tools over MCP. So instead of clicking through the dashboard, you say what you want: "send the invoice to Acme," "what's overdue," "mark INV-042 paid." It works with any MCP-capable client, Claude included. Nothing to install, and every action runs as you, with your account's permissions and a full audit trail behind it.
What you need to connect Wrenbase over MCP
Two things, and you get both from the same place in Wrenbase:
- The Wrenbase MCP server URL:
https://developers.wrenbase.com/mcp. It is remote, so there is nothing to install locally. - A Wrenbase API key, used as a bearer token. The same key works for the REST API too.
Step 1: Create a Wrenbase API key
An MCP client connects to Wrenbase with an API key. You create and manage keys in the workspace, on the Developer → API Keys page.
- 1
Open the Developer area
In the workspace sidebar, go to Developer → API Keys. - 2
Create a key
Create a new key and give it a label you'll recognize later, like "Claude Desktop" or "billing agent." - 3
Link it to you or an agent
Choose who the key acts as. Link it to yourself to act on your own behalf, or to one of your AI agents so the calls run under that agent's limits. A key is always tied to exactly one of the two. - 4
Set an expiration
Pick how long the key should last, a fixed window or no expiry. You can change your mind later by revoking and reissuing. - 5
Copy it once
Wrenbase shows the full key a single time, right after you create it. Copy it then and store it somewhere safe, you won't be able to see it again. If you lose it, revoke it and create a new one.
Step 2: Connect your MCP client to Wrenbase
Most MCP clients ask for a remote server's URL and a header or token. Put the Wrenbase server URL and your key (as a bearer token) wherever your client keeps its MCP server settings:
Server URL: https://developers.wrenbase.com/mcp
Header: Authorization: Bearer wb_live_...Once connected, the client discovers the Wrenbase tools automatically and you can start asking it to do things in plain language.
The exact steps vary a little by client. Here's how to connect the common ones.
Connect Claude to Wrenbase
In Claude Desktop, open Settings → Connectors (or Developer → MCP serversdepending on your version) and add a remote server. Give it a name like "Wrenbase," set the URL, and add your key as a bearer token in the Authorization header:
Name: Wrenbase
URL: https://developers.wrenbase.com/mcp
Header: Authorization: Bearer wb_live_...Claude picks up the Wrenbase tools on its own. To confirm it worked, ask "what Wrenbase invoices are overdue?"
Connect Cursor to Wrenbase
In Cursor, open Settings → MCP and add a new MCP server pointing at the Wrenbase remote URL with your bearer token. If your Cursor version uses a JSON config, add Wrenbase under mcpServers:
{
"mcpServers": {
"wrenbase": {
"url": "https://developers.wrenbase.com/mcp",
"headers": { "Authorization": "Bearer wb_live_..." }
}
}
}Reload Cursor and the Wrenbase tools appear in the MCP tool list.
Connect any MCP client to Wrenbase
Any client that supports a remote MCP server works the same way, ChatGPT with MCP, Windsurf, Zed, custom agents, and so on. Wherever the client keeps its MCP server settings, give it the URL and the bearer header:
URL: https://developers.wrenbase.com/mcp
Header: Authorization: Bearer wb_live_...There's nothing Wrenbase-specific to install. The server is remote, so once it connects the tools are just there.
Step 3: Ask in plain language
You never type tool names yourself. You say something like "send Acme's invoice" or "what's overdue," and your client works out which Wrenbase tool to call and with what.
The Wrenbase MCP tools (full reference)
Once your client is connected, it can see and call these tools. You never call them by name yourself, you ask in plain language ("send Acme's invoice," "what's overdue") and the client picks the right tool with the right fields. Here's every tool and its parameters.
Account tools
session_whoamiGet the authenticated caller's identity. Returns account ID, identity email, account type (user or agent), the organization the caller acts for, and spending controls if the caller is an agent.
Returns: account ID, identity email, account type, organization, agent spending controls
organization_statsGet organization-level statistics: number of active agents, invoices sent, and total revenue collected.
Contact tools
contacts_createCreate a contact: a client (someone you invoice) or a vendor (someone who bills you), set by the role argument. Use for 'add Acme Corp as a client' or 'set up my new landlord as a vendor'.
rolerequirednamerequiredemailrequiredcompanystringphonestringpreferred_channelstringexternal_idstringcontacts_listList contacts, optionally filtered by role. Use for 'who are my clients' or 'list my vendors'.
rolestringsearchstringInvoice tools
invoices_createCreate a draft invoice with one or more line items. Each line item has a description, billing type (hourly or fixed), quantity, and unit price. Total is calculated automatically.
to_emailrequiredline_itemsrequiredto_namestringto_companystringcurrencystringdue_datestringpo_numberstringtax_typestringtax_ratenumbernotesstringReturns: invoice ID and invoice number
invoices_getRetrieve a specific invoice by ID or invoice number. Returns full details including line items, amounts, status, dates, and recipient info.
invoice_idstringinvoice_numberstringinvoices_listList invoices filtered by status. Pass status to answer 'what's outstanding' (sent) or 'what's overdue' (overdue). Omit status for the most recent across all statuses.
statusstringlimitintegeroffsetintegerinvoices_updateEdit a draft invoice: change line items, tax, notes, due date, or PO number. Any field you set is replaced; anything you omit stays unchanged.
invoice_idstringinvoice_numberstringtax_typestringtax_ratenumbernotesstringdue_datestringpo_numberstringinvoices_transitionChange an invoice's state: 'send' a draft, 'mark_paid' when payment arrived off-platform, or 'void' it. Use for 'send invoice INV-1042', 'mark it paid by check', or 'void that invoice'.
actionrequiredinvoice_idstringinvoice_numberstringpayment_methodstringnotesstringHow Wrenbase MCP stays secure
MCP gives an AI client real access to your account, so it's built to stay under your control.
Every action runs as a real identity
A key is tied to exactly one identity, you or one agent, with the same permissions it has in the app. Nothing a key does exceeds what the person or agent behind it can do.
Revoke a key instantly
Don't recognize a client? Revoke its key from Developer → API Keys and it stops working right away. The page shows which client last used each key. Keys are stored hashed, so Wrenbase shows a key only once.
Agents stay within your limits
When a key is linked to an agent, its actions run inside the limits you set. Anything past those limits waits for your approval instead of running.
Money movement stays in your hands
The tools create and send invoices and mark them paid, but none wire funds out. Moving money is always a deliberate step in the app, never from a chat message.
Everything is on the record
Every change through MCP is written to your audit trail, with what happened and who did it, alongside everything else in your account.
Availability
MCP is included on the higher Wrenbase plans. See wrenbase.com/pricing for what's included where.
