The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Conta Simples listing page.
Gestão financeira PJ no Conta Simples, extratos bancário e de cartão, cartões corporativos (listar/bloquear/desbloquear), categorias, usuários, papéis e convites. Gere suas credenciais em https://ib.contasimples.com/integracoes/api/credenciais
English version · Documentação completa · Skill pra agentes
A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):
Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Conta Simples e URL https://api.mcp.ai/p_contasimples.
➕ Instalar Conta Simples no Cursor
➕ Instalar Conta Simples no VS Code
Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:
Detalhes por cliente: INSTALL.md.
| Tool | Descrição |
|---|---|
contasimples_list_accounts | Lista conexões Conta Simples (empresas) vinculadas a este install — id, label e apelido de exibição. |
contasimples_summary | Resumo agregado do período (bancário + cartão) — uma chamada em vez de paginar centenas de transações. Retorna totais (entradas/saídas, PIX/TED, cartão compras/IOF/estorno), top categorias e top estabelecimentos, cash_flow e flags _meta (truncated se passar do limite de páginas). Período máximo 62 dias (API). Por padrão só transações bancárias processadas (status=2); include_canceled=true busca todas e exclui canceladas (status=1) dos totais, contando-as em banking.canceled_excluded. Opcional: accounts — agrega N empresas em paralelo, resposta vem em accounts[] (uma entrada por conta) + errors[] se alguma falhar. Opcional: keywords — restrinja o agregado às transações cuja descrição/contraparte/categoria/tipo contenham qualquer uma das palavras (_meta.keyword_filter mostra matched vs scanned). |
contasimples_card | Lista cartões corporativos (crédito). Filtros opcionais: status (ACTIVATED |
contasimples_card_write_block | Mutações em cartão: block (body reason opcional), unblock. Aceita accounts com 1 entrada (ou omitido em install single-account) — o card_id existe em apenas uma empresa. [Flattened action: block] Bulk support: accepts card_ids for batched execution. |
contasimples_card_write_unblock | Mutações em cartão: block (body reason opcional), unblock. Aceita accounts com 1 entrada (ou omitido em install single-account) — o card_id existe em apenas uma empresa. [Flattened action: unblock] Bulk support: accepts card_ids for batched execution. |
contasimples_category | Lista categorias financeiras. Aceita accounts (agrupa por conta em accounts[]). |
contasimples_statement_card | Extrato de cartão de crédito. start_date e end_date (YYYY-MM-DD) emparelhados; janela ≤ 62 dias. types opcional (ex. PURCHASE). limit 5–100. Opcional: keywords — filtro textual client-side nesta página (_meta.keyword_filter). Opcional: accounts — agrega N empresas em paralelo (accounts[] + errors[]). next_page_start_key proibido quando accounts > 1; pagine por conta isoladamente. |
contasimples_statement_banking | Extrato bancário (transações). start_date e end_date devem vir juntos ou omitidos. No máximo um entre amount_eq, amount_gt, amount_lt. limit 1–50. Opcional: keywords — filtro textual client-side nesta página (_meta.keyword_filter). Opcional: accounts — agrega N empresas em paralelo (accounts[] + errors[]). next_page_start_key proibido quando accounts > 1; pagine por conta isoladamente. |
contasimples_attachment | Baixa anexo por ID (PNG/JPEG/PDF) — retorna content_base64, content_type, size_bytes. Aceita accounts com 1 entrada (ou omitido em install single-account). Bulk support: accepts attachment_ids for batched execution. |
contasimples_user | Lista usuários da empresa (email, limit, next_page_start_key opcionais). Aceita accounts (agrupa por conta). |
contasimples_user_write_delete | Remove usuário da empresa (DELETE na API). action: delete. Aceita accounts com 1 entrada. [Flattened action: delete] Bulk support: accepts user_ids for batched execution. |
contasimples_role | Lista papéis (roles) para convites de usuário. Aceita accounts (agrupa por conta). |
contasimples_invite | Lista convites pendentes ou histórico (status, role_id, limit, next_page_start_key). Aceita accounts (agrupa por conta). Bulk support: accepts role_ids for batched execution. |
contasimples_invite_write_create | Cria convite: action create com role_id e email. Aceita accounts com 1 entrada. [Flattened action: create] Bulk support: accepts role_ids for batched execution. |
Detalhe de cada tool: docs/ferramentas.md
Grátis.
O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.
Posso usar com agente próprio (não Claude/Cursor)?
Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_contasimples.
MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_contasimples é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.