{
  "name": "PontoFato",
  "description": "Encontre um endereço, veja empresas registradas no CEP e explore a vizinhança por distância, sem cadastro.",
  "url": "https://pontofato.com",
  "provider": {
    "organization": "PontoFato",
    "url": "https://pontofato.com",
    "email": "contato@pontofato.com"
  },
  "documentationUrl": "https://pontofato.com/llms.txt",
  "protocol": "mcp",
  "protocolUrl": "https://modelcontextprotocol.io",
  "interfaces": [
    {
      "transport": "streamable-http",
      "url": "https://pontofato.com/mcp"
    }
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "authentication": "none"
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/markdown"
  ],
  "skills": [
    {
      "id": "api_index",
      "name": "api_index",
      "description": "Índice auto-descrito: cada rota, o que cobra e como plugar o MCP.",
      "endpoint": "GET /api/"
    },
    {
      "id": "health",
      "name": "health",
      "description": "Disponibilidade do serviço e cobertura por UF.",
      "endpoint": "GET /api/health"
    },
    {
      "id": "cep",
      "name": "cep",
      "description": "Endereços de um CEP, com latitude e longitude.",
      "endpoint": "GET /api/cep/:cep"
    },
    {
      "id": "proximo",
      "name": "proximo",
      "description": "Endereço mais próximo de latitude e longitude. Ausente ou vazio NÃO vira zero. `(0,0)` é o golfo da Guiné e só entra se a pessoa mandou.",
      "endpoint": "GET /api/proximo"
    },
    {
      "id": "buscar",
      "name": "buscar",
      "description": "Busca de rua pelo nome (ou pelo bairro) no país, até 20: uma por rua de cada cidade, com o ponto do número quando o termo traz um que existe.",
      "endpoint": "GET /api/buscar"
    },
    {
      "id": "unidades",
      "name": "unidades",
      "description": "Unidades de um CEP (apartamento, loja), com complemento e tipo. Paginado. O lookup do CEP agrupa por logradouro+número. Esta rota devolve cada unidade (apartamento, loja). Sem `logradouro`/`numero`, pagina o CEP inteiro.",
      "endpoint": "GET /api/cep/:cep/unidades"
    },
    {
      "id": "empresas",
      "name": "empresas",
      "description": "Empresas registradas neste CEP, até 50 por página.",
      "endpoint": "GET /api/empresas"
    },
    {
      "id": "raio",
      "name": "raio",
      "description": "CEPs a N metros de um ponto (cep ou lat/lon), com distância e endereços. Grátis.",
      "endpoint": "GET /api/raio"
    },
    {
      "id": "vizinhanca",
      "name": "vizinhanca",
      "description": "Empresas ativas, abertas e baixadas num raio em metros, por CNAE, com aberturas recentes e distância. Consulte quota.free_now no índice: vizinhanca indica cobrança desativada. Com cobrança ativa: franquia diária e tarifa própria. Consulte quota.free_now no índice: quando inclui vizinhanca ou *, a operação não cobra nem exige crédito. Com cobrança ativa, a franquia diária vem antes da tarifa por consulta.",
      "endpoint": "GET /api/vizinhanca"
    },
    {
      "id": "contact",
      "name": "contact",
      "description": "Fale com quem faz o produto: dúvida, ou proposta de patrocínio/parceria/anúncio. Grátis, sem captcha nem pagamento; uma mensagem a cada 10 s por rede (a que chega antes espera a vez). Uma rota para dúvida e para proposta de patrocínio, parceria ou anúncio (`tipo`, com os espaços de `GET /api/partners`). Sem captcha, sem conta, sem pagamento. Uma mensagem a cada 10 segundos por rede: a que chega antes espera a vez e sai — sem erro. A mensagem chega à equipe por e-mail, com o `email` como endereço de resposta.",
      "endpoint": "POST /api/contact"
    },
    {
      "id": "consulta_cnpj",
      "name": "consulta_cnpj",
      "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.",
      "endpoint": "GET /api/consulta/cnpj/:cnpj"
    },
    {
      "id": "consulta_cep",
      "name": "consulta_cep",
      "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`.",
      "endpoint": "GET /api/consulta/cep/:cep"
    },
    {
      "id": "consulta_planos",
      "name": "consulta_planos",
      "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).",
      "endpoint": "GET /api/consulta"
    },
    {
      "id": "consulta_comprar",
      "name": "consulta_comprar",
      "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.",
      "endpoint": "POST /api/consulta/planos/:oferta"
    },
    {
      "id": "api_access",
      "name": "api_access",
      "description": "Monthly data package and private purchase status, without charging.",
      "endpoint": "GET /api/acesso"
    },
    {
      "id": "api_access_buy",
      "name": "api_access_buy",
      "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.",
      "endpoint": "POST /api/acesso"
    },
    {
      "id": "pricing",
      "name": "pricing",
      "description": "Current public prices and free allowances; no charge.",
      "endpoint": "GET /api/pricing"
    },
    {
      "id": "billing",
      "name": "billing",
      "description": "Payment discovery and billing summary; does not create a charge.",
      "endpoint": "GET /api/billing"
    }
  ],
  "discovery": {
    "openapi": "https://pontofato.com/openapi.json",
    "llms": "https://pontofato.com/llms.txt",
    "okf": "https://pontofato.com/okf/index.md",
    "numbers": "https://pontofato.com/api/vitrine",
    "partnerships": "https://pontofato.com/api/partners",
    "api_catalog": "https://pontofato.com/.well-known/api-catalog",
    "x402": "https://pontofato.com/.well-known/x402",
    "pricing": "https://pontofato.com/pricing",
    "docs": "https://pontofato.com/docs"
  },
  "updated": "2026-10-05"
}