# Dilligence — certidões de empresas > Certidões negativas de empresas (CNPJ) num pedido: pede nos órgãos, lê cada PDF e resume. - name: br.ia.dilligence/certidoes - version: 1.1.0 - connection class: R0 (autonomous) - trust: 96/100 - quality: 85/100 (good) - owner: not claimed - descriptor: https://api.protogrid.dev/v1/servers/br.ia.dilligence%2Fcertidoes - tools: https://api.protogrid.dev/v1/servers/br.ia.dilligence%2Fcertidoes/tools **An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe. ## Connection (mcpServers) ```json { "mcpServers": { "certidoes": { "type": "http", "url": "https://dilligence.ia.br/mcp", "headers": { "Authorization": "Bearer ${CERTIDOES_TOKEN}" } } } } ``` Placeholders to fill: `${CERTIDOES_TOKEN}`. ## Trust - hygiene: 100 - liveness: 100 - freshness: 100 - provenance: 85 - drivers: +repository +dns-namespace +website +reachable +uptime-100% +updated-1d-ago - Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. ## Quality 85/100 (good) ### protocol: 75 (weight 25) - warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28 - n/a `protocol.stateless`: only applies to 2026-07-28 servers - pass `protocol.transport`: streamable HTTP - n/a `protocol.list_ttl`: only applies to 2026-07-28 servers ### authorization: 83 (weight 15) - pass `auth.prm`: Protected Resource Metadata (RFC 9728) published - pass `auth.as_metadata`: authorization server metadata reachable - warn `auth.cimd`: only Dynamic Client Registration, deprecated in 2026-07-28 in favour of CIMD - n/a `auth.secret_in_url`: no templated URL ### tool hygiene: 100 (weight 30) - pass `tools.descriptions`: every tool has a description - pass `tools.description_length`: descriptions are concise - pass `tools.schemas`: every tool has an object input schema - pass `tools.annotations`: 35 of 35 tools declare readOnlyHint or destructiveHint - pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint - pass `tools.token_cost`: about 4,797 tokens to load every tool - pass `tools.api_dump`: tools are not a one-to-one API dump ### stability: 75 (weight 15) - warn `stability.changes`: 77 tool changes in 30 days - pass `stability.rug_pull`: no tool changed its meaning under the same name ### dependencies: n/a (weight 15) - n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package - tools: 35, about 4,797 tokens to load them all - tool set hash: 885891bb30be02b5a4b1a4cba66ea9e2 - tools last changed: 2026-11-06T17:57:40.115Z - badge: [![protogrid quality](https://protogrid.dev/badge/br.ia.dilligence/certidoes.svg)](https://protogrid.dev/servers/br.ia.dilligence/certidoes) - Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. ### Tool changes - 2026-11-06 `export_documents` changed (title, annotations) - 2026-11-06 `share` changed (title, annotations) - 2026-11-06 `upload_document` changed (title, annotations) - 2026-11-06 `request_documents` changed (title, annotations) - 2026-11-06 `bulk_items` changed (title, inputSchema, annotations) - 2026-11-06 `assign_item` changed (title, description, inputSchema, annotations) - before: Define o responsável por um item: "me", o id de um membro (u:...), ou {name,email,send_email} de alguém de fora (recebe link de envio; e-mail só com send_email=true). - after: Define o responsável por um item: "me", o id de um membro (u:...), ou o e-mail de alguém de fora com owner_name (recebe link de envio; e-mail só com send_email=true). - 2026-11-06 `mark_not_applicable` changed (title, annotations) - 2026-11-06 `approve_fee` changed (title, annotations) - 2026-11-06 `retry_item` changed (title, annotations) - 2026-11-06 `read_document` changed (title, annotations) Full history: https://api.protogrid.dev/v1/servers/br.ia.dilligence%2Fcertidoes/changes ## Remotes - https://dilligence.ia.br/mcp/app (streamable-http, auth oauth2, reachable true, uptime30d 1) - https://dilligence.ia.br/mcp (streamable-http, auth none, reachable true, uptime30d 0.975) ## Packages _none_ ## Tools (35) - `account`: Conta atual: saldo em créditos (1 crédito = 1 certidão emitida), membros, chaves, extrato e pagamento (pacotes, cartão salvo). - `add_document`: Adiciona documentos à lista de uma diligência já aberta, para todas as empresas (ou só party_ids, de get_diligence.parties): certidoes (ids de list_catalog) e documents (títulos livres, ex. contrato social, que alguém envia). Também aceita title para um só documento livre. As certidões esperam fetch_certidoes, ou passe fetch=true. - `approve_fee`: Aprova a taxa do órgão para um item (ex. CETESB R$ 138 = 25 créditos, além do crédito da certidão) e retoma a busca. Gasta créditos: confirme com o usuário antes. - `assign_item`: Define o responsável por um item: "me", o id de um membro (u:...), ou o e-mail de alguém de fora com owner_name (recebe link de envio; e-mail só com send_email=true). - `bulk_items`: Uma ação em vários itens de uma vez: action="owner" (owner como em assign_item, ou null para tirar), "retry" (busca de novo as certidões que pararam ou não foram pedidas; gasta créditos quando saem), "na" (não se aplica, com reason) ou "remove" (tira da lista). Itens em que a ação não cabe são pulados e contados em skipped. - `buy_credits`: Cria um link de pagamento do Stripe para o usuário comprar um pacote de créditos: 10 créditos por R$ 80, 30 créditos por R$ 200, 80 créditos por R$ 500. Você não paga: passe checkout_url ao usuário; o cartão salvo aparece preenchido. Depois chame check_payment com o session_id. Pergunte o pacote ao usuário antes. - `check_payment`: Confere se o usuário pagou o link de buy_credits e credita o saldo (uma vez só). Devolve paid, credited e o saldo atual em créditos. - `create_api_key`: Cria outra chave de API (para outro agente ou sistema). A chave aparece só nesta resposta. - `create_diligence`: Abre uma diligência para os CNPJs (cnpjs) e pessoas físicas (people, com CPF e nome completo) com a lista de documentos que o usuário quer. certidoes: ids de list_catalog, que pedimos aos órgãos. documents: qualquer outro documento (contrato social, balanço, alvará...), que fica com alguém para enviar. Só monta a lista: os pedidos aos órgãos começam quando você chama fetch_certidoes (ou passe fetch=true se o usuário já pediu para buscar). Se o usuário tem um checklist, passe por match_documents antes e confirme a lista com ele. Sem certidoes nem documents, entram todas as certidões do catálogo. 1 crédito por certidão emitida (cobrado só quando sai); documentos enviados não cobram. - `create_request`: Faz um pedido de documentos. to="robot" pede certidões aos órgãos; to=e-mail (com to_name) pede a uma pessoa por link (e-mail só se o usuário pediu: send=true). Dentro de uma diligência (diligence_id; item_ids reaproveita itens dela) ou avulso (cnpj, sem diligência). certidoes e documents como em create_diligence. Para mandar a uma pessoa itens que já estão numa diligência, request_documents é o atalho. - `export_documents`: Link de um ZIP com todos os documentos da diligência (pasta Documentos/) e uma planilha .xlsx com uma linha por documento: situação, resultado, validade, código, protocolo, resumo e link para o arquivo. Usa o link de leitura; se estiver desligado, passe enable_share=true para ligá-lo. - `fetch_certidoes`: Pede aos órgãos as certidões da diligência que ainda não foram pedidas (status "ready"), ou só item_ids (também repete as que pararam). Gasta créditos quando a certidão sai: confirme com o usuário se ele não pediu para buscar. Para repetir um item que falhou, retry_item. - `find_company`: Acha o CNPJ pelo nome da empresa (razão social ou nome fantasia): busca na web e confere cada CNPJ na Receita. Devolve até 5 empresas, a mais provável primeiro, com razão social, nome fantasia, situação e cidade (filiais viram a matriz). Confirme com o usuário quando houver mais de uma. - `get_diligence`: Situação de cada item (status, responsável, resultado, validade, código, resumo), links de envio e de leitura, e app_url. - `get_item`: Detalhe completo de um item: resumo inteiro, motivo de ter parado, protocolo, próxima checagem, taxa, tentativas e histórico. - `invite_member`: Convida alguém para o workspace (vê e edita todas as diligências). Envia e-mail de convite: só use se o usuário pediu. - `join_monitoring_waitlist`: Monitoramento contínuo de CNPJs (renovar certidões antes de vencer e avisar quando algo muda) está em acesso antecipado. Coloca o e-mail do usuário na lista; só use se ele pediu. Funciona sem autenticação. - `list_catalog`: Certidões que buscamos: órgão, validade, taxa do órgão, se é automática. Com cnpj, só as que valem para aquela empresa, com o TRT e o TRF da região dela. Famílias regionais: "trt" (TRT da região de cada empresa, TRT-1 a 24) e "trf" (TRF da região, TRF1 a 6) servem como id em create_diligence; ids regionais (trt15, trf1…) pedem um tribunal específico, ex. TRT-15 para uma filial em Campinas. 1 crédito por certidão emitida; reuso em 24 h e falhas não cobram. - `list_diligences`: Lista as diligências do workspace com progresso. - `list_requests`: Pedidos do workspace: a pessoas (link de envio; quem abriu, lembretes) e aos órgãos (cada busca), com o que já chegou. Use para acompanhar e cobrar. - `list_templates`: Modelos de diligência prontos (ma: aquisição/M&A, credito, fornecedor, licitacao, imovel), já ajustados à sede de cada CNPJ: TRT e TRF da região de cada empresa (todos os TRTs e TRFs); onde não buscamos (TJ, Sefaz e prefeitura fora de SP, prefeituras fora da capital) o modelo troca a certidão de SP pela local (TJMG, SEFAZ-MG...) como documento que a empresa envia, só para aquela empresa. Devolve cada modelo com os itens (certidão do catálogo ou documento, e para quais cnpjs), o que mudou por local (adjustments) e um modelo sugerido pelo nome da diligência. Use antes de create_diligence com template. - `mark_not_applicable`: Marca o item como "não se aplica", com o motivo. - `match_documents`: Lê uma lista de documentos pedidos (checklist colado, e-mail, planilha ou foto em base64) e diz, para cada um, quais certidões do catálogo atendem (source_ids) ou se é um documento que alguém precisa enviar (source_ids vazio). Use antes de create_diligence ou add_document. - `read_document`: Lê o documento de um item (certidão emitida ou arquivo enviado): texto completo do PDF, resultado, validade e código. include_file=true também anexa o PDF em base64. - `remind_request`: Manda de novo o e-mail de um pedido a uma pessoa, com o que ainda falta (id de list_requests). Só se o usuário pediu. - `remove_item`: Tira um documento da lista da diligência. Uma certidão que ainda não foi pedida ao órgão é cancelada. - `remove_member`: Tira um membro do workspace (id de account.members). - `rename_diligence`: Renomeia a diligência. - `request_documents`: Pede vários itens a uma pessoa de fora (ex. o financeiro da empresa). Devolve o link de envio, sem login, com o passo a passo de cada documento. Só envia e-mail se send_email=true. Use para itens que já existem na diligência; para documentos novos ou pedido avulso por CNPJ, use create_request. - `retry_item`: Busca a certidão de novo (item que falhou, parou num muro, ou para renovar). Um item só: para vários use bulk_items com action="retry"; para itens nunca pedidos, fetch_certidoes. - `revoke_api_key`: Revoga uma chave (id de account.keys). - `share`: Liga ou desliga o link de leitura da diligência (quem tiver o link vê os itens e baixa os PDFs, sem login). - `signup`: Cria a conta do usuário com o e-mail dele e 30 créditos grátis (30 certidões). Devolve api_key, mcp_url (URL do conector já com a chave, para o usuário configurar e não perder o acesso) e app_url. Funciona sem autenticação. O usuário recebe um e-mail avisando. - `upload_document`: Anexa um arquivo (PDF, PNG, JPG) a um item, por file_url ou content_base64. PDFs de certidão são lidos (resultado, validade, código). - `wait_for_changes`: Espera até 45 s por mudanças na diligência. Passe o cursor devolvido na chamada anterior. Repita enquanto houver itens fetching ou waiting.