Server definition
- Hash
- sha256:95b780846cac6fa7be2a868d8d56eb0fa048aeae8b000fd58cbc88cc835c06e8
- What it is
- What a remote MCP server returned when asked what it offers: 67 tools
The blob, as servednamed by its sha256
{
"instructions": "Superfície de agente do EditalMD. Toda tool é uma chamada na API pública de https://editalmd.com. Catálogo e cota: https://editalmd.com/api/ · spec: https://editalmd.com/openapi.json. Cota estourada responde 402 com accepts[] (x402/USDC) — pague e repita a chamada.",
"tools": [
{
"description": "As licitações com proposta aberta, publicadas nos últimos 7 dias, na UF e nos CNAEs de quem fornece o mesmo que esta compra, as de maior valor primeiro, e o corpo do alerta que as entrega (para `criar_alerta`). Útil quando a compra consultada já encerrou. Grátis. As compras publicadas nos últimos 7 dias, com proposta ainda aberta, na UF da compra e nos 3 CNAEs que mais costumam vencer compras como ela (`GET /api/compra/:id/cnaes`); sem CNAE, pelos termos do objeto. É a mesma leitura da prévia do alerta (`POST /api/alertas/previa`), e `alerta` traz o corpo que cria esse alerta em `POST /api/alertas` (acrescente o `canal`). O resultado é do ramo e da UF, guardado por 30 minutos; com a casa ocupada ou a origem fora, `estado` diz isso e `itens` vem vazio. É o que a ficha de uma licitação encerrada mostra ao lado do campo do alerta grátis.",
"inputSchema": {
"properties": {
"id": {
"description": "id da compra (vem da busca)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "abertas_do_ramo",
"outputSchema": null
},
{
"description": "Importa e vincula o CNPJ ao próprio dono. 201 ao criar, 200 na repetição sem nova consulta/escrita. Até 20 empresas. Importa os dados cadastrais disponíveis, sem sócios ou contatos; nenhuma análise é iniciada.",
"inputSchema": {
"properties": {
"cnpj": {
"description": "CNPJ completo, 14 dígitos com verificação válida.",
"type": "string"
}
},
"required": [
"cnpj"
],
"type": "object"
},
"name": "adicionar_empresa",
"outputSchema": null
},
{
"description": "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. Dois modos. Por `termos`: espaço exige todas as palavras, `|` aceita qualquer uma do grupo (`uniforme|fardamento escolar`). Por `cnpj`: o cadastro da empresa informa as atividades (CNAE), o dicionário (`GET /api/cnaes`) transforma cada CNAE numa família de termos e sai um alerta por família distinta, principal primeiro, até `max_familias`; CNAE fora do dicionário não vira alerta e é listado em `empresa.cnaes` com `familia: null`. O primeiro alerta ativo é grátis (`FRANQUIA_ALERTAS`); os seguintes custam `PRECO_ALERTA` por 30 dias cada — no modo CNPJ, numa cobrança só (N × preço), por x402 ou crédito. O cron confere a cada 30 minutos. Canal e-mail exige a sessão da conta — o aviso vai para o e-mail verificado dela, sem código de confirmação — e só existe com `EMAIL_ALERTAS=1`.",
"inputSchema": {
"properties": {
"canal": {
"default": "pull",
"description": "pull, webhook ou email (padrão pull)",
"enum": [
"pull",
"webhook",
"email"
],
"type": "string"
},
"cnpj": {
"description": "CNPJ com 14 dígitos, com ou sem pontuação",
"type": "string"
},
"destino": {
"description": "URL https (webhook); ignorado no pull e no email (vai para o e-mail da conta)",
"type": "string"
},
"filtros": {
"additionalProperties": false,
"description": "Recorte adicional: modalidades, municípios, exclusões, valores, propostas abertas e CNAEs. PATCH substitui o recorte inteiro; {} limpa.",
"properties": {
"abertas": {
"type": "boolean"
},
"cnaes": {
"items": {
"pattern": "^\\d{4}-?\\d/?\\d{2}$",
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"excluir": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"modalidades": {
"items": {
"maximum": 13,
"minimum": 1,
"type": "integer"
},
"maxItems": 10,
"type": "array"
},
"municipios": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"valor_max": {
"minimum": 0,
"type": "number"
},
"valor_min": {
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"max_familias": {
"default": 8,
"description": "1 a 8 (padrão 8): quantas famílias viram alerta",
"type": "number"
},
"uf": {
"description": "Sigla da UF (opcional)",
"type": "string"
}
},
"required": [
"cnpj"
],
"type": "object"
},
"name": "alerta_por_cnpj",
"outputSchema": null
},
{
"description": "Compras que já casaram com um alerta (canal pull), com prazos e status de entrega. Precisa do token edm_….",
"inputSchema": {
"properties": {
"antes_compra": {
"description": "proximo_antes da página anterior",
"type": "number"
},
"id": {
"description": "id do alerta",
"type": "string"
},
"limite": {
"description": "1 a 100 (padrão 50)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "alertas_compras",
"outputSchema": null
},
{
"description": "Inicia/retoma análise com cadastro, anexos e edital. Só chame por solicitação do usuário; acompanhe por consultar_participacao. 202 após aceitar e preservar o pedido; 200 ao reaproveitar análise concluída. Usa perfil e anexos deste dono. Pedidos interrompidos podem ser retomados; falhas informam motivo e próxima ação. POST explícito retoma uma pausa. Até 2 mil fatos e 100 editais por empresa, sujeitos à capacidade e ao orçamento disponíveis. Não cobra nova compra nesta operação. Acompanhamento somente por GET. A análise oferece triagem com evidências, não decisão definitiva de habilitação nem consulta jurídica externa.",
"inputSchema": {
"properties": {
"cnpj": {
"description": "CNPJ de 14 dígitos vinculado ao dono.",
"type": "string"
},
"id": {
"description": "ID do documento.",
"type": "integer"
},
"v": {
"description": "SHA-256 do Markdown aberto, 64 hex minúsculos.",
"type": "string"
}
},
"required": [
"cnpj",
"id",
"v"
],
"type": "object"
},
"name": "analisar_participacao",
"outputSchema": null
},
{
"description": "Envia comprovante PDF da empresa. Não inicia OCR. Sessão necessária; prefira HTTP para arquivos grandes. 201. JSON até 11.200.000 bytes; PDF até 8 MiB, 20 documentos/80 MiB/50 páginas por empresa. Arquivo idêntico é reaproveitado. A leitura automática acontece somente ao solicitar a análise.",
"inputSchema": {
"properties": {
"arquivo_base64": {
"description": "PDF em base64, até 8 MiB decodificado.",
"type": "string"
},
"cnpj": {
"description": "CNPJ de 14 dígitos vinculado ao dono.",
"type": "string"
},
"nome": {
"description": "Nome do PDF.",
"type": "string"
},
"tipo": {
"description": "atestado, certidao, licenca, contrato_social ou outro.",
"type": "string"
}
},
"required": [
"cnpj",
"nome",
"tipo",
"arquivo_base64"
],
"type": "object"
},
"name": "anexar_documento_empresa",
"outputSchema": null
},
{
"description": "Monthly data package and private purchase status, without charging.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_pass": {
"description": "Private pass: api_<32 random hex>_<64 random hex>. Save before buying.",
"type": "string"
}
},
"type": "object"
},
"name": "api_access",
"outputSchema": null
},
{
"description": "Buy 1,000 basic data reads for US$1, valid for 30 days. Requires explicit payment. Same pass in retries recovers the same purchase. No automatic renewal. OCR, AI, documents and delivery keep their own tariffs. Send X-API-Pass on eligible data reads; remaining credits come in X-API-Credits-Remaining.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_pass": {
"description": "Private pass: api_<32 random hex>_<64 random hex>. Save before buying.",
"type": "string"
},
"credit_token": {
"description": "Existing prepaid credit token.",
"type": "string"
},
"payment": {
"description": "Signed x402 payload, after authorizing the quote.",
"type": "string"
},
"transaction": {
"description": "Base transaction hash to reconcile an uncertain payment with the same pass and original payload.",
"type": "string"
}
},
"required": [
"api_pass"
],
"type": "object"
},
"name": "api_access_buy",
"outputSchema": null
},
{
"description": "Índice da API do EditalMD: rotas, regime de cobrança e preço.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "api_index",
"outputSchema": null
},
{
"description": "Atas de registro de preço vigentes no PNCP pelo objeto, as mais relevantes primeiro: órgão gerenciador, vigência, se aceita adesão (carona) e o link da ata. Grátis. Busca as atas de registro de preço publicadas no PNCP que ainda valem (não canceladas, vigência até hoje ou depois), as mais relevantes para os termos primeiro: o órgão gerenciador, o objeto, a vigência, se aceita adesão (a carona) e o endereço da ata no PNCP. `adesao=1` traz só as que aceitam. A ficha da compra (`/api/compra/:id`) traz as atas que ela gerou. `Accept: text/html` abre a aba Atas vigentes com os termos.",
"inputSchema": {
"properties": {
"adesao": {
"description": "1 para só as que aceitam adesão (opcional)",
"type": "string"
},
"pagina": {
"description": "0 a 49 (padrão 0)",
"type": "number"
},
"q": {
"description": "Termos do objeto, mínimo 3 letras",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "atas_vigentes",
"outputSchema": null
},
{
"description": "Texto nativo/OCR básico de PDF até 50 páginas/32 MiB, sem revisão nem tabelas estruturadas. Até 100 documentos por agente. Não libera premium. Não cobra. Franquia por credencial, até a menor data entre os 30 dias do agente e o fim do piloto. Repetição do mesmo documento não consome outra unidade. Não envie pagamento. Premium: guarde evaluation.access_code e use X-Editalmd-Avaliacao junto de X-Agent-Pass nas leituras e no GET /geracao. Básico não abre conteúdo premium. Piloto sujeito ao orçamento global; sem renovação automática.",
"inputSchema": {
"properties": {
"agent_pass": {
"description": "Credencial individual persistente obtida em POST https://api.editalmd.com/licitacoes/api/agente. Não é User-Agent.",
"type": "string"
},
"id": {
"description": "ID do documento do acervo.",
"type": "number"
}
},
"required": [
"agent_pass",
"id"
],
"type": "object"
},
"name": "avaliacao_basico",
"outputSchema": null
},
{
"description": "Acompanhe a leitura básica após retry_after_s e recupere texto por página com hash da fonte. Não cobra. Franquia por credencial, até a menor data entre os 30 dias do agente e o fim do piloto. Repetição do mesmo documento não consome outra unidade. Não envie pagamento. Premium: guarde evaluation.access_code e use X-Editalmd-Avaliacao junto de X-Agent-Pass nas leituras e no GET /geracao. Básico não abre conteúdo premium. Piloto sujeito ao orçamento global; sem renovação automática.",
"inputSchema": {
"properties": {
"agent_pass": {
"description": "Credencial individual persistente obtida em POST https://api.editalmd.com/licitacoes/api/agente. Não é User-Agent.",
"type": "string"
},
"id": {
"description": "ID do documento do acervo.",
"type": "number"
}
},
"required": [
"agent_pass",
"id"
],
"type": "object"
},
"name": "avaliacao_basico_resultado",
"outputSchema": null
},
{
"description": "Cota individual: um premium e 100 básicos, com validade. Não cobra.",
"inputSchema": {
"properties": {
"agent_pass": {
"description": "Credencial individual persistente obtida em POST https://api.editalmd.com/licitacoes/api/agente. Não é User-Agent.",
"type": "string"
}
},
"required": [
"agent_pass"
],
"type": "object"
},
"name": "avaliacao_cotas",
"outputSchema": null
},
{
"description": "Use seu único premium patrocinado em um documento de até 50 páginas. Guarde evaluation.access_code como avaliacao_codigo e acompanhe por estado_geracao com agent_pass. Repetir recupera o mesmo acesso. Franquia por credencial, até a menor data entre os 30 dias do agente e o fim do piloto. Repetição do mesmo documento não consome outra unidade. Não envie pagamento. Premium: guarde evaluation.access_code e use X-Editalmd-Avaliacao junto de X-Agent-Pass nas leituras e no GET /geracao. Básico não abre conteúdo premium. Piloto sujeito ao orçamento global; sem renovação automática.",
"inputSchema": {
"properties": {
"agent_pass": {
"description": "Credencial individual persistente obtida em POST https://api.editalmd.com/licitacoes/api/agente. Não é User-Agent.",
"type": "string"
},
"id": {
"description": "ID do documento do acervo.",
"type": "number"
}
},
"required": [
"agent_pass",
"id"
],
"type": "object"
},
"name": "avaliacao_premium",
"outputSchema": null
},
{
"description": "Payment discovery and billing summary; does not create a charge.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "billing",
"outputSchema": null
},
{
"description": "Busca na base cadastral por CNPJ ou razão social; exige conta ou convidado.",
"inputSchema": {
"properties": {
"q": {
"description": "CNPJ completo ou nome de 3 a 120 caracteres.",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "buscar_empresa",
"outputSchema": null
},
{
"description": "Busca compras públicas por termo. Grátis. Devolve objeto, órgão, UF, modalidade e o id da compra.",
"inputSchema": {
"properties": {
"abertas": {
"description": "'1' para só compras com prazo de proposta aberto",
"enum": [
"1"
],
"type": "string"
},
"limite": {
"description": "1 a 50 (padrão 20)",
"type": "number"
},
"q": {
"description": "Termo de busca, mínimo 3 letras",
"type": "string"
},
"uf": {
"description": "Sigla da UF (opcional)",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "buscar_licitacao",
"outputSchema": null
},
{
"description": "Sugestões de termos de busca por atividade econômica (CNAE), com descrição, família e indicadores de cobertura. Grátis. Sem `q`, lista atividades com mais fornecedores registrados. Com `q`, busca por prefixo do código (`1412`, `1412-6/01`) ou por palavra da descrição. `familia`/`termos` nulos dizem que o CNAE ainda não está no dicionário: um alerta por CNPJ não o usa.",
"inputSchema": {
"properties": {
"limite": {
"description": "1 a 100 (padrão 20)",
"type": "number"
},
"q": {
"description": "Prefixo do código (1412) ou palavra da descrição (opcional)",
"type": "string"
}
},
"type": "object"
},
"name": "cnaes",
"outputSchema": null
},
{
"description": "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. Servida do cache da borda por até 6 horas — a ficha raramente muda; prazos e preços são calculados a cada pedido. `Cache-Control: no-cache` no pedido lê a origem na hora. O cabeçalho `x-origem-cache` diz `hit`, `miss` ou `bypass`.",
"inputSchema": {
"properties": {
"id": {
"description": "id da compra (vem da busca)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "compra",
"outputSchema": null
},
{
"description": "Endereços de um CEP com coordenada (CNEFE/IBGE) e as empresas registradas nele. 10 grátis por dia; depois, do saldo. Uma consulta, paga como a do CNPJ: franquia grátis do dia, depois o saldo. Devolve até 20 endereços e até 20 empresas; o total de endereços vem em `pontos_total`.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cep": {
"description": "CEP com 8 dígitos",
"type": "string"
}
},
"required": [
"cep"
],
"type": "object"
},
"name": "consulta_cep",
"outputSchema": null
},
{
"description": "Ficha de empresa pelo CNPJ (Receita), com a situação especial quando há (falência, recuperação judicial, liquidação), as sanções dela (CEIS, CNEP, CEPIM, leniência, TCU e o CNIA do CNJ, conferido na hora), os sócios na lista de pessoas expostas politicamente (CGU), a situação fiscal (dívida ativa da União, parcelamentos, benefícios e obras), o risco socioambiental (lista suja do trabalho escravo, embargos e autos do Ibama), os contratos com o governo (PNCP, o federal desde 2013 e as vendas a prefeituras paulistas do TCE-SP) e os financiamentos do BNDES, os registros em órgãos reguladores e cadastros oficiais (CVM, Banco Central, ANS, ANTT, ANP, ANEEL, Anatel, Anvisa, CNES, Cadastur, Ibama, ANAC e SICAF), os fundos de investimento da CVM e o endereço no mapa (CNEFE/IBGE). 10 grátis por dia; depois, do saldo (plano ou pacote) da conta ou do crédito. Uma consulta: sai da franquia grátis do dia (10 por rede) e, depois dela, do saldo da conta ou do crédito (plano ou pacote). Sem franquia nem saldo, 402 com as ofertas. Aceita o CNPJ numérico e o alfanumérico. Não encontrado, fonte fora do ar ou limite por minuto não são cobrados. O dado pessoal da ficha vem mascarado. Em `sancoes`, o que os cadastros públicos registram contra a empresa inteira (a raiz do CNPJ): CEIS, CNEP, CEPIM e acordos de leniência da CGU e licitantes inidôneos do TCU, atualizados todo dia — serve para checar fornecedor em lote.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cnpj": {
"description": "CNPJ, com ou sem pontuação",
"type": "string"
}
},
"required": [
"cnpj"
],
"type": "object"
},
"name": "consulta_cnpj",
"outputSchema": null
},
{
"description": "Compra o pacote avulso ou um plano da consulta de CNPJ e endereço. Exige pagamento explícito: sem ele, devolve o 402 com o preço (crédito pré-pago ou x402). O saldo fica com a conta (cookie da sessão ou `X-Api-Key: mmk_…`) ou, sem conta, com a carteira do crédito que pagou (`X-Credito`). Sem pagamento, 402 com o preço e as portas: crédito pré-pago (comprado também por Pix) ou x402. Plano soma 30 dias e a quota dele ao que já existe; o pacote vale 90 dias. Sem renovação automática.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"compra": {
"description": "Marca desta compra (8 a 64 caracteres A-Za-z0-9_-)",
"type": "string"
},
"credit_token": {
"description": "Token do crédito pré-pago (cred_…)",
"type": "string"
},
"oferta": {
"description": "pacote, basico, profissional ou empresa",
"type": "string"
},
"payment": {
"description": "Pagamento x402 assinado, a partir da cotação",
"type": "string"
}
},
"required": [
"oferta"
],
"type": "object"
},
"name": "consulta_comprar",
"outputSchema": null
},
{
"description": "A franquia grátis de hoje, o pacote avulso e os três planos da consulta de CNPJ e endereço, e o saldo de quem pede. Não cobra. Sem credencial mostra a franquia e as ofertas; com a conta (cookie ou `X-Api-Key: mmk_…`) ou o crédito (`X-Credito`), também o saldo, que vale em todos os portais da casa (Radar CNPJ, PontoFato, EditalMD).",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "consulta_planos",
"outputSchema": null
},
{
"description": "Consulta estado, Pendências e Atendidos com motivos, ações e evidências. Nunca inicia análise. Pendências reúne precisa_comprovar (falta prova), divergente (evidência incompatível) e acompanhar (obrigação futura). Cadastro, anexos ou dossiê diferentes retornam outdated sem resultados atuais. A data de referência é conservada na retomada; dia anterior retorna data_atual=false. Os lotes validados continuam disponíveis durante falhas/processamento com parcial=true e processados/total; nunca representam conclusão das exigências ainda não comparadas. GET não executa a fila nem inicia IA.",
"inputSchema": {
"properties": {
"after": {
"description": "Último ID recebido; padrão 0.",
"type": "integer"
},
"cnpj": {
"description": "CNPJ de 14 dígitos vinculado ao dono.",
"type": "string"
},
"grupo": {
"description": "pendencias, atendidos ou nao_aplicavel.",
"type": "string"
},
"id": {
"description": "ID do documento.",
"type": "integer"
},
"kind": {
"description": "requirement, attestation ou obligation.",
"type": "string"
},
"limit": {
"description": "1 a 30; padrão 30.",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"v": {
"description": "SHA-256 do Markdown aberto, 64 hex minúsculos.",
"type": "string"
}
},
"required": [
"cnpj",
"id",
"v"
],
"type": "object"
},
"name": "consultar_participacao",
"outputSchema": null
},
{
"description": "Confere que Salvas/Alertas/Vigias são da conta da sessão. As listas de um convidado edm_… passam para a conta em `POST /api/auth/claim`; o POST desta rota responde 410 com o caminho.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "conta_acompanhamento",
"outputSchema": null
},
{
"description": "Traz para a conta da sessão o que o convidado edm_… criou (o claim do SDK): as Salvas, Alertas e Vigias que a conta ainda não tem e as compras dele. Exige bootstrap/CSRF deste navegador; a página faz isso logo depois de entrar. Só passa o que o convidado ainda tem, numa transação, e o que colide com o que a conta já tem fica com o convidado. O que o convidado comprou passa junto. Token antigo, sem assinatura, que não é dono de nada aqui é recusado. Repetir não faz mal (move zero).",
"inputSchema": {
"properties": {
"guest_token": {
"description": "Token edm_… do convidado.",
"type": "string"
}
},
"required": [
"guest_token"
],
"type": "object"
},
"name": "conta_vincular_acompanhamento",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"usd": {
"description": "1, 5, 10 ou 25",
"type": "number"
}
},
"required": [
"usd"
],
"type": "object"
},
"name": "credito_recarregar",
"outputSchema": null
},
{
"description": "Saldo e extrato do crédito pré-pago (precisa do token `cred_…`).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "credito_saldo",
"outputSchema": null
},
{
"description": "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 (só com a sessão da conta: vai para o e-mail verificado dela). O primeiro é grátis; os seguintes custam por 30 dias (x402 ou crédito). Dois modos. Por `termos`: espaço exige todas as palavras, `|` aceita qualquer uma do grupo (`uniforme|fardamento escolar`). Por `cnpj`: o cadastro da empresa informa as atividades (CNAE), o dicionário (`GET /api/cnaes`) transforma cada CNAE numa família de termos e sai um alerta por família distinta, principal primeiro, até `max_familias`; CNAE fora do dicionário não vira alerta e é listado em `empresa.cnaes` com `familia: null`. O primeiro alerta ativo é grátis (`FRANQUIA_ALERTAS`); os seguintes custam `PRECO_ALERTA` por 30 dias cada — no modo CNPJ, numa cobrança só (N × preço), por x402 ou crédito. O cron confere a cada 30 minutos. Canal e-mail exige a sessão da conta — o aviso vai para o e-mail verificado dela, sem código de confirmação — e só existe com `EMAIL_ALERTAS=1`.",
"inputSchema": {
"properties": {
"canal": {
"default": "pull",
"description": "pull, webhook ou email (padrão pull)",
"enum": [
"pull",
"webhook",
"email"
],
"type": "string"
},
"destino": {
"description": "URL https (webhook); ignorado no pull e no email (vai para o e-mail da conta)",
"type": "string"
},
"filtros": {
"additionalProperties": false,
"description": "Recorte adicional: modalidades, municípios, exclusões, valores, propostas abertas e CNAEs. PATCH substitui o recorte inteiro; {} limpa.",
"properties": {
"abertas": {
"type": "boolean"
},
"cnaes": {
"items": {
"pattern": "^\\d{4}-?\\d/?\\d{2}$",
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"excluir": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"modalidades": {
"items": {
"maximum": 13,
"minimum": 1,
"type": "integer"
},
"maxItems": 10,
"type": "array"
},
"municipios": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"valor_max": {
"minimum": 0,
"type": "number"
},
"valor_min": {
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"termos": {
"description": "Palavras do objeto, 3 a 200 letras; espaço = todas, | = qualquer uma (uniforme|fardamento)",
"type": "string"
},
"uf": {
"description": "Sigla da UF (opcional)",
"type": "string"
}
},
"required": [
"termos"
],
"type": "object"
},
"name": "criar_alerta",
"outputSchema": null
},
{
"description": "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. Consulte GET /geracao e envie cotacao. Cada comprador paga, inclusive pronto. O serviço confirma USDC no bloco safe da Base; safe aguarda inclusão na L1, sem finalidade absoluta. Envie em até 30 min; observação por 24 h. Pagamento tardio, rede/moeda errada ou extração falha exige atendimento. Carteira/corretora pode cobrar taxa. Mesma X-Cobranca conserva cobrança/endereço. GET pago devolve acesso.codigo e cookie; para guardar na conta, POST /api/documento/:id/vincular com esse código (o site faz isso sozinho para quem está conectado). O pagamento simulado do ambiente de desenvolvimento não vale para depósito.",
"inputSchema": {
"properties": {
"cobranca_token": {
"description": "32 bytes aleatórios em 64 hex minúsculos, gerados e guardados pelo cliente antes da criação.",
"type": "string"
},
"cotacao": {
"description": "Cotação recebida em estado_geracao.",
"type": "object"
},
"id": {
"description": "ID do documento.",
"type": "number"
}
},
"required": [
"id",
"cobranca_token",
"cotacao"
],
"type": "object"
},
"name": "criar_cobranca",
"outputSchema": null
},
{
"description": "Cria o convidado (token edm_…, emitido pela biblioteca de conta) 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. O token é emitido e assinado pela biblioteca de conta, com teto por rede e por hora, para a franquia grátis não virar infinita. Ele é mostrado uma única vez e não tem recuperação — entre na conta e traga as listas para ela (`POST /api/auth/claim`, que a página da conta faz sozinha ao entrar) para não depender dele. O `webhook_segredo` pode ser relido em `GET /api/dono`. Todo POST do webhook leva `webhook-id`, `webhook-timestamp` (segundos Unix) e `webhook-signature: v1,<base64>`: HMAC-SHA256 de `id.timestamp.corpo` com a chave do seu `whsec_…` (o base64 depois do prefixo). É o padrão Standard Webhooks — qualquer biblioteca dele confere; rejeite timestamp fora de 5 minutos. Depois de `POST /api/dono/segredo`, o anterior ainda assina por 24 h (duas partes `v1,` no cabeçalho).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "criar_dono",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"id": {
"description": "ID do documento",
"minimum": 1,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "documento",
"outputSchema": null
},
{
"description": "Estado do acesso e código privado de recuperação, sem nova compra.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado de acesso.",
"type": "string"
},
"id": {
"description": "Documento comprado.",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "documento_acesso",
"outputSchema": null
},
{
"description": "Catálogo dos arquivos originais do documento, com links de download e páginas. Use /api/documento/{id}/original para baixar o original completo.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado em acesso.codigo após pagamento de quem não está na conta; até 4096 caracteres. Autoriza este documento ao portador. Compra feita com a sessão da conta não emite código: vale o direito global da conta (cookie HttpOnly), e o do convidado edm_… vale com o token. Recibo público não concede acesso.",
"type": "string"
},
"agent_pass": {
"description": "Credencial individual do agente, obrigatória junto de X-Editalmd-Avaliacao.",
"type": "string"
},
"avaliacao_codigo": {
"description": "evaluation.access_code do premium patrocinado, exclusivo deste documento e agente, com expiração. Use junto de X-Agent-Pass; não é recibo ou compra.",
"type": "string"
},
"id": {
"description": "id do documento retornado pela compra",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "documento_arquivos",
"outputSchema": null
},
{
"description": "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. Dossiê incluído no acesso documental, sem nova análise ao consultar. Dados parciais informam cobertura; exportação exige versão concluída.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado em acesso.codigo após pagamento de quem não está na conta; até 4096 caracteres. Autoriza este documento ao portador. Compra feita com a sessão da conta não emite código: vale o direito global da conta (cookie HttpOnly), e o do convidado edm_… vale com o token. Recibo público não concede acesso.",
"type": "string"
},
"after": {
"description": "Cursor next anterior",
"type": "number"
},
"agent_pass": {
"description": "Credencial individual do agente, obrigatória junto de X-Editalmd-Avaliacao.",
"type": "string"
},
"avaliacao_codigo": {
"description": "evaluation.access_code do premium patrocinado, exclusivo deste documento e agente, com expiração. Use junto de X-Agent-Pass; não é recibo ou compra.",
"type": "string"
},
"id": {
"description": "ID do documento",
"type": "number"
},
"kind": {
"description": "identity, item, requirement, attestation, deadline ou obligation",
"type": "string"
},
"limit": {
"description": "1 a 30 fatos",
"type": "number"
},
"v": {
"description": "SHA-256 do texto",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "documento_dossie",
"outputSchema": null
},
{
"description": "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. Somente recursos prontos. Não inicia OCR. `document_approved: false` identifica a extração automática e não impede sua leitura.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado em acesso.codigo após pagamento de quem não está na conta; até 4096 caracteres. Autoriza este documento ao portador. Compra feita com a sessão da conta não emite código: vale o direito global da conta (cookie HttpOnly), e o do convidado edm_… vale com o token. Recibo público não concede acesso.",
"type": "string"
},
"agent_pass": {
"description": "Credencial individual do agente, obrigatória junto de X-Editalmd-Avaliacao.",
"type": "string"
},
"avaliacao_codigo": {
"description": "evaluation.access_code do premium patrocinado, exclusivo deste documento e agente, com expiração. Use junto de X-Agent-Pass; não é recibo ou compra.",
"type": "string"
},
"id": {
"description": "id do documento",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "documento_leitura",
"outputSchema": null
},
{
"description": "Vincula aquisição à conta da sessão usando a autorização privada comprada. Exige sessão e prova privada da aquisição. Grava o direito global da conta pelo recibo do pagamento: idempotente para o mesmo dono, e outro dono não pode reivindicar. O código continua abrindo o documento sozinho.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado de acesso.",
"type": "string"
},
"id": {
"description": "Documento comprado.",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "documento_vincular",
"outputSchema": null
},
{
"description": "Lista os PDFs privados da empresa. Downloads binários usam GET HTTP autenticado /documentos/:arquivo.",
"inputSchema": {
"properties": {
"cnpj": {
"description": "CNPJ de 14 dígitos vinculado ao dono.",
"type": "string"
}
},
"required": [
"cnpj"
],
"type": "object"
},
"name": "documentos_empresa",
"outputSchema": null
},
{
"description": "Estado do dono (precisa do token edm_… ou da sessão da conta): conta ou convidado, e-mail dos avisos, franquia e o segredo whsec_… que assina cada webhook (Standard Webhooks: webhook-id, webhook-timestamp, webhook-signature). Todo POST do webhook leva `webhook-id`, `webhook-timestamp` (segundos Unix) e `webhook-signature: v1,<base64>`: HMAC-SHA256 de `id.timestamp.corpo` com a chave do seu `whsec_…` (o base64 depois do prefixo). É o padrão Standard Webhooks — qualquer biblioteca dele confere; rejeite timestamp fora de 5 minutos. Depois de `POST /api/dono/segredo`, o anterior ainda assina por 24 h (duas partes `v1,` no cabeçalho).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "dono",
"outputSchema": null
},
{
"description": "Lê Markdown com acesso_codigo comprado, ou avaliacao_codigo + agent_pass do premium patrocinado. Cinco exemplos livres. Além da avaliação, gerar_markdown compra por US$ 0,02/página, inclusive pronto.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado em acesso.codigo após pagamento de quem não está na conta; até 4096 caracteres. Autoriza este documento ao portador. Compra feita com a sessão da conta não emite código: vale o direito global da conta (cookie HttpOnly), e o do convidado edm_… vale com o token. Recibo público não concede acesso.",
"type": "string"
},
"agent_pass": {
"description": "Credencial individual do agente, obrigatória junto de X-Editalmd-Avaliacao.",
"type": "string"
},
"avaliacao_codigo": {
"description": "evaluation.access_code do premium patrocinado, exclusivo deste documento e agente, com expiração. Use junto de X-Agent-Pass; não é recibo ou compra.",
"type": "string"
},
"id": {
"description": "id do documento (vem de `compra`)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "edital_markdown",
"outputSchema": null
},
{
"description": "Edita interesse ou pausa/reativa o alerta do dono. Reativação além da franquia exige pagamento. Filtros substituem o recorte inteiro.",
"inputSchema": {
"properties": {
"ativo": {
"description": "`false` pausa sem apagar; `true` reativa.",
"type": "boolean"
},
"canal": {
"description": "Novo canal: `pull`, `webhook` ou `email` (e-mail verificado da conta; exige sessão).",
"enum": [
"pull",
"webhook",
"email"
],
"type": "string"
},
"destino": {
"description": "Nova URL https na porta 443 (webhook). Ignorado no pull e no e-mail.",
"type": "string"
},
"filtros": {
"additionalProperties": false,
"description": "Recorte adicional: modalidades, municípios, exclusões, valores, propostas abertas e CNAEs. PATCH substitui o recorte inteiro; {} limpa.",
"properties": {
"abertas": {
"type": "boolean"
},
"cnaes": {
"items": {
"pattern": "^\\d{4}-?\\d/?\\d{2}$",
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"excluir": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"modalidades": {
"items": {
"maximum": 13,
"minimum": 1,
"type": "integer"
},
"maxItems": 10,
"type": "array"
},
"municipios": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"valor_max": {
"minimum": 0,
"type": "number"
},
"valor_min": {
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"id": {
"description": "Identificador do alerta.",
"type": "string"
},
"termos": {
"description": "Termos do objeto; espaço exige todos, | aceita alternativas.",
"type": "string"
},
"uf": {
"description": "Sigla da UF; vazio libera.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "editar_alerta",
"outputSchema": null
},
{
"description": "Consulta pagamento e liberação com o mesmo cobranca_token. Gratuito; intervalo mínimo 30 s; não inicia trabalho. Reutilize X-Cobranca e respeite Retry-After. Consulta não escreve nem faz RPC blockchain. Quando gerando, use GET /geracao para fases/páginas; pronto libera os links de leitura. Em revisao, conserve ID e transações para atendimento, sem pagar novamente.",
"inputSchema": {
"properties": {
"cobranca_token": {
"description": "32 bytes aleatórios em 64 hex minúsculos, gerados e guardados pelo cliente antes da criação.",
"type": "string"
},
"id": {
"description": "ID do documento.",
"type": "number"
}
},
"required": [
"id",
"cobranca_token"
],
"type": "object"
},
"name": "estado_cobranca",
"outputSchema": null
},
{
"description": "Acompanha as fases reais e a conclusão gratuitamente, sem iniciar processamento.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado em acesso.codigo após pagamento de quem não está na conta; até 4096 caracteres. Autoriza este documento ao portador. Compra feita com a sessão da conta não emite código: vale o direito global da conta (cookie HttpOnly), e o do convidado edm_… vale com o token. Recibo público não concede acesso.",
"type": "string"
},
"agent_pass": {
"description": "Credencial individual do agente, obrigatória junto de X-Editalmd-Avaliacao.",
"type": "string"
},
"avaliacao_codigo": {
"description": "evaluation.access_code do premium patrocinado, exclusivo deste documento e agente, com expiração. Use junto de X-Agent-Pass; não é recibo ou compra.",
"type": "string"
},
"id": {
"description": "ID do documento.",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "estado_geracao",
"outputSchema": null
},
{
"description": "Lista cinco provas reais gratuitas para conferir Markdown, PDF original e ZIP com imagens antes de gerar outro documento.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "exemplos",
"outputSchema": null
},
{
"description": "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. Cada comprador paga, inclusive pronto. Consulte GET ou 402, confira páginas/hash/total e envie cotacao. Sessão da conta (cookie + CSRF do navegador) grava a compra no direito global da conta antes da entrega, sem código avulso; com o convidado edm_… (Bearer), o direito é dele e o código sai junto; agente usa X-Credito. Sem conta, conserve acesso.codigo para reabrir ou vincular depois. Após vínculo somente a conta abre. Texto pronto reutiliza OCR; geração necessária incluída. Cotação desconhecida/alterada não cobra. 152 páginas = US$ 3,04. Corpo até 4096 bytes. Após 202 acompanhe por GET. Pagou e a gravação do direito falhou: 502 `pago_nao_registrado` com o `recibo` — guarde-o, o suporte entrega ou estorna.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado em acesso.codigo após pagamento de quem não está na conta; até 4096 caracteres. Autoriza este documento ao portador. Compra feita com a sessão da conta não emite código: vale o direito global da conta (cookie HttpOnly), e o do convidado edm_… vale com o token. Recibo público não concede acesso.",
"type": "string"
},
"agent_pass": {
"description": "Credencial individual do agente, obrigatória junto de X-Editalmd-Avaliacao.",
"type": "string"
},
"avaliacao_codigo": {
"description": "evaluation.access_code do premium patrocinado, exclusivo deste documento e agente, com expiração. Use junto de X-Agent-Pass; não é recibo ou compra.",
"type": "string"
},
"cotacao": {
"description": "Cotação recebida no estado, confirmada antes de pagar.",
"type": "object"
},
"credito_token": {
"description": "Token cred_… privado. Enviado em X-Credito, preservando a sessão Bearer do pedido MCP.",
"type": "string"
},
"id": {
"description": "ID do documento.",
"type": "number"
},
"idempotencia": {
"description": "Chave da tentativa de crédito, até 80 caracteres; conserve ao repetir.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "gerar_markdown",
"outputSchema": null
},
{
"description": "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. Condições, exceções e evidências por página da análise disponível. A consulta não inicia outra análise. Prazos, propostas e demais obrigações estão no dossie; esta lista cobre habilitação e atestados exigidos, sem afirmar o que a empresa possui.",
"inputSchema": {
"properties": {
"acesso_codigo": {
"description": "Código privado em acesso.codigo após pagamento de quem não está na conta; até 4096 caracteres. Autoriza este documento ao portador. Compra feita com a sessão da conta não emite código: vale o direito global da conta (cookie HttpOnly), e o do convidado edm_… vale com o token. Recibo público não concede acesso.",
"type": "string"
},
"agent_pass": {
"description": "Credencial individual do agente, obrigatória junto de X-Editalmd-Avaliacao.",
"type": "string"
},
"avaliacao_codigo": {
"description": "evaluation.access_code do premium patrocinado, exclusivo deste documento e agente, com expiração. Use junto de X-Agent-Pass; não é recibo ou compra.",
"type": "string"
},
"id": {
"description": "id do documento (vem de `compra`)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "habilitacao",
"outputSchema": null
},
{
"description": "Saúde da origem e tamanho do acervo (compras e documentos com texto).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "health",
"outputSchema": null
},
{
"description": "Coleção privada da conta. Exige a sessão da conta (cookie + CSRF do navegador).",
"inputSchema": {
"properties": {
"antes": {
"description": "proximo_antes da página anterior; hex, cursor exclusivo do cliente.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "meus_compras",
"outputSchema": null
},
{
"description": "Coleção privada da conta. Exige a sessão da conta (cookie + CSRF do navegador).",
"inputSchema": {
"properties": {
"antes": {
"description": "proximo_antes da página anterior; hex, cursor exclusivo do cliente.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "meus_documentos",
"outputSchema": null
},
{
"description": "Identidade e contadores privados da sessão da conta (cookie) enviada no pedido MCP. A conta global já é a pessoa no EditalMD: não há ativação por produto.",
"inputSchema": {
"properties": {
"locais": {
"description": "Até 90 IDs positivos de documentos separados por vírgula para conferir quais já pertencem à conta; no máximo 1529 caracteres.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "minha_conta",
"outputSchema": null
},
{
"description": "Lista privada de empresas e seleção; use a sessão da conta ou o convidado edm_….",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "minhas_empresas",
"outputSchema": null
},
{
"description": "O que os órgãos planejam comprar (planos de contratações anuais do PNCP), antes de a licitação abrir: item, órgão, quantidade, valor estimado e data desejada. Grátis. Busca os itens dos planos de contratações anuais (PCA) que os órgãos publicam no PNCP: o que cada um pretende comprar, quanto, por quanto e para quando — a demanda antes de a licitação abrir. Só a versão em vigor de cada plano; sem `ano`, do ano corrente em diante. Para saber quando a licitação abrir, crie um alerta com os mesmos termos (`/api/alertas`). `Accept: text/html` abre a aba Planos de compras com os termos.",
"inputSchema": {
"properties": {
"ano": {
"description": "Ano do plano (opcional; padrão: do corrente em diante)",
"type": "number"
},
"pagina": {
"description": "0 a 49 (padrão 0)",
"type": "number"
},
"q": {
"description": "Termos do item, mínimo 3 letras",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "planos_de_compras",
"outputSchema": null
},
{
"description": "Prazos da compra: fim das propostas publicado e último dia de impugnação (estimado: 3 dias úteis antes da sessão, Lei 14.133 art. 164, feriados nacionais). Grátis. Servida do cache da borda por até 6 horas — a ficha raramente muda; prazos e preços são calculados a cada pedido. `Cache-Control: no-cache` no pedido lê a origem na hora. O cabeçalho `x-origem-cache` diz `hit`, `miss` ou `bypass`.",
"inputSchema": {
"properties": {
"id": {
"description": "id da compra (vem da busca)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "prazos",
"outputSchema": null
},
{
"description": "O preço que ganha para um item parecido, em resumo grátis: quantos preços, a mediana e a faixa (p25/p75) do mesmo produto do catálogo na mesma unidade, sem os extremos, o volume comprado, o preço para a sua quantidade e os outros grupos que a busca achou (peça produto e unidade de um deles para trocar). O completo — quem vence, quem compra, por UF, por mês, por tamanho da compra e os itens — é GET /api/precos/detalhe, pago por consulta (x402 ou crédito). Consulte resultados homologados por descrição do item. O resumo grátis traz `n`, a mediana e a faixa (p25/p75) dos comparáveis — o mesmo produto do catálogo, na mesma unidade, sem os extremos (`comparacao`) —, os outros grupos que a busca achou (`grupos`: peça `produto` e `unidade` de um deles para trocar), o volume comprado, o preço para a sua `quantidade` (ou a do item da `compra` aberta) e quanto a compra pequena paga a mais, `amostra` (o critério: até 2.000 itens mais parecidos pelo texto) e `detalhe`: o endereço (do mesmo grupo), o preço e o tamanho do preço que ganha completo (`GET /api/precos/detalhe`, pago por consulta) — quem vence, quem compra, por UF, por mês, os outros números do resumo e os itens. Aceita também POST, PUT ou PATCH com os mesmos parâmetros em JSON ou formulário; `query`, `termo`, `busca` e `search` valem como `q`, `estado` como `uf`, `limit` como `limite`. Todo 400 traz `exemplo` e `doc`. `Accept: text/html` abre a aba Preços pagos com a consulta.",
"inputSchema": {
"properties": {
"catmat": {
"description": "Código do item no catálogo do governo (opcional)",
"type": "string"
},
"limite": {
"default": 50,
"description": "1 a 100 (padrão 50)",
"type": "number"
},
"meses": {
"default": 12,
"description": "Janela de homologação em meses, 1 a 36 (padrão 12)",
"type": "number"
},
"produto": {
"description": "Produto do catálogo, como em grupos (opcional)",
"type": "string"
},
"q": {
"description": "Descrição do item, mínimo 3 letras",
"type": "string"
},
"quantidade": {
"description": "Quanto você vai vender: o preço da faixa dessa quantidade (opcional)",
"type": "number"
},
"uf": {
"description": "Sigla da UF do órgão (opcional)",
"type": "string"
},
"unidade": {
"description": "Unidade, como em grupos: 500 FL, 1 UN (opcional)",
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "precos_homologados",
"outputSchema": null
},
{
"description": "Amostra gratuita de compras por termos/filtros ou sugestões editáveis pelo CNPJ. Não cria alertas.",
"inputSchema": {
"properties": {
"cnpj": {
"description": "CNPJ para sugerir até 8 famílias de termos, sem ativá-las.",
"type": "string"
},
"filtros": {
"additionalProperties": false,
"description": "Recorte adicional: modalidades, municípios, exclusões, valores, propostas abertas e CNAEs. PATCH substitui o recorte inteiro; {} limpa.",
"properties": {
"abertas": {
"type": "boolean"
},
"cnaes": {
"items": {
"pattern": "^\\d{4}-?\\d/?\\d{2}$",
"type": "string"
},
"maxItems": 8,
"type": "array"
},
"excluir": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"modalidades": {
"items": {
"maximum": 13,
"minimum": 1,
"type": "integer"
},
"maxItems": 10,
"type": "array"
},
"municipios": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"valor_max": {
"minimum": 0,
"type": "number"
},
"valor_min": {
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"termos": {
"description": "Termos do objeto; espaço exige todos, | aceita alternativas.",
"type": "string"
},
"uf": {
"description": "Sigla da UF; vazio libera.",
"type": "string"
}
},
"type": "object"
},
"name": "previa_alerta",
"outputSchema": null
},
{
"description": "Current public prices and free allowances; no charge.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "pricing",
"outputSchema": null
},
{
"description": "Os CNAEs que costumam vencer compras como esta, do mais provável ao menos, com a descrição oficial e, por CNAE, quantos itens e quanto do valor estimado apontaram para ele. Treinado com quem venceu itens parecidos no PNCP. Grátis. Cada item da compra (até 99, os de maior valor) aponta os 3 CNAEs mais prováveis, por um classificador treinado com a atividade de quem venceu itens parecidos nos resultados homologados do PNCP; a compra soma os pontos (3, 2 e 1 pela posição). Sem itens no acervo, vale o objeto da compra, e saem os 5 mais prováveis sem `itens` nem `valor_estimado`. Na medida de 27/09/2026, em 87% dos itens um dos 3 primeiros era CNAE da empresa que venceu. Para receber as novas compras desses CNAEs, crie um alerta (`POST /api/alertas`).",
"inputSchema": {
"properties": {
"id": {
"description": "id da compra (vem da busca)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "quem_fornece",
"outputSchema": null
},
{
"description": "Recibo de uma entrega: preço, modo de pagamento e hash do conteúdo entregue.",
"inputSchema": {
"properties": {
"id": {
"description": "id do recibo (vem no header x-editalmd-recibo)",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "recibo",
"outputSchema": null
},
{
"description": "Remove um comprovante da própria empresa; análises que o usavam ficam desatualizadas.",
"inputSchema": {
"properties": {
"arquivo": {
"description": "SHA-256 do PDF privado.",
"type": "string"
},
"cnpj": {
"description": "CNPJ de 14 dígitos vinculado ao dono.",
"type": "string"
}
},
"required": [
"cnpj",
"arquivo"
],
"type": "object"
},
"name": "remover_documento_empresa",
"outputSchema": null
},
{
"description": "Remove somente o vínculo do próprio dono e limpa a seleção se necessário.",
"inputSchema": {
"properties": {
"cnpj": {
"description": "CNPJ completo, 14 dígitos com verificação válida.",
"type": "string"
}
},
"required": [
"cnpj"
],
"type": "object"
},
"name": "remover_empresa",
"outputSchema": null
},
{
"description": "Remove a compra da lista pessoal do dono. Salvar não cria vigia nem notificação. O cliente fornece somente o ID; o retrato vem do acervo.",
"inputSchema": {
"properties": {
"id": {
"description": "Identificador da compra no acervo.",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "remover_salva",
"outputSchema": null
},
{
"description": "Troca o segredo que assina os webhooks (precisa do token edm_…). O anterior ainda assina por 24 h, para trocar sem janela de falha. Durante as 24 h o cabeçalho `webhook-signature` traz duas partes `v1,…`: uma com o novo, outra com o anterior. Basta o receptor aceitar qualquer uma que bata.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "rotacionar_segredo_webhook",
"outputSchema": null
},
{
"description": "Salva a compra sem cobrança nem notificação, até 200 por dono. Salvar não cria vigia nem notificação. O cliente fornece somente o ID; o retrato vem do acervo.",
"inputSchema": {
"properties": {
"id": {
"description": "Identificador da compra no acervo.",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "salvar_compra",
"outputSchema": null
},
{
"description": "Lista até 200 licitações salvas pelo dono, gratuitamente.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "salvas",
"outputSchema": null
},
{
"description": "Seleciona empresa cadastrada; não executa análise. Seleção persistida para este dono; vincular a conta permite recuperá-la em outros aparelhos. Não executa análise; repetir a seleção atual não grava.",
"inputSchema": {
"properties": {
"cnpj": {
"description": "CNPJ completo, 14 dígitos com verificação válida.",
"type": "string"
}
},
"required": [
"cnpj"
],
"type": "object"
},
"name": "selecionar_empresa",
"outputSchema": null
},
{
"description": "Eventos de uma compra vigiada (o que mudou, de quê para quê, quando) e a fotografia atual. Precisa do token edm_….",
"inputSchema": {
"properties": {
"id": {
"description": "id da vigia",
"type": "string"
},
"limite": {
"description": "1 a 100 (padrão 50)",
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "vigia_eventos",
"outputSchema": null
},
{
"description": "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. A primeira vigia ativa é grátis (`FRANQUIA_VIGIAS`); as seguintes custam `PRECO_VIGIA` até 30 dias após o encerramento. As verificações são periódicas; confira a data da última verificação na vigia. Avisos `prazo_impugnacao` (no dia) e `prazo_proposta` (24 h antes) saem uma vez cada.",
"inputSchema": {
"properties": {
"canal": {
"default": "pull",
"description": "pull, webhook ou email (padrão pull)",
"enum": [
"pull",
"webhook",
"email"
],
"type": "string"
},
"compra_id": {
"description": "id da compra (vem da busca)",
"type": "number"
},
"destino": {
"description": "URL https (webhook); ignorado no pull e no email (vai para o e-mail da conta)",
"type": "string"
}
},
"required": [
"compra_id"
],
"type": "object"
},
"name": "vigiar_compra",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:95b780846cac6fa7be2a868d8d56eb0fa048aeae8b000fd58cbc88cc835c06e8 | sha256sum