{"openapi":"3.1.0","info":{"title":"UtilizAí API","version":"1.0.0","description":"API pública REST + MCP para ferramentas utilitárias brasileiras. Gratuita com limite diário; upgrade em /precos.","termsOfService":"https://xn--utiliza-eza.com/termos","contact":{"email":"contato@utilizaí.com","url":"https://xn--utiliza-eza.com/contato"},"license":{"name":"Proprietary","url":"https://xn--utiliza-eza.com/termos"}},"servers":[{"url":"https://xn--utiliza-eza.com/api","description":"Produção"}],"security":[{"bearerAuth":[]},{}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"utz_live_xxx","description":"API key pessoal (opcional). Sem key → limites de IP. Com key → limites do plano do usuário."}},"schemas":{"RateLimit":{"type":"object","properties":{"limit":{"oneOf":[{"type":"integer"},{"type":"string","enum":["unlimited"]}]},"used":{"type":"integer"},"plan":{"type":"string","enum":["free","pro","business","enterprise"]}}},"Error":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/v1/validate/cpf":{"get":{"tags":["Validadores"],"summary":"Valida CPF","parameters":[{"name":"cpf","in":"query","required":true,"schema":{"type":"string"},"example":"11144477735"}],"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"valid":{"type":"boolean"},"digits":{"type":"integer"},"rate_limit":{"$ref":"#/components/schemas/RateLimit"}}}}}},"429":{"description":"Rate limit excedido"}}}},"/v1/validate/cnpj":{"get":{"tags":["Validadores"],"summary":"Valida CNPJ","parameters":[{"name":"cnpj","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/v1/generate/cpf":{"get":{"tags":["Geradores"],"summary":"Gera CPF válido (testes)","responses":{"200":{"description":"OK"}}}},"/v1/generate/cnpj":{"get":{"tags":["Geradores"],"summary":"Gera CNPJ válido (testes)","responses":{"200":{"description":"OK"}}}},"/v1/cep":{"get":{"tags":["Consultas"],"summary":"Consulta CEP (ViaCEP/BrasilAPI)","parameters":[{"name":"cep","in":"query","required":true,"schema":{"type":"string"},"example":"01310100"}],"responses":{"200":{"description":"OK"},"404":{"description":"CEP não encontrado"}}}},"/v1/cnpj":{"get":{"tags":["Consultas"],"summary":"Consulta dados cadastrais de CNPJ","parameters":[{"name":"cnpj","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/v1/ddd":{"get":{"tags":["Consultas"],"summary":"Cidades de um DDD","parameters":[{"name":"ddd","in":"query","required":true,"schema":{"type":"string"},"example":"11"}],"responses":{"200":{"description":"OK"}}}},"/v1/feriados/{ano}":{"get":{"tags":["Consultas"],"summary":"Feriados nacionais","parameters":[{"name":"ano","in":"path","required":true,"schema":{"type":"integer"},"example":2026}],"responses":{"200":{"description":"OK"}}}},"/v1/bancos":{"get":{"tags":["Consultas"],"summary":"Lista bancos brasileiros","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string"},"description":"Código ISPB para buscar um banco específico"}],"responses":{"200":{"description":"OK"}}}},"/v1/moedas":{"get":{"tags":["Consultas"],"summary":"Cotação de moeda","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"schema":{"type":"string"},"example":"BRL"},{"name":"amount","in":"query","required":false,"schema":{"type":"number"},"example":100}],"responses":{"200":{"description":"OK"}}}},"/v1/financeiro":{"get":{"tags":["Consultas"],"summary":"Indicadores financeiros BCB","parameters":[{"name":"indicador","in":"query","required":true,"schema":{"type":"string","enum":["selic","cdi","ipca","poupanca","dolar"]}}],"responses":{"200":{"description":"OK"}}}},"/v1/convert":{"get":{"tags":["Conversores"],"summary":"Converte unidades","parameters":[{"name":"category","in":"query","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":true,"schema":{"type":"string"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"}},{"name":"value","in":"query","required":true,"schema":{"type":"number"}}],"responses":{"200":{"description":"OK"}}}},"/v1/dou/buscar":{"get":{"tags":["DOU"],"summary":"Busca publicações em Diários Oficiais (Querido Diário)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"licitação"},{"name":"page","in":"query","schema":{"type":"integer","default":0}},{"name":"page_size","in":"query","schema":{"type":"integer","default":10,"maximum":50}},{"name":"uf","in":"query","schema":{"type":"string"},"example":"SP"},{"name":"date_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Resultados paginados do Querido Diário"},"400":{"description":"Parâmetro q ausente"}}}},"/v1/dou/recentes":{"get":{"tags":["DOU"],"summary":"Diários publicados nos últimos 7 dias","parameters":[{"name":"uf","in":"query","schema":{"type":"string"},"example":"RJ"},{"name":"page_size","in":"query","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"Publicações recentes"}}}},"/mcp":{"post":{"tags":["MCP (Model Context Protocol)"],"summary":"Endpoint JSON-RPC 2.0 para agentes de IA","description":"Protocolo MCP completo. Métodos: initialize, ping, tools/list, tools/call.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"},{"type":"null"}]},"method":{"type":"string","enum":["initialize","ping","tools/list","tools/call"]},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"Resposta JSON-RPC"}}}}}}