O servidor MCP do Quits

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 ao server/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:

EscopoDeixa o assistente
ledger.readVer seus grupos, membros, gastos, saldos e notas.
ledger.writeAdicionar, corrigir e excluir gastos e pagamentos, anexar fotos, e criar e editar notas e listas.
ledger.manageCriar 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.

FerramentaO que fazPrecisaTipo
list_groups
List 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_group
Get a group's members
Os membros de um grupo, seus apelidos e qual deles é o usuário. ledger.read Só leitura
get_balances
Get balances
Quem deve a quem num grupo, e poucos pagamentos para acertar. ledger.read Só leitura
list_entries
List expenses and payments
Os gastos e pagamentos recentes de um grupo, do mais novo ao mais antigo. ledger.read Só leitura
get_entry
Get an entry
Um gasto ou pagamento completo: quem pagou, cada parte, a notinha item a item. ledger.read Só leitura
preview_expense
Preview 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_expense
Record 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_payment
Record a payment
Registra um pagamento de um membro a outro para acertar as contas. ledger.write Escreve
update_entry
Correct an entry
Corrige um gasto ou pagamento, mantendo o histórico. ledger.write Escreve; pode sobrescrever ou remover
delete_entry
Delete an entry
Exclui um gasto ou pagamento; ele fica no histórico e pode ser restaurado. ledger.write Escreve; pode sobrescrever ou remover
restore_entry
Restore a deleted entry
Restaura um gasto ou pagamento excluído, que volta a contar nos saldos. ledger.write Escreve
list_notes
List 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_note
Get a note or list
Uma nota ou lista completa. ledger.read Só leitura
create_note
Make a note or list
Cria uma nota ou lista que todos da viagem veem e podem editar. ledger.write Escreve
update_note
Change 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_item
Add to a list
Adiciona itens ao fim de uma lista. ledger.write Escreve
check_list_item
Tick off a list item
Marca um item da lista como feito, ou o desmarca. ledger.write Escreve
attach_photo
Attach 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_group
Create a group
Cria um grupo (uma viagem no app) com as pessoas e a moeda. ledger.manage Escreve
import_splitwise
Import a Splitwise group
Importa um grupo de uma exportação do Splitwise, conferida pelo saldo total. ledger.write ledger.manage Escreve
update_group
Change a group
Renomeia um grupo, ou muda a moeda ou as datas. ledger.manage Escreve; pode sobrescrever ou remover
set_group_archived
Archive or reopen a group
Arquiva um grupo quando a viagem acaba, ou o reabre. ledger.manage Escreve; pode sobrescrever ou remover
get_invite_link
Get a group's invite link
O link que permite entrar num grupo. ledger.manage Só leitura
rotate_invite_link
Replace 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_member
Add a person to a group
Adiciona uma pessoa a um grupo. ledger.manage Escreve
update_member
Rename 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_active
Take 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 version do 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_expense com os itens da notinha, depois attach_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.

Suporte

[email protected]