Conta Simples
Business finance on Conta Simples, bank and card statements, corporate cards (list/block/unblock), c
我該用這個嗎
品質與安全性
發現項目（3）
- LOWTool 'connect' description lacks action verb在 connect 中
- LOWTool 'contasimples_card_write_unblock' name length outside 3-30 range在 contasimples_card_write_unblock 中
- LOWTool 'contasimples_invite_write_create' name length outside 3-30 range在 contasimples_invite_write_create 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"contasimples-mcp": {
"url": "https://api.mcp.ai/p_contasimples"
}
}
}遠端端點
https://api.mcp.ai/p_contasimplesstreamable-http它能做什麼
工具清單
工具（24）
🟢contasimples_list_accounts(accounts)
Lista conexões Conta Simples (empresas) vinculadas a este install — id, label e apelido de exibição.
輸入結構描述
{
"type": "object",
"properties": {
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_summary(start_date, end_date, top_n, include_canceled, keywords, ...)
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",
"properties": {
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"top_n": {
"default": 10,
"type": "number"
},
"include_canceled": {
"default": false,
"type": "boolean"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"movement_type": {
"type": "string",
"enum": [
"in",
"out"
]
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"start_date",
"end_date"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_balance(accounts)
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",
"properties": {
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_bill(status, due_date, accounts)
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",
"properties": {
"status": {
"type": "string",
"enum": [
"CLOSED",
"OPEN",
"FUTURE",
"OVERDUE",
"EXPIRED"
]
},
"due_date": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_card(status, type, email, product_name, last4, ...)
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",
"properties": {
"status": {
"type": "string",
"enum": [
"ACTIVATED",
"BLOCKED",
"CANCELLED",
"INACTIVATED"
]
},
"type": {
"type": "string",
"enum": [
"PHYSICAL",
"VIRTUAL"
]
},
"email": {
"type": "string"
},
"product_name": {
"type": "string"
},
"last4": {
"type": "string"
},
"limit": {
"type": "number"
},
"next_page_start_key": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡contasimples_card_write_block(card_id, reason, accounts, card_ids)
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",
"properties": {
"card_id": {
"type": "string"
},
"reason": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"card_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"card_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡contasimples_card_write_unblock(card_id, reason, accounts, card_ids)
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",
"properties": {
"card_id": {
"type": "string"
},
"reason": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"card_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"card_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_category(accounts)
Lista categorias financeiras. Aceita `accounts` (agrupa por conta em `accounts[]`).
輸入結構描述
{
"type": "object",
"properties": {
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_cost_center(cost_center_id, accounts, cost_center_ids)
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",
"properties": {
"cost_center_id": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"cost_center_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_supplier(supplier_id, accounts, supplier_ids)
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",
"properties": {
"supplier_id": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"supplier_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_statement_card(start_date, end_date, limit, types, next_page_start_key, ...)
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",
"properties": {
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"limit": {
"type": "number"
},
"types": {
"type": "array",
"items": {
"type": "string"
}
},
"next_page_start_key": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_statement_banking(account_id, start_date, end_date, limit, sorting, ...)
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",
"properties": {
"account_id": {
"type": "string"
},
"start_date": {
"type": "string"
},
"end_date": {
"type": "string"
},
"limit": {
"type": "number"
},
"sorting": {
"type": "string"
},
"has_attachments": {
"type": "boolean"
},
"was_conciled": {
"type": "boolean"
},
"category_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"cost_center_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"responsible_email": {
"type": "string"
},
"status": {
"type": "number"
},
"amount_eq": {
"type": "string"
},
"amount_gt": {
"type": "string"
},
"amount_lt": {
"type": "string"
},
"next_page_start_key": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"movement_type": {
"type": "string",
"enum": [
"in",
"out"
]
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_attachment(attachment_id, accounts, attachment_ids)
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",
"properties": {
"attachment_id": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"attachment_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"attachment_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_user(email, limit, next_page_start_key, accounts)
Lista usuários da empresa (email, limit, next_page_start_key opcionais). Aceita `accounts` (agrupa por conta).
輸入結構描述
{
"type": "object",
"properties": {
"email": {
"type": "string"
},
"limit": {
"type": "number"
},
"next_page_start_key": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴contasimples_user_write_delete(user_id, accounts, user_ids)
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",
"properties": {
"user_id": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"user_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"user_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_role(accounts)
Lista papéis (roles) para convites de usuário. Aceita `accounts` (agrupa por conta).
輸入結構描述
{
"type": "object",
"properties": {
"accounts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contasimples_invite(status, role_id, limit, next_page_start_key, accounts, ...)
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",
"properties": {
"status": {
"type": "string"
},
"role_id": {
"type": "string"
},
"limit": {
"type": "number"
},
"next_page_start_key": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"role_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡contasimples_invite_write_create(role_id, email, accounts, role_ids)
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",
"properties": {
"role_id": {
"type": "string"
},
"email": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
}
},
"role_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"role_id",
"email"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢show_version
Show the current MCP platform and adapter versions.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡report_bug(message, context, conversation)
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
輸入結構描述
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
}
},
"required": [
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢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",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡marketplace(action, query, mcp_id, limit, tier_slug, ...)
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",
"properties": {
"action": {
"default": "search",
"type": "string",
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
]
},
"query": {
"default": "",
"type": "string"
},
"mcp_id": {
"default": "",
"type": "string"
},
"limit": {
"default": 10,
"type": "number"
},
"tier_slug": {
"default": "",
"type": "string"
},
"immediate": {
"default": false,
"type": "boolean"
},
"cancel_reason": {
"type": "string",
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
]
},
"cancel_comment": {
"default": "",
"type": "string"
},
"message": {
"default": "",
"type": "string"
},
"report_context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
},
"request_name": {
"default": "",
"type": "string"
},
"request_details": {
"default": "",
"type": "string"
},
"tool_id": {
"default": "",
"type": "string"
},
"arguments": {
"default": "{}",
"type": "string"
},
"prompt_slug": {
"default": "",
"type": "string"
},
"prompt_vars": {
"default": "{}",
"type": "string"
},
"prompt_category": {
"default": "",
"type": "string"
},
"prompt_tool": {
"default": "",
"type": "string"
},
"prompt_title": {
"default": "",
"type": "string"
},
"prompt_description": {
"default": "",
"type": "string"
},
"prompt_body": {
"default": "",
"type": "string"
},
"prompt_targets": {
"default": [],
"type": "array",
"items": {
"type": "string",
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡authenticate(token)
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",
"properties": {
"token": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}社群
證據