O servidor MCP do Quits deixa um assistente de IA ler e registrar os gastos compartilhados de uma pessoa: os grupos, quem pagou o quê, os saldos, e novos gastos e pagamentos. Esta página é para quem configura à mão, para desenvolvedores e para quem revisa os diretórios. Para só conectar o seu assistente, veja a Ajuda.
O servidor
- Endereço:
https://usequits.com/api/mcp - Transporte: Streamable HTTP, sem estado: cada requisição é uma mensagem JSON-RPC respondida em JSON. Sem sessões e sem server-sent events. Só remoto; não há nada para instalar.
- Versões do protocolo: 2026-07-28, 2025-11-25 e 2025-06-18.
- Recursos: ferramentas (tools), com instruções para o assistente na
resposta ao
initialize(ou aoserver/discover). Sem prompts nem resources.
Autenticação
OAuth 2.1 com PKCE (S256) e registro dinâmico de clientes: o assistente se registra
sozinho, então não há client id nem segredo para digitar. Uma requisição sem token válido
recebe 401 com um cabeçalho WWW-Authenticate que aponta para os
metadados:
https://usequits.com/.well-known/oauth-protected-resource/api/mcp(o recurso)https://usequits.com/.well-known/oauth-authorization-server(o servidor de autorização)
A pessoa entra com a conta do Quits (ou cria uma), confere se a página mostra o assistente e o e-mail dela, e escolhe Allow (a página de permissão é em inglês). Uma conexão pode receber estes escopos:
| Escopo | Deixa o assistente |
|---|---|
ledger.read | Ver seus grupos, membros, gastos, saldos e notas. |
ledger.write | Adicionar, corrigir e excluir gastos e pagamentos, anexar fotos, e criar e editar notas e listas. |
ledger.manage | Criar e alterar grupos e as pessoas deles, e cuidar dos links de convite. |
Para desconectar, abra Conta → Assistentes conectados no app. Trocar a senha do Quits desconecta todos os assistentes.
Ferramentas
Toda ferramenta precisa de ledger.read; a coluna diz o que mais ela precisa.
As que escrevem vêm marcadas (readOnlyHint falso), e as que podem sobrescrever
ou tirar algo trazem destructiveHint, para o assistente perguntar antes.
| Ferramenta | O que faz | Precisa | Tipo |
|---|---|---|---|
list_groupsList my groups |
Os grupos do usuário, com o saldo em cada um, e o grupo que combina com as pessoas citadas. | ledger.read |
Só leitura |
get_groupGet a group's members |
Os membros de um grupo, seus apelidos e qual deles é o usuário. | ledger.read |
Só leitura |
get_balancesGet balances |
Quem deve a quem num grupo, e poucos pagamentos para acertar. | ledger.read |
Só leitura |
list_entriesList expenses and payments |
Os gastos e pagamentos recentes de um grupo, do mais novo ao mais antigo. | ledger.read |
Só leitura |
get_entryGet an entry |
Um gasto ou pagamento completo: quem pagou, cada parte, a notinha item a item. | ledger.read |
Só leitura |
preview_expensePreview an expense |
Calcula a divisão de um gasto antes do seu sim, exatamente como seria registrado, sem salvar nada. | ledger.read |
Só leitura |
create_expenseRecord an expense |
Registra um gasto, dividido igualmente, por cotas, por porcentagens, por valores ou pelos itens da notinha; o servidor calcula cada parte. | ledger.write |
Escreve |
record_paymentRecord a payment |
Registra um pagamento de um membro a outro para acertar as contas. | ledger.write |
Escreve |
update_entryCorrect an entry |
Corrige um gasto ou pagamento, mantendo o histórico. | ledger.write |
Escreve; pode sobrescrever ou remover |
delete_entryDelete an entry |
Exclui um gasto ou pagamento; ele fica no histórico e pode ser restaurado. | ledger.write |
Escreve; pode sobrescrever ou remover |
restore_entryRestore a deleted entry |
Restaura um gasto ou pagamento excluído, que volta a contar nos saldos. | ledger.write |
Escreve |
list_notesList a trip's notes and lists |
As notas e listas de uma viagem, inteiras: o código da porta, o Wi-Fi, a lista de compras. | ledger.read |
Só leitura |
get_noteGet a note or list |
Uma nota ou lista completa. | ledger.read |
Só leitura |
create_noteMake a note or list |
Cria uma nota ou lista que todos da viagem veem e podem editar. | ledger.write |
Escreve |
update_noteChange a note |
Muda o título ou o texto de uma nota, ou o título de uma lista. | ledger.write |
Escreve; pode sobrescrever ou remover |
add_list_itemAdd to a list |
Adiciona itens ao fim de uma lista. | ledger.write |
Escreve |
check_list_itemTick off a list item |
Marca um item da lista como feito, ou o desmarca. | ledger.write |
Escreve |
attach_photoAttach a photo to an entry |
Anexa a foto da notinha a um lançamento, ou devolve um link para anexar no app. | ledger.write |
Escreve |
create_groupCreate a group |
Cria um grupo (uma viagem no app) com as pessoas e a moeda. | ledger.manage |
Escreve |
import_splitwiseImport a Splitwise group |
Importa um grupo de uma exportação do Splitwise, conferida pelo saldo total. | ledger.write ledger.manage |
Escreve |
update_groupChange a group |
Renomeia um grupo, ou muda a moeda ou as datas. | ledger.manage |
Escreve; pode sobrescrever ou remover |
set_group_archivedArchive or reopen a group |
Arquiva um grupo quando a viagem acaba, ou o reabre. | ledger.manage |
Escreve; pode sobrescrever ou remover |
get_invite_linkGet a group's invite link |
O link que permite entrar num grupo. | ledger.manage |
Só leitura |
rotate_invite_linkReplace a group's invite link |
Troca o link de convite de um grupo; o antigo deixa de funcionar. | ledger.manage |
Escreve; pode sobrescrever ou remover |
add_memberAdd a person to a group |
Adiciona uma pessoa a um grupo. | ledger.manage |
Escreve |
update_memberRename a person in a group |
Renomeia uma pessoa no grupo, ou muda os apelidos que o assistente pode ouvir. | ledger.manage |
Escreve; pode sobrescrever ou remover |
set_member_activeTake a person out of a group, or bring them back |
Tira do grupo alguém que saiu, ou o traz de volta. | ledger.manage |
Escreve; pode sobrescrever ou remover |
Como registra
- Nada sem um sim. As instruções do servidor pedem ao assistente que mostre uma prévia (o grupo, a data, o lugar, o total, quem pagou e cada parte) e só registre depois que a pessoa concordar claramente.
- Valores são centavos inteiros na moeda do grupo: 12,50 é
1250. Numa divisão, o assistente diz como dividir e o servidor calcula cada parte até o centavo. - Notinhas: o assistente lê cada linha e quem consumiu, e o servidor divide o total pelos itens, com serviço, impostos e descontos repartidos na proporção. Números que não fecham são recusados.
- As palavras da pessoa que pediram um gasto ficam guardadas com ele, para o grupo ver no app o que foi dito.
- Correções mandam a
versiondo lançamento, então uma mudança que alguém fez no meio-tempo nunca é sobrescrita. Toda alteração aparece no histórico do lançamento, marcada com o assistente que a fez.
Fotos
JPEG, PNG ou WebP, até 10 MB cada e 10 por lançamento. Um assistente que consegue passar
para a ferramenta o arquivo que a pessoa anexou (o ChatGPT) anexa com
attach_photo; senão a ferramenta devolve um link para a pessoa anexar no app.
Erros e limites
Uma chamada recusada é um resultado com isError e o texto
CÓDIGO: mensagem, em que a mensagem foi escrita para ser repassada à pessoa.
Os códigos que um assistente mais vê:
INVALID_REQUEST,INVALID_MEMBER,INVALID_SPLIT,TOTAL_MISMATCH,RECEIPT_MISMATCH: os argumentos não batem (a mensagem diz qual e por quê).NOT_FOUND: um grupo, lançamento, nota ou membro desconhecido.VERSION_CONFLICT: o lançamento ou a nota mudou desde a leitura; leia de novo.ENTRY_DELETED: restaure antes (restore_entry, ou no app).NOTE_DELETED: a nota está entre as apagadas da viagem; restaure no app antes.LIST_FULL: uma lista tem no máximo 200 itens.GROUP_ARCHIVED: reabra no app antes.INVALID_IMAGE,TOO_MANY_ATTACHMENTS,PHOTO_UNAVAILABLE: uma foto que não pode ser anexada.INSUFFICIENT_SCOPE: a conexão não recebeu o escopo que a ferramenta precisa.RATE_LIMITED: mais de 60 chamadas por minuto para uma pessoa.
Exemplos
- "O jantar deu 120, eu paguei. Divide com a Ana e o Bruno." (
list_groups,get_group,create_expense) - A foto de uma notinha: "Divide pelo que cada um consumiu." (
create_expensecom os itens da notinha, depoisattach_photo) - "Quem deve o quê na viagem ao Rio?" (
get_balances) - "O Bruno me devolveu 40." (
record_payment) - "Qual é o código da porta da casa?" (
list_notes) e "Coloca ovos na lista de compras." (list_notes,add_list_item) - "Cria uma viagem Rio 2026 com a Ana e o Bruno, em reais, e me manda o link de convite."
(
create_group,get_invite_link)
Dados
O servidor recebe o que o assistente manda: os detalhes de cada gasto ou pagamento e de cada nota ou lista que ele cria ou muda, as palavras da pessoa que o pediu, e uma foto só quando há uma anexada. Ele nunca vê o resto da conversa. O que o Quits guarda, e por quanto tempo, está na política de privacidade; as regras estão nos termos de uso. O Quits registra dívidas; nunca movimenta dinheiro.