# Omie (remote · api.mcp.ai)

Financial & accounting management on Omie (Brazil's leading cloud ERP), payables/receivables, financ

- Trust score: 64/100 (medium)
- Change this week: +5
- 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-omie-mcp/p-omie.md), [page](https://verifymcp.io/servers/mcp-dir-omie-mcp/p-omie)

## Channel facts

- Endpoint: `https://api.mcp.ai/p_omie`
- 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**: 66/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 4101 tokens (~117/item across 35 items; 35 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-omie-mcp https://api.mcp.ai/p_omie
```

### Codex

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

### opencode

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

### OpenClaw

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

### Hermes

```yaml
mcp_servers:
  mcp-dir-omie-mcp:
    url: "https://api.mcp.ai/p_omie"
```

### Other

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

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-02 (score 64, +9)

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

### 2026-08-01 (score 55, −8)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional regression] Schema quality: good → unverified
- [functional] Server version: 0.9.197 → 0.9.200
- [functional] New tool “omie_get_checking_account_balance”

### 2026-07-31 (score 63, +2)

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

### 2026-07-30 (score 61, +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 60, +1)

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

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

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

### 2026-07-27 (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-26 (score 58)

First indexed and scored.

## MCP tools (35)

### `omie_list_accounts` (~36 tokens)

Lista as empresas (CNPJ) Omie conectadas a este install — id, label.

Input parameters:

- `account` (string)

### `omie_list_payables` (~90 tokens)

Lista contas a pagar (ListarContasPagar). Paginado. Use `filters` (JSON) pra filtrar por data (filtrar_por_data_de/ate, DD/MM/AAAA), status, cliente, conta corrente etc.

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_get_payable` (~86 tokens)

Detalha uma conta a pagar (ConsultarContaPagar). Informe `codigo_lancamento_omie` (id Omie) OU `codigo_lancamento_integracao`. Use antes de editar (omie_update_payable).

Input parameters:

- `account` (string)
- `codigo_lancamento_integracao` (string)
- `codigo_lancamento_omie`

### `omie_create_payable` (~146 tokens)

Lança (cria) uma conta a pagar (IncluirContaPagar). `data` é um JSON string com os campos do payload da doc oficial — obrigatórios: codigo_lancamento_integracao (sua chave única), codigo_cliente_fornecedor (id do fornecedor, veja omie_list_customers), data_vencimento (DD/MM/AAAA), valor_documento, codigo_categoria, data_previsao (DD/MM/AAAA), id_conta_corrente (veja omie_list_checking_accounts). Doc: developer.omie.com.br (financas/contapagar).

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_update_payable` (~101 tokens)

Edita uma conta a pagar existente (AlterarContaPagar). `data` é um JSON string que DEVE conter a chave do lançamento (codigo_lancamento_omie OU codigo_lancamento_integracao) + os campos a alterar (ex.: data_vencimento, valor_documento, codigo_categoria, observacao). Consulte antes com omie_get_payable.

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_settle_payable` (~150 tokens)

Dá baixa (liquida/paga) uma conta a pagar (LancarPagamento). `data` é um JSON string com a chave do lançamento (codigo_lancamento, o id Omie — igual ao codigo_lancamento_omie do get — OU codigo_lancamento_integracao) + os dados da baixa: codigo_baixa_integracao (sua chave única da baixa, texto livre), valor, data (DD/MM/AAAA), codigo_conta_corrente (veja omie_list_checking_accounts) e opcional observacao. É o par pra conciliar com o Banco MCP.

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_delete_payable` (~112 tokens)

APAGA (exclui em definitivo) uma conta a pagar (ExcluirContaPagar). Informe `codigo_lancamento_omie` (id Omie) OU `codigo_lancamento_integracao`. Ação IRREVERSÍVEL — confirme com o usuário antes de chamar. Consulte antes com omie_get_payable pra ter certeza do lançamento.

Input parameters:

- `account` (string)
- `codigo_lancamento_integracao` (string)
- `codigo_lancamento_omie`

### `omie_list_receivables` (~106 tokens)

Lista contas a receber (ListarContasReceber). Paginado. `filters` (JSON) aceita filtrar_por_data_de/ate, filtrar_por_emissao_de/ate, filtrar_cliente, filtrar_por_status, filtrar_apenas_titulos_em_aberto (S/N) etc.

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_get_receivable` (~86 tokens)

Detalha uma conta a receber (ConsultarContaReceber). Informe `codigo_lancamento_omie` (id Omie) OU `codigo_lancamento_integracao`. Use antes de editar (omie_update_receivable).

Input parameters:

- `account` (string)
- `codigo_lancamento_integracao` (string)
- `codigo_lancamento_omie`

### `omie_create_receivable` (~146 tokens)

Lança (cria) uma conta a receber (IncluirContaReceber). `data` é um JSON string com os campos do payload da doc oficial — obrigatórios: codigo_lancamento_integracao (sua chave única), codigo_cliente_fornecedor (id do cliente, veja omie_list_customers), data_vencimento (DD/MM/AAAA), valor_documento, codigo_categoria, data_previsao (DD/MM/AAAA), id_conta_corrente (veja omie_list_checking_accounts). Doc: developer.omie.com.br (financas/contareceber).

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_update_receivable` (~101 tokens)

Edita uma conta a receber existente (AlterarContaReceber). `data` é um JSON string que DEVE conter a chave do lançamento (codigo_lancamento_omie OU codigo_lancamento_integracao) + os campos a alterar (ex.: data_vencimento, valor_documento, codigo_categoria, observacao). Consulte antes com omie_get_receivable.

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_settle_receivable` (~153 tokens)

Dá baixa (liquida/recebe) uma conta a receber (LancarRecebimento). `data` é um JSON string com a chave do lançamento (codigo_lancamento, o id Omie — igual ao codigo_lancamento_omie do get — OU codigo_lancamento_integracao) + os dados da baixa: codigo_baixa_integracao (sua chave única da baixa, texto livre), valor, data (DD/MM/AAAA), codigo_conta_corrente (veja omie_list_checking_accounts) e opcional observacao. É o par pra conciliar com o Banco MCP.

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_delete_receivable` (~112 tokens)

APAGA (exclui em definitivo) uma conta a receber (ExcluirContaReceber). Informe `codigo_lancamento_omie` (id Omie) OU `codigo_lancamento_integracao`. Ação IRREVERSÍVEL — confirme com o usuário antes de chamar. Consulte antes com omie_get_receivable pra ter certeza do lançamento.

Input parameters:

- `account` (string)
- `codigo_lancamento_integracao` (string)
- `codigo_lancamento_omie`

### `omie_list_financial_movements` (~152 tokens)

Lista movimentos financeiros — lançamentos/baixas de contas a pagar, a receber e conta corrente (ListarMovimentos). É a base da CONCILIAÇÃO (pareia com o Banco MCP). Paginado. `filters` (JSON) usa nomes Hungarian da Omie: dDtPagtoDe/dDtPagtoAte, dDtVencDe/dDtVencAte, cTpLancamento ("CP","CR","BX"), cStatus, nCodCC (conta corrente), nCodCliente etc.

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_list_checking_accounts` (~88 tokens)

Lista as contas correntes (bancos/caixa) cadastradas na empresa (ListarContasCorrentes). Útil pra mapear cada conta Omie ↔ a conta bancária do Banco MCP na conciliação.

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_get_checking_account_balance` (~259 tokens)

SALDO ATUAL de uma conta corrente (ListarExtrato do módulo financas/extrato) — o saldo REAL de hoje, ao contrário de omie_list_checking_accounts, que só traz o `saldo_inicial` numa data fixa (ponto de partida contábil). Base da CONCILIAÇÃO Banco × Omie. Identifique a conta por `conta` (nome OU id), ou por `nCodCC` (id Omie) ou `cCodCCInt` (chave de integração). Por padrão traz só os saldos (nSaldoAtual, nSaldoAnterior, nSaldoDisponivel, nSaldoConciliado, nSaldoProvisorio); passe `incluir_movimentos:true` pra vir também a lista de lançamentos do período. `data_inicial`/`data_final` (AAAA-MM-DD ou DD/MM/AAAA) definem o período dos movimentos, default hoje.

Input parameters:

- `account` (string)
- `cCodCCInt` (string)
- `conta`
- `data_final` (string)
- `data_inicial` (string)
- `incluir_movimentos` (boolean)
- `nCodCC`

### `omie_create_checking_account` (~136 tokens)

Cria uma conta corrente (banco/caixa/cartão) na empresa (IncluirContaCorrente). `data` é um JSON string com os campos da doc oficial — comuns: cCodCCInt (sua chave de integração), tipo_conta_corrente ("CX" caixa, "CC" conta corrente, "CA" cartão, "AD" adiantamento), codigo_banco, descricao, nome_agencia, numero_conta_corrente. Doc: developer.omie.com.br (geral/contacorrente).

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_update_checking_account` (~86 tokens)

Edita uma conta corrente existente (AlterarContaCorrente). `data` é um JSON string que DEVE conter a chave da conta (nCodCC id Omie OU cCodCCInt chave de integração) + os campos a alterar. Consulte antes com omie_list_checking_accounts.

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_delete_checking_account_entry` (~155 tokens)

APAGA/estorna um LANÇAMENTO de conta corrente (ExcluirLancCC) — movimentos da conta corrente como transferências, aplicações, resgates e tarifas, diferente de conta a pagar/receber (use omie_delete_payable/omie_delete_receivable pra títulos). Informe `nCodLanc` (id Omie do lançamento) OU `cCodIntLanc` (sua chave de integração). Ação IRREVERSÍVEL, confirme com o usuário antes de chamar. Doc: developer.omie.com.br (financas/contacorrentelancamentos).

Input parameters:

- `account` (string)
- `cCodIntLanc` (string)
- `nCodLanc`

### `omie_list_customers` (~75 tokens)

Lista clientes/fornecedores/transportadoras (ListarClientes). Paginado. `filters` (JSON) aceita os filtros do clientes_list_request da Omie.

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_get_customer` (~73 tokens)

Detalha um cliente/fornecedor (ConsultarCliente). Informe `codigo_cliente_omie` (id Omie) OU `codigo_cliente_integracao` (sua chave de integração).

Input parameters:

- `account` (string)
- `codigo_cliente_integracao` (string)
- `codigo_cliente_omie`

### `omie_create_customer` (~153 tokens)

Cadastra um cliente ou fornecedor (IncluirCliente). Na Omie cliente e fornecedor são o MESMO cadastro; o que muda é a classificação. `data` é um JSON string com os campos da doc oficial — obrigatórios: codigo_cliente_integracao (sua chave única), razao_social, cnpj_cpf (ou nome + doc pra PF); comuns: nome_fantasia, email, telefone1_numero, endereco, cidade, estado, cep. Pra marcar como fornecedor use tags: [{ "tag": "Fornecedor" }] (ou "Cliente"). Doc: developer.omie.com.br (geral/clientes).

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_update_customer` (~95 tokens)

Edita um cliente/fornecedor existente (AlterarCliente). `data` é um JSON string que DEVE conter a chave do cadastro (codigo_cliente_omie id Omie OU codigo_cliente_integracao) + os campos a alterar (ex.: razao_social, email, telefone1_numero, endereco). Consulte antes com omie_get_customer.

Input parameters:

- `account` (string)
- `data` (string, required)

### `omie_list_categories` (~89 tokens)

Lista as categorias / plano de contas da empresa (ListarCategorias). Paginado. Cada categoria tem um `codigo_categoria` — é o campo exigido ao lançar uma conta a pagar/receber (omie_create_payable/receivable).

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_list_departments` (~75 tokens)

Lista os departamentos / centros de custo da empresa (ListarDepartamentos). Paginado. Cada um tem um `codigo` usado pra ratear um lançamento por departamento.

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_list_projects` (~71 tokens)

Lista os projetos da empresa (ListarProjetos). Paginado. Cada projeto tem um `codigo` que pode ser vinculado a um lançamento financeiro.

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_list_document_types` (~65 tokens)

Lista os tipos de documento (dinheiro, boleto, cartão, cheque etc.) — PesquisarTipoDocumento. Não é paginado (lista fixa e curta). Cada tipo tem um `codigo` usado em baixas e lançamentos.

Input parameters:

- `account` (string)

### `omie_list_invoices` (~108 tokens)

Lista notas fiscais (NF-e) emitidas (ListarNF). Paginado. `filters` (JSON) aceita dEmiInicial/dEmiFinal (DD/MM/AAAA), filtrar_por_status (N=vigente, C=cancelada), tpNF (0=entrada,1=saída) etc.

Input parameters:

- `account` (string)
- `filters` (string)
- `page` (number)
- `page_size` (number)

### `omie_lancar` (~227 tokens)

Atalho: lança uma conta a PAGAR ou a RECEBER em UMA chamada, resolvendo os códigos por NOME no servidor (fornecedor/cliente, categoria e conta corrente). Substitui o fluxo de 4-5 chamadas (list_customers + list_categories + list_checking_accounts + create). Aceita nome OU código em cada campo; se um nome não bater ou for ambíguo, retorna erro com as opções ANTES de criar (não chuta). Datas aceitam AAAA-MM-DD ou DD/MM/AAAA. Use isto por padrão pra lançar; as tools omie_create_* continuam pra quem já tem os códigos.

Input parameters:

- `account` (string)
- `categoria` (required)
- `codigo_lancamento_integracao` (string)
- `conta_corrente` (required)
- `data_previsao` (string)
- `fornecedor` (required)
- `numero_documento` (string)
- `observacao` (string)
- `tipo` (string, required)
- `valor` (number, required)
- `vencimento` (string, required)

### `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-omie-mcp/p-omie#diagnostics

## Score history

- 2026-08-03: 64
- 2026-08-02: 64
- 2026-08-01: 55
- 2026-07-31: 63
- 2026-07-30: 61
- 2026-07-29: 60
- 2026-07-28: 59
- 2026-07-27: 59
- 2026-07-26: 58

## Links

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