The Quits MCP server

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 (or server/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:

ScopeLets the assistant
ledger.readSee your groups, members, expenses, balances and notes.
ledger.writeAdd, correct and delete expenses and payments, attach photos, and make and edit notes and lists.
ledger.manageCreate 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.

ToolWhat it doesNeedsKind
list_groups
List 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_group
Get a group's members
A group's members, their nicknames, and which one is the user. ledger.read Read only
get_balances
Get balances
Who owes whom in a group, and a few payments that settle it. ledger.read Read only
list_entries
List expenses and payments
A group's recent expenses and payments, newest first. ledger.read Read only
get_entry
Get an entry
One expense or payment in full: who paid, each share, the itemised receipt. ledger.read Read only
preview_expense
Preview 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_expense
Record 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_payment
Record a payment
Records money one member paid another to settle up. ledger.write Writes
update_entry
Correct an entry
Corrects an expense or payment, keeping its history. ledger.write Writes; can overwrite or remove
delete_entry
Delete an entry
Deletes an expense or payment; it stays in the history and can be restored. ledger.write Writes; can overwrite or remove
restore_entry
Restore a deleted entry
Restores a deleted expense or payment, so it counts in the balances again. ledger.write Writes
list_notes
List 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_note
Get a note or list
One note or list in full. ledger.read Read only
create_note
Make a note or list
Makes a note or a list that everyone on the trip sees and can edit. ledger.write Writes
update_note
Change a note
Changes a note's title or text, or a list's title. ledger.write Writes; can overwrite or remove
add_list_item
Add to a list
Adds items to the end of a list. ledger.write Writes
check_list_item
Tick off a list item
Ticks an item off a list, or puts it back. ledger.write Writes
attach_photo
Attach 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_group
Create a group
Creates a group (a trip in the app) with its people and currency. ledger.manage Writes
import_splitwise
Import a Splitwise group
Imports a group from a Splitwise export, checked against its total balance. ledger.write ledger.manage Writes
update_group
Change a group
Renames a group, or changes its currency or dates. ledger.manage Writes; can overwrite or remove
set_group_archived
Archive or reopen a group
Archives a group when the trip is over, or reopens it. ledger.manage Writes; can overwrite or remove
get_invite_link
Get a group's invite link
The link that lets people join a group. ledger.manage Read only
rotate_invite_link
Replace a group's invite link
Replaces a group's invite link; the old one stops working. ledger.manage Writes; can overwrite or remove
add_member
Add a person to a group
Adds a person to a group. ledger.manage Writes
update_member
Rename 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_active
Take 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_expense with the receipt's items, then attach_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.

Support

[email protected]