editalmd
Brazilian public procurement (PNCP): search, deadlines, tender markdown, alerts and watches.
What it can do
What data it sees
Do you need an account
No: the server works without sign-in
Brazilian public procurement (PNCP): search, deadlines, tender markdown, alerts and watches.
How to connect
How to connect editalmd to Claude
The server address to paste into Claude settings:
https://editalmd.com/mcp
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect editalmd to ChatGPT
The server address to paste into ChatGPT settings:
https://editalmd.com/mcp
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect editalmd to Cursor
The server address to paste into Cursor settings:
https://editalmd.com/mcp
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (54)
Raw names from tools/list. Only developers need these.
| documentos_empresa | Lista os PDFs privados da empresa. Downloads binários usam GET HTTP autenticado /documentos/:arquivo. |
| anexar_documento_empresa | Envia comprovante PDF da empresa. Não inicia OCR. Sessão necessária; prefira HTTP para arquivos grandes. |
| remover_documento_empresa | Remove um comprovante da própria empresa; análises que o usavam ficam desatualizadas. |
| analisar_participacao | Inicia/retoma análise Luna com cadastro, anexos e edital. Só chame por solicitação do usuário; acompanhe por consultar_participacao. |
| consultar_participacao | Consulta estado, Pendências e Atendidos com motivos, ações e evidências. Nunca inicia análise. |
| minhas_empresas | Lista privada de empresas e seleção; envie a sessão Bearer. |
| buscar_empresa | Busca na base cadastral por CNPJ ou razão social; exige sessão. |
| adicionar_empresa | Importa e vincula o CNPJ à própria conta. |
| selecionar_empresa | Seleciona empresa cadastrada; não executa análise. |
| remover_empresa | Remove o vínculo somente da própria conta. |
| minha_conta | Identidade e contadores privados da sessão da conta (cookie) enviada no pedido MCP. |
| meus_documentos | Coleção privada da conta. Exige a sessão da conta (cookie + CSRF do navegador). |
| meus_compras | Coleção privada da conta. Exige a sessão da conta (cookie + CSRF do navegador). |
| documento_vincular | Vincula aquisição à conta da sessão usando a autorização privada comprada. |
| documento_acesso | Estado do acesso e código privado de recuperação, sem nova compra. |
| conta_acompanhamento | Confere vínculo de Salvas/Alertas à conta da sessão. |
| conta_vincular_acompanhamento | Vincula seu código de Salvas/Alertas à conta da sessão. |
| previa_alerta | Amostra gratuita de compras por termos/filtros ou sugestões editáveis pelo CNPJ. Não cria alertas. |
| editar_alerta | Edita interesse ou pausa/reativa o alerta do dono. Reativação além da franquia exige pagamento. Filtros substituem o recorte inteiro. |
| salvas | Lista as licitações salvas do dono. |
| salvar_compra | Salva a compra sem cobrança nem notificação, até 200 por dono. |
| remover_salva | Remove a compra da lista pessoal do dono. |
| gerar_markdown | Compra acesso individual por US$ 0,02/página (x402/crédito), inclusive ao texto pronto. Confira cotacao em estado_geracao. Guarde acesso.codigo para as tools de leitura; geração, se necessária, está incluída. Não use POST como polling. |
| estado_geracao | Acompanha as fases reais e a conclusão gratuitamente, sem iniciar processamento. |
| criar_cobranca | Reserva endereço USDC/Base para pagar US$ 0,02/página sem carteira no navegador. Confira cotacao antes, conserve cobranca_token. Não gera antes da confirmação real. |
| estado_cobranca | Consulta pagamento e liberação com o mesmo cobranca_token. Gratuito; intervalo mínimo 30 s; não inicia trabalho. |
| exemplos | Lista cinco provas reais gratuitas para conferir Markdown, PDF original e ZIP com imagens antes de gerar outro documento. |
| documento | Consulta grátis do título, tipo, páginas e compra vinculada a um documento. Use compra para listar os documentos relacionados. Não abre conteúdo nem inicia OCR. |
| documento_dossie | Itens, exigências, atestados, prazos e obrigações com condições, exceções e trechos/páginas. Usa o mesmo acesso_codigo da leitura. Não inicia IA. |
| documento_arquivos | Catálogo dos arquivos originais do documento, com links de download e páginas. Recursos preparados pelo Licitação; use /api/documento/{id}/original para baixar o original completo. |
| api_index | Índice da API do EditalMD: rotas, regime de cobrança e preço. |
| health | Saúde da origem e tamanho do acervo (compras e documentos com texto). |
| buscar_licitacao | Busca compras públicas do PNCP por termo. Grátis. Devolve objeto, órgão, UF, modalidade e o id da compra. |
| prazos | Prazos da compra: fim das propostas (do PNCP) e último dia de impugnação (estimado: 3 dias úteis antes da sessão, Lei 14.133 art. 164, feriados nacionais). Grátis. |
| compra | Ficha da compra e seus documentos no acervo (até 50), com títulos, tipos, páginas e disponibilidade. Consulta grátis; o acesso ao conteúdo é comprado por documento. |
| edital_markdown | Lê o Markdown com seu acesso_codigo comprado. Somente os cinco exemplos são gratuitos. Use gerar_markdown para comprar por US$ 0,02/página, inclusive quando pronto; reabra com o código recebido. |
| habilitacao | Lista de habilitação do edital, com trechos literais. Exige acesso_codigo do documento comprado, ou um dos cinco exemplos; nesta fase não há cobrança adicional pela lista. |
| documento_leitura | Manifesto do documento comprado: páginas, imagens, SHA-256 e versão. Envie acesso_codigo; exemplos são gratuitos. Não inicia OCR. A mesma autorização libera ZIP e imagens pela API. |
| criar_dono | Cria o token de dono (edm_…) que abre alertas e vigias, e o segredo whsec_… que assina os webhooks. Sem cadastro; o token é mostrado uma única vez — guarde e mande em Authorization: Bearer nas tools de alerta e vigia. |
| dono | Estado do dono (precisa do token edm_…): e-mail confirmado, franquia e o segredo whsec_… que assina cada webhook (Standard Webhooks: webhook-id, webhook-timestamp, webhook-signature). |
| rotacionar_segredo_webhook | Troca o segredo que assina os webhooks (precisa do token edm_…). O anterior ainda assina por 24 h, para trocar sem janela de falha. |
| criar_alerta | Alerta de compra nova por termos do objeto e UF (precisa do token edm_…). Canal pull (ler por alertas_compras), webhook (POST https assinado com o whsec_… do dono) ou email. O primeiro é grátis; os seguintes custam por 30 dias (x402 ou crédito). |
| alerta_por_cnpj | Alertas de compra nova pelo CNPJ da empresa (precisa do token edm_…): as atividades (CNAE) viram famílias de termos e sai um alerta por família, principal primeiro, até max_familias. O que passa da franquia é cobrado numa vez só (x402 ou crédito). CNAE fora do dicionário vem listado na resposta com familia nula. |
| cnaes | A lista de CNAE como o alerta por CNPJ a lê: descrição oficial (IBGE), família e termos do dicionário e fornecedores ativos no SICAF. Sem q, o ranking de quem mais vende para o governo. Grátis. |
| alertas_compras | Compras que já casaram com um alerta (canal pull), com prazos e status de entrega. Precisa do token edm_…. |
| vigiar_compra | Vigia uma compra (precisa do token edm_…): fotografa agora e registra eventos de retificação, documento novo, suspensão, prazo adiado e valor, mais avisos de prazo. A primeira é grátis; as seguintes custam até 30 dias após o encerramento. |
| vigia_eventos | Eventos de uma compra vigiada (o que mudou, de quê para quê, quando) e a fotografia atual. Precisa do token edm_…. |
| credito_saldo | Saldo e extrato do crédito pré-pago (precisa do token `cred_…`). |
| credito_recarregar | Recarrega crédito: paga uma vez com x402 (pacotes de 1, 5, 10 ou 25 dólares) e devolve o token que desconta em qualquer API da casa. |
| recibo | Recibo de uma entrega: preço, modo de pagamento e hash do conteúdo entregue. |
| api_access | Monthly data package and private purchase status, without charging. |
| api_access_buy | Buy 1,000 basic data reads for US$1, valid for 30 days. Requires explicit payment. |
| pricing | Current public prices and free allowances; no charge. |
| billing | Payment discovery and billing summary; does not create a charge. |