mcp server

Omie

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

Description as published by the maintainer. Source

• version 0.1.0
• active

active — Registry entry last updated 2026-06-10.

What this server can do

35 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

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.

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.

marketplace(limit, query, action, mcp_id, message, tool_id, arguments, immediate, tier_slug, prompt_body, prompt_slug, prompt_tool, prompt_vars, conversation, prompt_title, request_name, cancel_reason, cancel_comment, prompt_targets, report_context, prompt_category, request_details, prompt_description)

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.

omie_create_checking_account(data, account)

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). Required: data.

omie_create_customer(data, account)

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). Required: data.

omie_create_payable(data, account)

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). Required: data.

omie_create_receivable(data, account)

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). Required: data.

omie_delete_checking_account_entry(account, nCodLanc, cCodIntLanc)

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

omie_delete_payable(account, codigo_lancamento_omie, codigo_lancamento_integracao)

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.

omie_delete_receivable(account, codigo_lancamento_omie, codigo_lancamento_integracao)

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.

omie_get_checking_account_balance(conta, nCodCC, account, cCodCCInt, data_final, data_inicial, incluir_movimentos)

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.

omie_get_customer(account, codigo_cliente_omie, codigo_cliente_integracao)

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

omie_get_payable(account, codigo_lancamento_omie, codigo_lancamento_integracao)

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

omie_get_receivable(account, codigo_lancamento_omie, codigo_lancamento_integracao)

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

omie_lancar(tipo, valor, account, categoria, fornecedor, observacao, vencimento, data_previsao, conta_corrente, numero_documento, codigo_lancamento_integracao)

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. Required: tipo, fornecedor, categoria, conta_corrente, valor, vencimento.

omie_list_accounts(account)

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

omie_list_categories(page, account, filters, page_size)

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

omie_list_checking_accounts(page, account, filters, page_size)

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.

omie_list_customers(page, account, filters, page_size)

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

omie_list_departments(page, account, filters, page_size)

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

omie_list_document_types(account)

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.

omie_list_financial_movements(page, account, filters, page_size)

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.

omie_list_invoices(page, account, filters, page_size)

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.

omie_list_payables(page, account, filters, page_size)

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.

omie_list_projects(page, account, filters, page_size)

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

omie_list_receivables(page, account, filters, page_size)

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.

omie_settle_payable(data, account)

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. Required: data.

omie_settle_receivable(data, account)

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. Required: data.

omie_update_checking_account(data, account)

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. Required: data.

omie_update_customer(data, account)

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. Required: data.

omie_update_payable(data, account)

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. Required: data.

omie_update_receivable(data, account)

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. Required: data.

report_bug(context, message, conversation)

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

show_version

Show the current MCP platform and adapter versions.

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.

Last successful function declaration observed on 2026-08-13. Source: https://api.mcp.ai/p_omie. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://api.mcp.ai/p_omie.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/mcp-dir/omie-mcp
• Remote endpoint (streamable-http) — https://api.mcp.ai/p_omie

Also from mcp-dir

• 99Pay MCP
  Connect your 99Pay account to AI via Brazil's Open Finance: balances, statements, cards, investments
• Ágora MCP
  Connect your Ágora account to AI via Brazil's Open Finance: balances, statements, cards, investments
• ASA MCP
  Connect your ASA account to AI via Brazil's Open Finance: balances, statements, cards, investments.
• Asaas
  Digital account and billing on Asaas with the full official REST API v3 (api.asaas.com), balance, ch
• Astrea (Aurum)
  Reporting and queries over Astrea (Aurum), Brazilian legal-practice software: cases per client, cale
• Atacadão MCP
  Connect your Atacadão account to AI via Brazil's Open Finance: balances, statements, cards, investme
• Investidor B3
  Your consolidated B3 investment portfolio (the central depository): position by asset, net worth, tr
• Banrisul MCP
  Connect your Banrisul account to AI via Brazil's Open Finance: balances, statements, cards, investme
• Banco do Brasil MCP
  Connect your Banco do Brasil account to AI via Brazil's Open Finance: balances, statements, cards, i
• Bity
  Bity crypto bank (Bitybank / Bitypreço), account balance per coin, market data (ticker, order book,