{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_hur63v6t2h7u","handle":"conta-azul-mcp","url":"https://wellknown.network/agents/conta-azul-mcp","links":{"self":"https://wellknown.network/agents/conta-azul-mcp/record.json","html":"https://wellknown.network/agents/conta-azul-mcp","markdown":"https://wellknown.network/agents/conta-azul-mcp/record.md","api":"https://wellknown.network/api/v1/agents/conta-azul-mcp","status":"https://wellknown.network/api/v1/agents/conta-azul-mcp/status","claim":"https://wellknown.network/agents/conta-azul-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/conta-azul-mcp/claim.json","badge":"https://wellknown.network/agents/conta-azul-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air:api.mcp.ai:server:conta-azul-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"Conta Azul MCP","summary":"Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.","description":"Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.","publisher":{"name":"douglac","url":null},"homepage":null,"repository":"https://github.com/douglac/contaazul-mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":[],"pricing":null,"endpoints":[{"url":"https://api.mcp.ai/contaazul","type":"mcp_streamable_http","auth":null,"probeable":true}],"skills":null,"tools":null,"extra":{"updatedAt":"2026-05-29T14:35:17.084189Z","publishedAt":"2026-05-29T14:35:17.084189Z","registryName":"io.github.douglac/contaazul-mcp"},"attribution":{"kind":"mcp_registry","name":"mcp_registry","repoUrl":"mcp_registry","summary":"mcp_registry","version":"mcp_registry","description":"mcp_registry","publisherName":"mcp_registry"}},"derived":{"capabilities":[{"slug":"documents.invoice-processing","name":"Invoice Processing","confidence":1,"provenance":"derived"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":1,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.961,"provenance":"derived"},{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":0.948,"provenance":"derived"},{"slug":"productivity.crm","name":"CRM & Sales","confidence":0.859,"provenance":"derived"},{"slug":"finance.banking","name":"Banking","confidence":0.583,"provenance":"derived"},{"slug":"security.secrets","name":"Secrets Management","confidence":0.569,"provenance":"derived"},{"slug":"documents.contracts","name":"Contracts & Legal","confidence":0.525,"provenance":"derived"}],"categories":["commerce","documents","finance","productivity","security"]},"observed":{"status":"live","statusReason":"Responded 7h ago.","lastOkAt":"2026-09-08T12:23:56.097Z","lastProbedAt":"2026-09-08T12:23:56.097Z","statusComputedAt":"2026-09-08T12:45:10.763Z","reliability30d":{"probes":3,"successRate":1,"p50Ms":144},"latestObservations":[{"at":"2026-09-08T19:21:02.373Z","kind":"mcp_initialize","ok":true,"httpStatus":200,"latencyMs":349,"error":null,"detail":{"tools":[{"name":"contaazul_list_accounts","description":"Lista as empresas Conta Azul vinculadas a este install (company_id, label)."},{"name":"contaazul_get_company","description":"Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário)."},{"name":"contaazul_list_people","description":"Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil"},{"name":"contaazul_get_person","description":"Detalhe de uma pessoa por id.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_person_write_create","description":"Cria ou atualiza uma pessoa. action=create: requer nome, tipo_pessoa e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e APENAS os camp"},{"name":"contaazul_person_write_update","description":"Cria ou atualiza uma pessoa. action=create: requer nome, tipo_pessoa e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e APENAS os camp"},{"name":"contaazul_person_delete","description":"Remove uma pessoa por id. Operação destrutiva — confirme antes.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_list_products","description":"Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo."},{"name":"contaazul_product_write","description":"Cria um produto (nome + valor_venda obrigatórios em `data` JSON). A API v2 do Conta Azul não expõe atualização nem GET de produto por id — para consultar, use c"},{"name":"contaazul_list_services","description":"Lista serviços cadastrados."},{"name":"contaazul_service_write","description":"Cria um serviço. `data` é JSON com nome, valor, etc."},{"name":"contaazul_list_sales","description":"Lista vendas. Filtros: tamanho_pagina, pagina, data_inicio, data_fim (YYYY-MM-DD), cliente_id, status_venda.\n\nBulk support: accepts cliente_ids for batched exec"},{"name":"contaazul_get_sale","description":"Detalhe de uma venda por id.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_sale_write_create","description":"Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON.\n\n[Flattened action: create]\n"},{"name":"contaazul_sale_write_update","description":"Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON.\n\n[Flattened action: update]\n"},{"name":"contaazul_sale_cancel","description":"Cancela uma venda. Operação destrutiva — confirme antes.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_list_contracts","description":"Lista contratos no intervalo de data de início (data_inicio/data_fim, YYYY-MM-DD — obrigatórios na API; se omitidos, usa janela ampla = listar todos). Filtros: "},{"name":"contaazul_contract_write","description":"Cria um contrato. `data` é o payload em JSON."},{"name":"contaazul_list_receivables","description":"Lista contas a receber (parcelas de receita). Filtros: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD; se omitidas, lista todas), s"},{"name":"contaazul_receivable_create","description":"Cria um evento financeiro de conta a receber. `data` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS: data_competencia (YYYY-MM-DD), valor (number), observaca"},{"name":"contaazul_list_payables","description":"Lista contas a pagar (parcelas de despesa). Filtros: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD; se omitidas, lista todas), sta"},{"name":"contaazul_payable_create","description":"Cria um evento financeiro de conta a pagar. `data` é o JSON do EventoFinanceiroRequest (mesma estrutura do contaazul_receivable_create: data_competencia, valor,"},{"name":"contaazul_list_installments","description":"Lista as parcelas de UM evento financeiro (passe `id_evento`). A API v2 não tem listagem chapada de todas as parcelas — pra varrer contas a receber/pagar use co"},{"name":"contaazul_get_installment","description":"Detalhe de uma parcela por id.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_update_installment","description":"Atualiza campos de uma parcela (PATCH). Campos editáveis em `data` JSON: nota, descricao, vencimento (YYYY-MM-DD), composicao_valor:{valor_bruto,multa,juros,des"},{"name":"contaazul_list_financial_accounts","description":"Lista contas financeiras (banco, caixa, cartão). Filtre por `tipos`: APLICACAO, CAIXINHA, CONTA_CORRENTE, CARTAO_CREDITO, INVESTIMENTO, OUTROS, MEIOS_RECEBIMENT"},{"name":"contaazul_get_account_balance","description":"Saldo atual de uma conta financeira por id (banco/caixa/cartão). Pegue o id em contaazul_list_financial_accounts.\n\nBulk support: accepts ids for batched executi"},{"name":"contaazul_list_categories","description":"Lista categorias financeiras (DRE)."},{"name":"contaazul_list_cost_centers","description":"Lista centros de custo."},{"name":"contaazul_list_invoices_nfe","description":"Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status."},{"name":"contaazul_get_invoice_nfe","description":"Detalhe de uma NF-e por id.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_list_invoices_nfse","description":"Lista NFS-e (notas fiscais de serviço) por filtro. Exige data_competencia_de e data_competencia_ate (YYYY-MM-DD), com janela máxima de 15 dias (se omitidas, usa"},{"name":"contaazul_settle_installment","description":"Registra a baixa (recebimento/pagamento) de uma parcela. `id` é o UUID da PARCELA (via contaazul_list_receivables / _list_payables / _get_installment). `data` é"},{"name":"contaazul_list_settlements","description":"Lista as baixas de uma parcela. `id` é o UUID da parcela.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_get_settlement","description":"Detalhe de uma baixa por id. `id` é o UUID da baixa.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_update_settlement","description":"Atualiza uma baixa (PATCH). `id` é o UUID da baixa. `data` é o JSON com os campos a alterar (data_pagamento, composicao_valor, conta_financeira em UUID string, "},{"name":"contaazul_delete_settlement","description":"Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_list_transfers","description":"Lista transferências entre contas financeiras por período (conciliação). data_inicio e data_fim (YYYY-MM-DD) com janela máxima de 1 ano (se omitidas, usa os últ"},{"name":"contaazul_get_initial_balance","description":"Saldos iniciais das contas financeiras por período. data_inicio e data_fim (YYYY-MM-DD ou ISO date-time; datas simples são normalizadas). Se omitidas, usa uma j"},{"name":"contaazul_list_changed_events","description":"Lista os IDs de eventos financeiros alterados num período (para sync incremental / conciliação). data_inicio e data_fim (YYYY-MM-DD ou ISO date-time). Paginado."},{"name":"contaazul_generate_charge","description":"Gera cobrança (boleto, pix ou link de pagamento) para uma ou mais PARCELAS de contas a receber. Aceita até 50 parcelas por chamada; cada uma é emitida separadam"},{"name":"contaazul_get_charge","description":"Detalhe de uma cobrança emitida por id (o `id` devolvido em contaazul_generate_charge). Retorna {id, url, status} — status vai de AGUARDANDO_CONFIRMACAO/REGISTR"},{"name":"contaazul_cancel_charge","description":"CANCELA uma cobrança já emitida (boleto/pix/link deixa de ser pagável). Use quando a cobrança foi gerada errada e ainda não foi paga. Passe o `id` da cobrança ("},{"name":"contaazul_get_contract","description":"Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor).\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_contract_next_number","description":"Retorna o próximo número de contrato disponível."},{"name":"contaazul_terminate_contract","description":"Encerra um contrato por id. Operação sensível, confirme antes.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_delete_contract","description":"Remove um contrato por id. Operação destrutiva, confirme antes.\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_list_budgets","description":"Lista orçamentos (cliente, número, total, situação, versão). Paginado."},{"name":"contaazul_get_budget","description":"Detalhe de um orçamento por id (itens, cliente, composição de valor).\n\nBulk support: accepts ids for batched execution."},{"name":"contaazul_create_budget","description":"Cria um orçamento. `data` é o JSON com id_cliente (obrigatório, UUID de uma pessoa com perfil Cliente), data_orcamento (obrigatório, YYYY-MM-DD), itens[] (cada "},{"name":"contaazul_delete_budgets","description":"Exclui orçamentos em lote por id. Operação destrutiva, confirme antes. `ids` é a lista de UUIDs de orçamento (a API v2 não tem exclusão por id única)."},{"name":"show_version","description":"Show the current MCP platform and adapter versions."},{"name":"report_bug","description":"Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction."},{"name":"connect","description":"Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns conn"},{"name":"toolkit_info","description":"Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes."},{"name":"marketplace","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\","},{"name":"authenticate","description":"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