# Conta Simples (remote · api.mcp.ai)

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

- Trust score: 64/100 (medium)
- Change this week: +7
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.mcp.ai`: 64/100 (this document), [markdown](https://verifymcp.io/servers/mcp-dir-contasimples-mcp/p-contasimples.md), [page](https://verifymcp.io/servers/mcp-dir-contasimples-mcp/p-contasimples)

## Channel facts

- Endpoint: `https://api.mcp.ai/p_contasimples`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2804 tokens (~116/item across 24 items; 24 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http mcp-dir-contasimples-mcp https://api.mcp.ai/p_contasimples
```

### Codex

```toml
[mcp_servers.mcp-dir-contasimples-mcp]
url = "https://api.mcp.ai/p_contasimples"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcp-dir-contasimples-mcp": {
      "type": "remote",
      "url": "https://api.mcp.ai/p_contasimples",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add mcp-dir-contasimples-mcp --url https://api.mcp.ai/p_contasimples --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  mcp-dir-contasimples-mcp:
    url: "https://api.mcp.ai/p_contasimples"
```

### Other

```json
{
  "mcpServers": {
    "mcp-dir-contasimples-mcp": {
      "type": "http",
      "url": "https://api.mcp.ai/p_contasimples"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 64, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: 0.9.200 → 0.9.201

### 2026-08-02 (score 63, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: 0.9.197 → 0.9.200

### 2026-08-01 (score 63, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “marketplace” rewrote its description, which is the text the model reads
- [functional] Server version: 0.9.196 → 0.9.197

### 2026-07-31 (score 62, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 59, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 58, +1)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: 0.9.183 → 0.9.190

### 2026-07-28 (score 57, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: 0.9.179 → 0.9.183

### 2026-07-27 (score 57, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (24)

### `contasimples_list_accounts` (~44 tokens)

Lista conexões Conta Simples (empresas) vinculadas a este install — id, label e apelido de exibição.

Input parameters:

- `accounts` (array)

### `contasimples_summary` (~261 tokens)

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).

Input parameters:

- `accounts` (array)
- `end_date` (string, required)
- `include_canceled` (boolean)
- `keywords` (array)
- `movement_type` (string)
- `start_date` (string, required)
- `top_n` (number)

### `contasimples_balance` (~82 tokens)

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[]`).

Input parameters:

- `accounts` (array)

### `contasimples_bill` (~168 tokens)

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[]`).

Input parameters:

- `accounts` (array)
- `due_date` (string)
- `status` (string)

### `contasimples_card` (~167 tokens)

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.

Input parameters:

- `accounts` (array)
- `email` (string)
- `last4` (string)
- `limit` (number)
- `next_page_start_key` (string)
- `product_name` (string)
- `status` (string)
- `type` (string)

### `contasimples_card_write_block` (~103 tokens)

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.

Input parameters:

- `accounts` (array)
- `card_id` (string, required)
- `card_ids` (array)
- `reason` (string)

### `contasimples_card_write_unblock` (~104 tokens)

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.

Input parameters:

- `accounts` (array)
- `card_id` (string, required)
- `card_ids` (array)
- `reason` (string)

### `contasimples_category` (~37 tokens)

Lista categorias financeiras. Aceita `accounts` (agrupa por conta em `accounts[]`).

Input parameters:

- `accounts` (array)

### `contasimples_cost_center` (~105 tokens)

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.

Input parameters:

- `accounts` (array)
- `cost_center_id` (string)
- `cost_center_ids` (array)

### `contasimples_supplier` (~94 tokens)

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.

Input parameters:

- `accounts` (array)
- `supplier_id` (string)
- `supplier_ids` (array)

### `contasimples_statement_card` (~163 tokens)

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.

Input parameters:

- `accounts` (array)
- `end_date` (string)
- `keywords` (array)
- `limit` (number)
- `next_page_start_key` (string)
- `start_date` (string)
- `types` (array)

### `contasimples_statement_banking` (~252 tokens)

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.

Input parameters:

- `account_id` (string)
- `accounts` (array)
- `amount_eq` (string)
- `amount_gt` (string)
- `amount_lt` (string)
- `category_ids` (array)
- `cost_center_ids` (array)
- `end_date` (string)
- `has_attachments` (boolean)
- `keywords` (array)
- `limit` (number)
- `movement_type` (string)
- `next_page_start_key` (string)
- `responsible_email` (string)
- `sorting` (string)
- `start_date` (string)
- `status` (number)
- `was_conciled` (boolean)

### `contasimples_attachment` (~87 tokens)

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.

Input parameters:

- `accounts` (array)
- `attachment_id` (string, required)
- `attachment_ids` (array)

### `contasimples_user` (~68 tokens)

Lista usuários da empresa (email, limit, next_page_start_key opcionais). Aceita `accounts` (agrupa por conta).

Input parameters:

- `accounts` (array)
- `email` (string)
- `limit` (number)
- `next_page_start_key` (string)

### `contasimples_user_write_delete` (~76 tokens)

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.

Input parameters:

- `accounts` (array)
- `user_id` (string, required)
- `user_ids` (array)

### `contasimples_role` (~40 tokens)

Lista papéis (roles) para convites de usuário. Aceita `accounts` (agrupa por conta).

Input parameters:

- `accounts` (array)

### `contasimples_invite` (~100 tokens)

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.

Input parameters:

- `accounts` (array)
- `limit` (number)
- `next_page_start_key` (string)
- `role_id` (string)
- `role_ids` (array)
- `status` (string)

### `contasimples_invite_write_create` (~83 tokens)

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.

Input parameters:

- `accounts` (array)
- `email` (string, required)
- `role_id` (string, required)
- `role_ids` (array)

### `show_version` (~17 tokens)

Show the current MCP platform and adapter versions.

### `report_bug` (~50 tokens)

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Input parameters:

- `context` (string)
- `conversation` (string)
- `message` (string, required)

### `connect` (~42 tokens)

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.

### `toolkit_info` (~30 tokens)

Returns the current toolkit state: installed MCPs, their connection status, and how many catalog tools each exposes.

### `marketplace` (~402 tokens)

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.

Input parameters:

- `action` (string)
- `arguments` (string)
- `cancel_comment` (string)
- `cancel_reason` (string)
- `conversation` (string)
- `immediate` (boolean)
- `limit` (number)
- `mcp_id` (string)
- `message` (string)
- `query` (string)
- `report_context` (string)
- `request_details` (string)
- `request_name` (string)
- `tier_slug` (string)
- `tool_id` (string)

### `authenticate` (~99 tokens)

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.

Input parameters:

- `token` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/mcp-dir-contasimples-mcp/p-contasimples#diagnostics

## Score history

- 2026-08-03: 64
- 2026-08-02: 63
- 2026-08-01: 63
- 2026-07-31: 62
- 2026-07-30: 59
- 2026-07-29: 58
- 2026-07-28: 57
- 2026-07-27: 57
- 2026-07-26: 56

## Links

- Remote endpoint: https://api.mcp.ai/p_contasimples
- Repository: https://github.com/mcp-dir/contasimples-mcp
- Changelog RSS feed: https://verifymcp.io/servers/mcp-dir-contasimples-mcp/p-contasimples/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/mcp-dir-contasimples-mcp/p-contasimples/changelog.json
- HTML version of this page: https://verifymcp.io/servers/mcp-dir-contasimples-mcp/p-contasimples