# Conta Simples MCP server

Business finance on Conta Simples, bank and card statements, corporate cards (list/block/unblock), c

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-mcp-dir-contasimples-mcp
- Repository: https://github.com/mcp-dir/contasimples-mcp

## Install
- Endpoint: https://api.mcp.ai/p_contasimples
- Auth: Not captured

## Setup notes
- Remote endpoint: https://api.mcp.ai/p_contasimples

## Tools
- contasimples_list_accounts - Lista conexões Conta Simples (empresas) vinculadas a este install — id, label e apelido de exibição. Endpoint: https://api.mcp.ai/p_contasimples
- 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). Endpoint: https://api.mcp.ai/p_contasimples
- contasimples_balance - Saldo disponível da Conta PJ AGORA (valor instantâneo em BRL, direto da API, sem cache nem último-valor).
Retorna { amount } por conta. Use para relatórios de saldo em tempo real.
Opcional: accounts — agrega N empresas em paralelo (`accounts[]` + `errors[]`). Endpoint: https://api.mcp.ai/p_contasimples
- contasimples_bill - Faturas do cartão de crédito (valores em BRL). Sem due_date: lista as faturas (filtro status opcional), cada uma com total (totalAmount) e quanto falta pagar (amountToPay), datas de corte/vencimento e paymentStatus. Com due_date (YYYY-MM-DD): retorna os totalizadores + os itens (transações) daquela fatura.
Observação: a Conta Simples não expõe um campo de "limite disponível" do cartão via API; a fatura mostra o valor em aberto/a pagar, não o limite.
Opcional: accounts — agrega N empresas em paralelo (`accounts[]` + `errors[]`). Endpoint: https://api.mcp.ai/p_contasimples
- contasimples_card - Lista cartões corporativos (crédito).
Filtros opcionais: status (ACTIVATED|BLOCKED|CANCELLED|INACTIVATED), type (PHYSICAL|VIRTUAL), email, product_name, last4, limit, next_page_start_key.
Opcional: accounts — lista cartões de N empresas em paralelo (`accounts[]` + `errors[]`). `next_page_start_key` proibido quando accounts > 1; pagine por conta isoladamente. Endpoint: https://api.mcp.ai/p_contasimples
- 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. Endpoint: https://api.mcp.ai/p_contasimples
- 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. Endpoint: https://api.mcp.ai/p_contasimples
- contasimples_category - Lista categorias financeiras. Aceita `accounts` (agrupa por conta em `accounts[]`). Endpoint: https://api.mcp.ai/p_contasimples
- contasimples_cost_center - Lista centros de custo da empresa (id, name). Com cost_center_id: retorna um único centro de custo.
Use para classificar despesas em relatórios (o id casa com o costCenter das transações).
Opcional: accounts — agrupa por conta em `accounts[]`.

Bulk support: accepts cost_center_ids for batched execution. Endpoint: https://api.mcp.ai/p_contasimples
- contasimples_supplier - Lista fornecedores da empresa (id, name, type CUSTOM|DEFAULT). Sem paginação. Com supplier_id: retorna um único fornecedor.
Use para classificar despesas em relatórios.
Opcional: accounts — agrupa por conta em `accounts[]`.

Bulk support: accepts supplier_ids for batched execution. Endpoint: https://api.mcp.ai/p_contasimples
- 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. Endpoint: https://api.mcp.ai/p_contasimples
- 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. Endpoint: https://api.mcp.ai/p_contasimples
- 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. Endpoint: https://api.mcp.ai/p_contasimples
- contasimples_user - Lista usuários da empresa (email, limit, next_page_start_key opcionais). Aceita `accounts` (agrupa por conta). Endpoint: https://api.mcp.ai/p_contasimples
- 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. Endpoint: https://api.mcp.ai/p_contasimples
- contasimples_role - Lista papéis (roles) para convites de usuário. Aceita `accounts` (agrupa por conta). Endpoint: https://api.mcp.ai/p_contasimples
- 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. Endpoint: https://api.mcp.ai/p_contasimples
- 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. Endpoint: https://api.mcp.ai/p_contasimples
- show_version - Show the current MCP platform and adapter versions. Endpoint: https://api.mcp.ai/p_contasimples
- report_bug - Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. Endpoint: https://api.mcp.ai/p_contasimples
- connect - Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs. Endpoint: https://api.mcp.ai/p_contasimples
- toolkit_info - Returns the current toolkit state: installed MCPs, their connection status, and how many catalog tools each exposes. Endpoint: https://api.mcp.ai/p_contasimples
- marketplace - The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. Endpoint: https://api.mcp.ai/p_contasimples
- authenticate - MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link. Endpoint: https://api.mcp.ai/p_contasimples

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.mcp-dir
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 11, 2026
- Source: https://registry.modelcontextprotocol.io