MCPサーバー

Conta Simples

io.github.mcp-dir/contasimples-mcp

このMCPでできること

Manages Conta Simples business banking, balances, statements, invoices, corporate cards, users, categories, suppliers, and cost centers.

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.
冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'token': {'type': 'string'}}}
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['attachment_id'], 'properties': {'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'attachment_id': {'type': 'string'}, 'attachment_ids': {'type': 'array', 'items': {'type': 'string'}}}}
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[]`).
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'accounts': {'type': 'array', 'items': {'type': 'string'}}}}
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[]`).
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'status': {'enum': ['CLOSED', 'OPEN', 'FUTURE', 'OVERDUE', 'EXPIRED'], 'type': 'string'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'due_date': {'type': 'string'}}}
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'type': {'enum': ['PHYSICAL', 'VIRTUAL'], 'type': 'string'}, 'email': {'type': 'string'}, 'last4': {'type': 'string'}, 'limit': {'type': 'number'}, 'status': {'enum': ['ACTIVATED', 'BLOCKED', 'CANCELLED', 'INACTIVATED'], 'type': 'string'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'product_name': {'type': 'string'}, 'next_page_start_key': {'type': 'string'}}}
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.
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['card_id'], 'properties': {'reason': {'type': 'string'}, 'card_id': {'type': 'string'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'card_ids': {'type': 'array', 'items': {'type': 'string'}}}}
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.
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['card_id'], 'properties': {'reason': {'type': 'string'}, 'card_id': {'type': 'string'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'card_ids': {'type': 'array', 'items': {'type': 'string'}}}}
contasimples_category
Lista categorias financeiras. Aceita `accounts` (agrupa por conta em `accounts[]`).
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'accounts': {'type': 'array', 'items': {'type': 'string'}}}}
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'cost_center_id': {'type': 'string'}, 'cost_center_ids': {'type': 'array', 'items': {'type': 'string'}}}}
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number'}, 'status': {'type': 'string'}, 'role_id': {'type': 'string'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'role_ids': {'type': 'array', 'items': {'type': 'string'}}, 'next_page_start_key': {'type': 'string'}}}
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.
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['role_id', 'email'], 'properties': {'email': {'type': 'string'}, 'role_id': {'type': 'string'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'role_ids': {'type': 'array', 'items': {'type': 'string'}}}}
contasimples_list_accounts
Lista conexões Conta Simples (empresas) vinculadas a este install — id, label e apelido de exibição.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'accounts': {'type': 'array', 'items': {'type': 'string'}}}}
contasimples_role
Lista papéis (roles) para convites de usuário. Aceita `accounts` (agrupa por conta).
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'accounts': {'type': 'array', 'items': {'type': 'string'}}}}
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number'}, 'status': {'type': 'number'}, 'sorting': {'type': 'string'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'end_date': {'type': 'string'}, 'keywords': {'type': 'array', 'items': {'type': 'string'}}, 'amount_eq': {'type': 'string'}, 'amount_gt': {'type': 'string'}, 'amount_lt': {'type': 'string'}, 'account_id': {'type': 'string'}, 'start_date': {'type': 'string'}, 'category_ids': {'type': 'array', 'items': {'type': 'string'}}, 'was_conciled': {'type': 'boolean'}, 'movement_type': {'enum': ['in', 'out'], 'type': 'string'}, 'cost_center_ids': {'type': 'array', 'items': {'type': 'string'}}, 'has_attachments': {'type': 'boolean'}, 'responsible_email': {'type': 'string'}, 'next_page_start_key': {'type': 'string'}}}
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number'}, 'types': {'type': 'array', 'items': {'type': 'string'}}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'end_date': {'type': 'string'}, 'keywords': {'type': 'array', 'items': {'type': 'string'}}, 'start_date': {'type': 'string'}, 'next_page_start_key': {'type': 'string'}}}
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).
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['start_date', 'end_date'], 'properties': {'top_n': {'type': 'number', 'default': 10}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'end_date': {'type': 'string'}, 'keywords': {'type': 'array', 'items': {'type': 'string'}}, 'start_date': {'type': 'string'}, 'movement_type': {'enum': ['in', 'out'], 'type': 'string'}, 'include_canceled': {'type': 'boolean', 'default': False}}}
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'supplier_id': {'type': 'string'}, 'supplier_ids': {'type': 'array', 'items': {'type': 'string'}}}}
contasimples_user
Lista usuários da empresa (email, limit, next_page_start_key opcionais). Aceita `accounts` (agrupa por conta).
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'email': {'type': 'string'}, 'limit': {'type': 'number'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'next_page_start_key': {'type': 'string'}}}
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.
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['user_id'], 'properties': {'user_id': {'type': 'string'}, 'accounts': {'type': 'array', 'items': {'type': 'string'}}, 'user_ids': {'type': 'array', 'items': {'type': 'string'}}}}
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. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
外部アクセスあり
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'default': 10}, 'query': {'type': 'string', 'default': ''}, 'action': {'enum': ['search', 'describe', 'install', 'uninstall', 'subscribe', 'cancel', 'resume', 'report_bug', 'request_mcp', 'list_tools', 'invoke', 'search_prompts', 'get_prompt', 'publish_prompt'], 'type': 'string', 'default': 'search'}, 'mcp_id': {'type': 'string', 'default': ''}, 'message': {'type': 'string', 'default': ''}, 'tool_id': {'type': 'string', 'default': ''}, 'arguments': {'type': 'string', 'default': '{}'}, 'immediate': {'type': 'boolean', 'default': False}, 'tier_slug': {'type': 'string', 'default': ''}, 'prompt_body': {'type': 'string', 'default': ''}, 'prompt_slug': {'type': 'string', 'default': ''}, 'prompt_tool': {'type': 'string', 'default': ''}, 'prompt_vars': {'type': 'string', 'default': '{}'}, 'conversation': {'type': 'string', 'default': '[]'}, 'prompt_title': {'type': 'string', 'default': ''}, 'request_name': {'type': 'string', 'default': ''}, 'cancel_reason': {'enum': ['too_expensive', 'missing_features', 'switched_service', 'unused', 'customer_service', 'too_complex', 'low_quality', 'other'], 'type': 'string'}, 'cancel_comment': {'type': 'string', 'default': ''}, 'prompt_targets': {'type': 'array', 'items': {'enum': ['claude', 'chatgpt', 'cursor', 'lovable'], 'type': 'string'}, 'default': []}, 'report_context': {'type': 'string', 'default': ''}, 'prompt_category': {'type': 'string', 'default': ''}, 'request_details': {'type': 'string', 'default': ''}, 'prompt_description': {'type': 'string', 'default': ''}}}
report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message'], 'properties': {'context': {'type': 'string', 'default': ''}, 'message': {'type': 'string'}, 'conversation': {'type': 'string', 'default': '[]'}}}
show_version
Show the current MCP platform and adapter versions.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
追加
authenticate
2026年9月17日12:43
追加
marketplace
2026年9月17日12:43
追加
toolkit_info
2026年9月17日12:43
追加
connect
2026年9月17日12:43
追加
report_bug
2026年9月17日12:43
追加
show_version
2026年9月17日12:43
追加
contasimples_invite_write_create
2026年9月17日12:43
追加
contasimples_invite
2026年9月17日12:43
追加
contasimples_role
2026年9月17日12:43
追加
contasimples_user_write_delete
2026年9月17日12:43
追加
contasimples_user
2026年9月17日12:43
追加
contasimples_attachment
2026年9月17日12:43
追加
contasimples_statement_banking
2026年9月17日12:43
追加
contasimples_statement_card
2026年9月17日12:43
追加
contasimples_supplier
2026年9月17日12:43
追加
contasimples_cost_center
2026年9月17日12:43
追加
contasimples_category
2026年9月17日12:43
追加
contasimples_card_write_unblock
2026年9月17日12:43
追加
contasimples_card_write_block
2026年9月17日12:43
追加
contasimples_card
2026年9月17日12:43
追加
contasimples_bill
2026年9月17日12:43
追加
contasimples_balance
2026年9月17日12:43
追加
contasimples_summary
2026年9月17日12:43
追加
contasimples_list_accounts
2026年9月17日12:43