AgenticBooks

Livros que se constroem sozinhos.

Documentação

Servidor MCP AgenticBooks

Infraestrutura de dados financeiros para agentes de IA. Conecte o Claude (ou qualquer cliente MCP) diretamente aos livros contábeis de uma startup — leia P&L e saldos bancários em tempo real, revise e reclassifique transações, gerencie o plano de contas e conecte fontes bancárias — por meio de um servidor MCP remoto seguro, autenticado via OAuth.

Este é um servidor MCP hospedado (remoto). Você não instala nem faz self-host — você conecta seu cliente MCP ao endpoint do AgenticBooks e autentica com sua conta AgenticBooks. Este repositório é a listagem pública e o guia de conexão; o servidor em si é executado como infraestrutura gerenciada.

Site: https://www.agenticbooks.ai
Endpoint MCP: https://mcp.agenticbooks.ai/mcp
Transporte: Streamable HTTP
Autenticação: OAuth 2.0 (fluxo "Custom Connector" do Claude via Clerk) ou uma chave de API ab_

O que ele faz

O AgenticBooks ingere webhooks do Stripe, Mercury, RevenueCat e outras fontes, normaliza e classifica os eventos em contabilidade de partidas dobradas e sincroniza com QuickBooks/Xero. Este servidor MCP expõe esse livro-razão a um agente de IA para que o agente possa responder perguntas financeiras e executar ações contábeis em nome do usuário — cada escrita é registrada em trilha de auditoria e limitada à organização do chamador.

Exemplos de prompts típicos após a conexão:

"Qual é o nosso P&L do mês passado?"
"Quanto de caixa temos em todas as contas bancárias agora?"
"Mostre-me transações que ainda precisam de revisão, agrupadas por fornecedor."
"Reclassifique os encargos da Vercel como Hospedagem e lembre disso para a próxima vez."

Conectar

Claude (Desktop / Web) — Custom Connector (OAuth)

Abra Configurações → Conectores → Adicionar conector personalizado.
Insira a URL do servidor MCP: https://mcp.agenticbooks.ai/mcp
Conclua o login OAuth quando solicitado. Você autenticará com sua conta AgenticBooks; o acesso é limitado à sua organização.

Consulte o guia da Anthropic sobre conectores personalizados remotos: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

Cursor — instalar como plugin

Este repositório é um Agent Plugin: plugin.json carrega a identidade e mcp.json o servidor remoto. Instale-o no Cursor Directory ou aponte o Cursor para este repositório; o Cursor executa o login OAuth no primeiro uso.

Chave de API (qualquer cliente MCP via HTTP)

Se o seu cliente não suportar o fluxo de conector OAuth, autentique com uma chave de API ab_ (crie uma no painel do AgenticBooks) como token bearer:

{
  "mcpServers": {
    "agenticbooks": {
      "transport": "http",
      "url": "https://mcp.agenticbooks.ai/mcp",
      "headers": {
        "Authorization": "Bearer ab_your_api_key_here"
      }
    }
  }
}

Os dois modos de autenticação são independentes — OAuth e chaves ab_ funcionam; você só precisa de um.

Ferramentas

Todas as ferramentas operam dentro da organização autenticada. Leituras são não destrutivas; escritas são registradas em uma trilha de auditoria somente de acréscimo.

Relatórios e saldos

Ferramenta	O que faz
`get_financial_summary`	Snapshot em uma chamada: P&L do mês atual, saldos em todos os provedores conectados, contagem de eventos não revisados e saúde da sincronização do livro-razão.
`get_pnl_report`	Relatório de lucros e perdas em um intervalo de datas, construído a partir de eventos classificados.
`get_account_balance`	Saldos atuais nos provedores de dinheiro conectados da organização.
`get_bank_balances`	Posições bancárias, uma linha por banco conectado (Mercury, etc.).
`get_audit_log`	Lê a trilha de auditoria somente de acréscimo, do mais recente ao mais antigo.
`get_books_status`	Tudo o que um agente precisa primeiro: o que está conectado, cada fila aberta e o PRÓXIMO passo.
`get_transaction`	Detalhe completo de uma transação: lançamento, contraparte, evidência anexada, histórico de auditoria.
`get_billing_status`	Estado da assinatura AgenticBooks da organização (avaliação, ativa, carência, bloqueada).

Revisão e classificação

Ferramenta	O que faz
`get_unreviewed_events`	Lista eventos classificados que o mecanismo de regras não conseguiu categorizar com confiança.
`get_pending_by_counterparty`	Resume a fila de revisão agrupada por contraparte e direção.
`approve_classification`	Aprova um evento da fila de revisão atribuindo sua conta.
`reclassify_entry`	Altera a conta em um lançamento já contabilizado (com trilha de auditoria).
`list_suggested_transfers`	Pares de transferência banco a banco que o correspondente propôs, mas não pôde contabilizar com certeza.
`confirm_transfer`	Contabiliza um par de transferência sugerido como transferência interna (sem efeito no P&L).
`reject_transfer`	Rejeita um par sugerido para que ambas as pernas retornem à classificação comum.

Regras de contraparte (o mapa de fornecedores aprendido)

Ferramenta	O que faz
`create_counterparty_rule`	Cria/atualiza uma regra persistente mapeando uma contraparte para uma conta.
`list_counterparty_rules`	Lista as regras aprendidas de contraparte → conta da organização.
`update_counterparty_rule`	Redireciona uma regra existente para uma conta diferente (afeta eventos futuros).
`delete_counterparty_rule`	Remove uma regra; eventos futuros dessa contraparte param de ser classificados automaticamente.

Plano de contas

Ferramenta	O que faz
`list_chart_accounts`	Lista o plano de contas da organização (código, nome, tipo, ativo).
`add_chart_account`	Adiciona uma nova conta; o sistema atribui o código automaticamente.
`rename_chart_account`	Renomeia uma conta (o código nunca muda).
`set_chart_account_active`	Desativa ou reativa uma conta do plano.

Documentos (recibos e faturas)

Ferramenta	O que faz
`list_documents`	Recibos e faturas armazenados com seu status no pipeline; exibe propostas de correspondência abertas.
`attach_document`	Anexa um documento armazenado a uma transação como sua evidência (nunca contabiliza nada).

Períodos e integrações

Ferramenta	O que faz
`close_period`	Executa o fechamento de fim de mês, incluindo reavaliação cambial não realizada.
`reimport_historical`	Enfileira uma importação histórica em um intervalo escolhido.
`connect_mercury`	Conecta a organização ao Mercury via token de API somente leitura e com escopo.
`disconnect_mercury`	Desativa a integração Mercury da organização (com trilha de auditoria).
`connect_meow`	Conecta a organização ao Meow via chave de API somente leitura.
`disconnect_meow`	Desativa a integração Meow da organização (com trilha de auditoria).
`get_onboarding_status`	Walk somente de conexão (substituído por get_books_status).

Segurança

Cada chamada de ferramenta é autenticada (token de acesso OAuth ou chave de API ab_) e limitada a uma única organização.
Todas as escritas são registradas em uma trilha de auditoria somente de acréscimo.
Credenciais bancárias são armazenadas por organização e criptografadas em repouso; elas nunca são aceitas como, nem expostas via, argumentos de ferramenta MCP.