Quits' MCP server lets an AI assistant read and record a person's shared expenses: their groups, who paid what, the balances, and new expenses and payments. This page is for people setting it up by hand, developers and directory reviewers. To just connect your assistant, see Help.
The server
- Address:
https://usequits.com/api/mcp - Transport: Streamable HTTP, stateless: each request is one JSON-RPC message answered with JSON. No sessions and no server-sent events. Remote only; there is nothing to install.
- Protocol versions: 2026-07-28, 2025-11-25 and 2025-06-18.
- Capabilities: tools, with instructions for the assistant in the
server's answer to
initialize(orserver/discover). No prompts or resources.
Authentication
OAuth 2.1 with PKCE (S256) and dynamic client registration: the assistant registers
itself, so there is no client id or secret to enter. A request without a valid token is
answered 401 with a WWW-Authenticate header that points to the
metadata:
https://usequits.com/.well-known/oauth-protected-resource/api/mcp(the resource)https://usequits.com/.well-known/oauth-authorization-server(the authorization server)
The person signs in with their Quits account (or creates one), checks that the page names their assistant and their email, and chooses Allow. A connection can be given these scopes:
| Scope | Lets the assistant |
|---|---|
ledger.read | See your groups, members, expenses, balances and notes. |
ledger.write | Add, correct and delete expenses and payments, attach photos, and make and edit notes and lists. |
ledger.manage | Create and change groups and their people, and handle invite links. |
To disconnect, open Account → Connected assistants in the app. Changing the Quits password disconnects every assistant.
Tools
Every tool needs ledger.read; the column says what else it needs. Tools that
write are marked so (readOnlyHint false), and those that can overwrite or
take something away carry destructiveHint, so the assistant asks first.
| Tool | What it does | Needs | Kind |
|---|---|---|---|
list_groupsList my groups |
The user's groups, with their balance in each, and the group that fits the people they named. | ledger.read |
Read only |
get_groupGet a group's members |
A group's members, their nicknames, and which one is the user. | ledger.read |
Read only |
get_balancesGet balances |
Who owes whom in a group, and a few payments that settle it. | ledger.read |
Read only |
list_entriesList expenses and payments |
A group's recent expenses and payments, newest first. | ledger.read |
Read only |
get_entryGet an entry |
One expense or payment in full: who paid, each share, the itemised receipt. | ledger.read |
Read only |
preview_expensePreview an expense |
Works out an expense's split before you say yes, exactly as it would be recorded, and saves nothing. | ledger.read |
Read only |
create_expenseRecord an expense |
Records an expense, split equally, by shares, by percentages, by amounts or by a receipt's items; the server works out each share. | ledger.write |
Writes |
record_paymentRecord a payment |
Records money one member paid another to settle up. | ledger.write |
Writes |
update_entryCorrect an entry |
Corrects an expense or payment, keeping its history. | ledger.write |
Writes; can overwrite or remove |
delete_entryDelete an entry |
Deletes an expense or payment; it stays in the history and can be restored. | ledger.write |
Writes; can overwrite or remove |
restore_entryRestore a deleted entry |
Restores a deleted expense or payment, so it counts in the balances again. | ledger.write |
Writes |
list_notesList a trip's notes and lists |
A trip's notes and lists, whole: the door code, the Wi-Fi, the shopping list. | ledger.read |
Read only |
get_noteGet a note or list |
One note or list in full. | ledger.read |
Read only |
create_noteMake a note or list |
Makes a note or a list that everyone on the trip sees and can edit. | ledger.write |
Writes |
update_noteChange a note |
Changes a note's title or text, or a list's title. | ledger.write |
Writes; can overwrite or remove |
add_list_itemAdd to a list |
Adds items to the end of a list. | ledger.write |
Writes |
check_list_itemTick off a list item |
Ticks an item off a list, or puts it back. | ledger.write |
Writes |
attach_photoAttach a photo to an entry |
Attaches a receipt photo to an entry, or returns a link to add it in the app. | ledger.write |
Writes |
create_groupCreate a group |
Creates a group (a trip in the app) with its people and currency. | ledger.manage |
Writes |
import_splitwiseImport a Splitwise group |
Imports a group from a Splitwise export, checked against its total balance. | ledger.write ledger.manage |
Writes |
update_groupChange a group |
Renames a group, or changes its currency or dates. | ledger.manage |
Writes; can overwrite or remove |
set_group_archivedArchive or reopen a group |
Archives a group when the trip is over, or reopens it. | ledger.manage |
Writes; can overwrite or remove |
get_invite_linkGet a group's invite link |
The link that lets people join a group. | ledger.manage |
Read only |
rotate_invite_linkReplace a group's invite link |
Replaces a group's invite link; the old one stops working. | ledger.manage |
Writes; can overwrite or remove |
add_memberAdd a person to a group |
Adds a person to a group. | ledger.manage |
Writes |
update_memberRename a person in a group |
Renames a person in a group, or changes the nicknames the assistant may hear. | ledger.manage |
Writes; can overwrite or remove |
set_member_activeTake a person out of a group, or bring them back |
Takes someone who left out of a group, or brings them back. | ledger.manage |
Writes; can overwrite or remove |
How it records
- Nothing without a yes. The server's instructions ask the assistant to show a preview (the group, date, place, total, who paid and each share) and record only after the person clearly agrees.
- Amounts are integer cents in the group's currency: 12.50 is
1250. For a split, the assistant sends how to split and the server works out each share to the cent. - Receipts: the assistant reads each line and who had it, and the server splits the total by the items, with service, tax and discounts shared in proportion. Numbers that don't add up are refused.
- The person's own words that asked for an expense are kept with it, so the group sees in the app what was said.
- Corrections send the entry's
version, so a change someone made meanwhile is never overwritten. Every change shows in the entry's history, marked with the assistant that made it.
Photos
JPEG, PNG or WebP, up to 10 MB each and 10 per entry. An assistant that can hand the
tool the file the person attached (ChatGPT) attaches it with attach_photo;
otherwise the tool returns a link where the person adds it in the app.
Errors and limits
A refused call is a tool result with isError and the text
CODE: message, where the message is written to be passed on to the person.
The codes an assistant is most likely to see:
INVALID_REQUEST,INVALID_MEMBER,INVALID_SPLIT,TOTAL_MISMATCH,RECEIPT_MISMATCH: the arguments don't fit (the message says which and why).NOT_FOUND: an unknown group, entry, note or member.VERSION_CONFLICT: the entry or note changed since it was read; read it again.ENTRY_DELETED: restore it first (restore_entry, or in the app).NOTE_DELETED: the note is in the trip's Deleted; restore it in the app first.LIST_FULL: a list holds at most 200 items.GROUP_ARCHIVED: reopen it in the app first.INVALID_IMAGE,TOO_MANY_ATTACHMENTS,PHOTO_UNAVAILABLE: a photo that can't be attached.INSUFFICIENT_SCOPE: the connection wasn't given the scope the tool needs.RATE_LIMITED: more than 60 tool calls a minute for one person.
Examples
- "Dinner was 120, I paid. Split it with Ana and Bruno." (
list_groups,get_group,create_expense) - A photo of a receipt: "Split this by what each of us had." (
create_expensewith the receipt's items, thenattach_photo) - "Who owes what in the Rio trip?" (
get_balances) - "Bruno paid me back 40." (
record_payment) - "What's the door code at the house?" (
list_notes) and "Add eggs to the shopping list." (list_notes,add_list_item) - "Create a trip Rio 2026 with Ana and Bruno, in BRL, and send me its invite link."
(
create_group,get_invite_link)
Data
The server receives what the assistant sends it: the details of each expense or payment and of each note or list it makes or changes, the person's words that asked for it, and a photo only when one is attached. It never sees the rest of the conversation. What Quits keeps, and for how long, is in the privacy policy; the rules are in the terms of service. Quits records debts; it never moves money.