count

um livro-razão de despesas compartilhadas que seu agente opera. mcp remoto hospedado — cole uma url no claude, chatgpt ou cursor. sem repositório, sem processo local, sem chave de api para gerar. todos os outros no count recebem um link de compartilhamento sem cadastro. ferramentas: create_count, add_expense, get_balances, settle, add_member, list_counts. grátis.

Documentação

seis ferramentas. uma url. nenhuma api key para criar.

count é um servidor mcp remoto hospedado sobre http streamable. não há repositório para clonar, nenhum processo para manter vivo no seu laptop, e as outras pessoas no seu count nunca criam uma conta.

prove que está ativo

$ curl -s https://count.nanocorp.app/mcp/k_your_key

{
  "name": "count",
  "status": "ok",
  "transport": "streamable-http",
  "protocolVersion": "2025-06-18",
  "tools": [
    "create_count", "add_expense",
    "get_balances", "list_counts",
    "settle", "add_member"
  ]
}

o próprio mcp fala json-rpc sobre post para a mesma url. seu agente cuida dessa parte.

conecte

cole a url. essa é a integração inteira.

claude

  1. 01configurações → conectores
  2. 02adicionar conector personalizado
  3. 03cole a url, clique em adicionar

free, pro, max e team. no team, um proprietário adiciona primeiro nas configurações da organização.

chatgpt

  1. 01configurações → conectores → configurações avançadas
  2. 02ative o modo desenvolvedor
  3. 03criar → cole a url → sem autenticação → escanear ferramentas

no plus e pro, os conectores do chatgpt leem mas não escrevem hoje. peça saldos; escreva pelo claude, cursor ou pelo ledger web.

cursor

  1. 01abra ~/.cursor/mcp.json
  2. 02{"mcpServers":{"count":{"url":"…"}}}
  3. 03reinicie o cursor

um .cursor/mcp.json por repositório também funciona. deixe de fora qualquer campo type.

tutorial mais longo para claude, com as quatro telas e o que dizer primeiro: conecte claude a despesas compartilhadas

nenhuma key

ou cole a url pura e pule esta página.

https://count.nanocorp.app/mcp não exige key. adicione como conector e a primeira coisa que você disser abre um ledger. esta é a url nos diretórios, porque um diretório só pode carregar um endereço e tudo depois de /mcp/ é pessoal.

o detalhe, dito uma vez e claramente: esse ledger está vinculado à conversa em que você o abriu. então o primeiro resultado da ferramenta entrega sua própria url com key e diz para você trocá-la. faça isso e o count é seu de qualquer lugar. ignore e o count ainda existe — seu link de compartilhamento funciona para sempre — mas uma nova conversa na url pura começa uma vazia.

se você preferir ter a url permanente primeiro, pegue sua key e cole essa em vez disso. mesmas ferramentas, mesmo preço, sem troca depois.

o que a primeira chamada responde

made "flat" with 3 members: you, maya,
theo. share link: https://count.nanocorp.app/c/…
no signup for anyone who opens it.

this ledger is new and reachable from
this conversation only. to keep it,
paste https://count.nanocorp.app/mcp/k_…
into your connector settings in place
of https://count.nanocorp.app/mcp

as ferramentas

cada ferramenta, seus argumentos e o que retorna.

name

string, obrigatório

o que este count é: "flat", "viagem a tahoe"

members

string[]

as outras pessoas, pelo primeiro nome

currency

string

USD, EUR ou GBP. o padrão é USD

você diz

"crie um count para meu flat com maya e theo"

a ferramenta retorna

criado "flat" com 3 membros: você, maya, theo. link de compartilhamento: https://count.nanocorp.app/c/hq7fn2mkxd sem cadastro para quem abrir.

add_expense

Registra uma despesa compartilhada e retorna o novo saldo de cada membro.

description

string, obrigatório

no que o dinheiro foi gasto

amount

number|string, obrigatório

o total pago, 184.20

count

string

nome ou link. opcional se você tiver um count

paid_by

string

membro que pagou. o padrão é você

split_between

string[]

membros para dividir igualmente. o padrão é todos

shares

object

divisão desigual: {"maya": 40, "theo": 20}

você diz

"paguei $184.20 em compras, dividido em três"

a ferramenta retorna

registrado. compras, $184.20, pago por você. maya te deve $61.40. theo te deve $61.40.

get_balances

Lê quem deve a quem, mais as últimas cinco linhas. Sem escritas.

count

string

nome ou link

você diz

"quanto devo no count do flat"

a ferramenta retorna

flat: 3 membros, você, maya, theo. maya te deve $61.40. theo te deve $61.40. recente: 2026-08-22 compras $184.20 pago por você. link: https://count.nanocorp.app/c/hq7fn2mkxd

list_counts

Lista seus counts, cada um com seu próprio saldo e seu link. Sem escritas.

sem argumentos.

você diz

"quais counts eu tenho"

a ferramenta retorna

2 counts. flat — te devem $122.80 — https://count.nanocorp.app/c/hq7fn2mkxd | viagem a tahoe — zerado — https://count.nanocorp.app/c/w9dz4qm3rk

settle

Registra que dinheiro mudou de mãos fora do count. Omita amount para quitar integralmente.

from

string, obrigatório

membro que pagou o dinheiro

to

string, obrigatório

membro que recebeu

amount

number|string

omitir para limpar o que devem

count

string

nome ou link

você diz

"maya me pagou de volta $61.40"

a ferramenta retorna

quitado. maya te pagou $61.40 fora do count. theo te deve $61.40.

add_member

Adiciona uma pessoa a um count existente.

name

string, obrigatório

o primeiro nome dela

count

string

nome ou link

você diz

"adicione priya à viagem a tahoe"

a ferramenta retorna

priya adicionada à viagem a tahoe. os membros são: você, maya, theo, priya.

limites, claramente

  • free cobre 3 counts em uma key. um quarto precisa da licença vitalícia, $29.00, uma vez — o que é isso. os counts que você já tem nunca são tirados de você.
  • count registra quem deve a quem. ele não guarda, move ou transfere fundos, e nenhuma ferramenta vai afirmar que faz.
  • um link de compartilhamento é a única credencial que um count tem. qualquer um com ele pode ler e escrever. qualquer membro pode substituí-lo pela página do count.
  • uma moeda por count, definida quando é criado. count não converte.

solução de problemas

não está conectando.

o cliente rejeita a url, ou não lista ferramentas

rode o curl acima. se responder com os nomes das ferramentas, o endpoint está ativo e o problema está no cliente. cole a url novamente sem barra no final e nada depois da key.

o chatgpt vê as ferramentas mas não escreve

esperado no plus e pro: conectores em modo desenvolvedor só leem hoje. escrever exige um plano business. use claude ou cursor para escrever, ou o ledger web do próprio count.

status diz "unknown key"

a key foi substituída. abra o link de compartilhamento de qualquer count, reivindique seu nome de membro e crie uma nova em /key. a key antiga para de funcionar no momento em que a nova existe.

uma ferramenta respondeu com uma frase simples em vez de executar

esse é o design. toda falha retorna como uma frase que seu agente pode ler em voz alta, e nada é escrito quando isso acontece. uma falha silenciosa em um ledger de dinheiro é pior que uma interrupção.

ainda travado: envie um e-mail para hello@count.nanocorp.app.