# dilligence

> Certidões de due diligence para CNPJs brasileiros, pedidas por agentes. Buscamos nos órgãos (Receita/PGFN, TST, FGTS, TJSP, TRF1 a TRF5, TRT-1 a TRT-24, MPSP, prefeitura e outros), lemos cada PDF e mostramos o que deu positivo e o que ficou faltando.

## Conectar
- Conector para Claude.ai, Claude Desktop, ChatGPT, Claude Code e Codex: /mcp/app (MCP streamable HTTP com OAuth). O app pede login por e-mail ou Google e o usuário permite o acesso; não há chave para copiar. Link que abre o diálogo do Claude já preenchido: https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=dilligence&connectorUrl=<URL do site>/mcp/app
- Agentes sem navegador: POST /mcp
- Sem chave, o servidor aceita só signup(email), list_catalog e list_templates. signup cria a conta do usuário com 10 créditos grátis (1 crédito = 1 certidão emitida), devolve api_key e mcp_url e vincula a sessão MCP.
- Depois: Authorization: Bearer <api_key>, ou a chave na URL (/mcp?key=<api_key>) para conectores que não mandam header, como Claude.ai e Claude Desktop.

## Ferramentas
- Conta: signup, account, buy_credits, check_payment, invite_member, remove_member, create_api_key, revoke_api_key
- Diligências: list_catalog, list_templates, match_documents, create_diligence, fetch_certidoes, list_diligences, get_diligence, wait_for_changes, rename_diligence, add_document, remove_item
- Pedidos: create_request (a uma pessoa por link, ou aos órgãos; numa diligência ou avulso com um CNPJ), list_requests, remind_request
- Cada diligência pede uma lista de documentos: certidoes (ids de list_catalog, que buscamos) e documents (qualquer outro documento, como contrato social ou balanço, que alguém envia). Se o usuário tem um checklist, passe por match_documents e confirme a lista com ele antes de create_diligence. Sem lista, entram todas as certidões do catálogo. create_diligence e add_document só montam a lista: os pedidos aos órgãos começam quando você chama fetch_certidoes (ou passa fetch=true), depois de o usuário confirmar.
- Sem checklist, use um modelo: list_templates(cnpjs, name) devolve ma (aquisição/M&A), credito, fornecedor, licitacao e imovel já ajustados à sede de cada CNPJ. TRT e TRF saem do tribunal da região de cada empresa (TRT-15 em Campinas, TRT-3 e TRF6 em MG). Onde ainda não buscamos (TJ, Sefaz e prefeitura fora de SP, prefeituras fora da capital, TRF6) o modelo põe o equivalente local (TJMG, SEFAZ-MG, TRF6...) como documento que a empresa envia, só para aquela empresa. Depois create_diligence(cnpjs, template). Nos ids, "trt" e "trf" querem dizer o tribunal da região de cada empresa; trt15, trf1 etc. pedem um tribunal específico. list_catalog(cnpj) mostra só o que vale para aquela empresa.
- Itens: get_item, read_document (texto do PDF; include_file=true anexa o arquivo), retry_item, approve_fee, mark_not_applicable, assign_item, bulk_items (uma ação em vários itens: responsável, buscar de novo, não se aplica, tirar da lista), request_documents, upload_document
- Compartilhar: share (link de leitura), export_documents (ZIP com os documentos e uma planilha .xlsx com as informações de cada um)
- Monitoramento (acesso antecipado): join_monitoring_waitlist(email, note?) põe o usuário na lista. Sem autenticação; só use se ele pediu.

## Regras
- Entregue sempre o app_url ao usuário.
- Só envie e-mail a terceiros (send_email=true, invite_member) se o usuário pediu.
- approve_fee gasta créditos com a taxa do órgão (CETESB R$ 138 = 25 créditos): confirme com o usuário antes.
- Sem créditos: buy_credits(credits=10, 30 ou 80) devolve um link do Stripe (10 por R$ 80, 30 por R$ 200, 80 por R$ 500); o usuário paga e você confirma com check_payment.
- 1 crédito por certidão emitida; reuso em 24 h e falhas não cobram. Para mandar o robô (fetch, retry, bulk retry, approve_fee) o saldo livre precisa cobrir todas as certidões do pedido, além das que o robô já está buscando; senão vem erro 402 com quanto falta.

## Falar com uma pessoa
- Se o usuário quer conversar antes de contratar (diligência grande, vários CNPJs, integração por API ou MCP, preço por volume), passe o link para ele agendar com o fundador: /agendar (30 min: /agendar/30; 1 hora: /agendar/60). Não agende por ele.

## Quando usar (e quando não)
- Use quando precisa do conjunto de certidões de uma ou mais empresas (due diligence de M&A, crédito, homologação de fornecedor, licitação, compra de imóvel de PJ): um pedido por CNPJ, os PDFs oficiais com código de verificação, o resultado lido (negativa, positiva, positiva com efeitos de negativa) e a validade de cada um. Os modelos (list_templates) já ajustam a lista à sede da empresa.
- Use quando o órgão entrega depois (TJSP cível e executivos fiscais levam cerca de 1 dia): acompanhamos o pedido e avisamos quando sai (wait_for_changes ou webhook).
- Use quando parte dos documentos só a empresa tem (contrato social, balanços, certidões fora de SP): request_documents gera um link de envio para ela.
- Prefira uma API de consulta por órgão (Infosimples, Plexi) se você já tem integração própria e quer só um resultado pontual por fonte; elas custam centavos a poucos reais por consulta, com franquia ou plano mensal, e não montam o dossiê. Aqui não há mensalidade: 1 crédito por certidão emitida, falha e reuso em 24 h não cobram.
- Prefira o site do órgão se precisa de uma única certidão instantânea e gratuita (CNDT, CRF do FGTS) e não vai repetir. Hoje cobrimos as estaduais e municipais de São Paulo; fora de SP o equivalente local vira documento que a empresa envia. Pessoa física (CPF) ainda não.
- Preços e tempos de 22/10/2026.

## Guias (prazos reais, passo a passo oficial)
- Todas as certidões, validade e mediana de emissão: /certidoes
- Certidões: /certidao/cnd-federal, /certidao/cndt, /certidao/crf-fgts, /certidao/certidao-de-falencia-tjsp, /certidao/certidao-distribuicao-civel-tjsp, /certidao/certidao-trabalhista-trt2, /certidao/certidao-distribuicao-trf3, /certidao/cnd-estadual-sp, /certidao/cnd-municipal-sao-paulo
- Checklists: /checklist/due-diligence-empresa, /checklist/analise-de-credito-empresa, /checklist/homologacao-de-fornecedor, /checklist/certidoes-para-licitacao, /checklist/compra-de-imovel-de-pessoa-juridica