Adoteca MCP
An official MCP server provided by Adoteca that allows AI agents to access a public API for searching pets available for adoption in Brazil from NGOs and protectors, filtering by city, size, age, and health.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://api.adoteca.com.br/mcpWhat its tools do
11 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to adoteca.com.br ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search for dogs available for adoption in specific cities
- Search for cats available for adoption from specific NGOs
- Access RSS feeds of available pets for agent integration
Source and maintenance
Vendor evidenceRegistry 2.0.0
- Maintenance checked
Protocol and capabilities
- Server
- adoteca 2.0.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 11 advertised
- Resources
- 2 advertised
- Resource templates
- 0 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
11 advertised
search_pets — Buscar pets para adoção
Advertised read-onlyOpen-world
Busca em TODO o catálogo de cães e gatos para adoção no Brasil, por filtros como cidade, espécie, porte e idade, ou pelo nome do pet. É a busca padrão de quem quer adotar. Inclui pets já adotados, indicados em `status`; cada pet traz o `adoption_url` da ficha.
search_pets input schema
{
"type": "object",
"title": "search_petsArguments",
"properties": {
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sex",
"default": null,
"description": "Sexo: 'male'/'macho' ou 'female'/'femea'."
},
"area": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Area",
"default": null,
"description": "Amplia a busca em volta de `city`: 'city'/'cidade' (padrão, só a cidade), 'neighbors'/'vizinhas' (mais as cidades que fazem divisa) ou 'radius'/'raio' (mais as cidades a até `radius_km` km). Resultados: a cidade primeiro, depois as vizinhas, depois o resto. Não combina com `name`."
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null,
"description": "Nome do MUNICÍPIO por extenso, não do bairro nem abreviado: 'Belo Horizonte', não 'BH'. Acento é opcional. Se o nome for ambíguo, ou se nenhuma ONG tiver pets ali hoje, o erro explica o que corrigir; isso não significa que a cidade não exista."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null,
"description": "Nome do pet como a pessoa escreveu ('nina', 'bebe'). Acentos e maiúsculas não importam; erros de grafia geralmente NÃO são encontrados. `name_match.confidence` diz quão certo é o pet encontrado. Se a lista vier vazia, o nome não foi encontrado como escrito."
},
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"description": "Página, começando em 1."
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size",
"default": null,
"description": "Porte: 'small'/'pequeno', 'medium'/'medio', 'large'/'grande'."
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Breed",
"default": null,
"description": "Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "Quantos resultados devolver por página. Valores acima de 24 são reduzidos a 24. Buscar por `name` devolve no máximo 5: é uma lista para confirmar, não para navegar."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), apenas para desambiguar `city`. Busca só por estado NÃO é suportada: sempre envie `city` junto."
},
"rescuer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Rescuer",
"default": null,
"description": "Restringe a busca a UMA ONG ou protetor: o código curto do link ou o @ do Instagram da ONG. Combina com os outros filtros ('gatos filhotes desta ONG'). Sem ele a busca cobre o catálogo inteiro."
},
"species": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Species",
"default": null,
"description": "Espécie: 'dog'/'cachorro' ou 'cat'/'gato'."
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Neutered",
"default": null,
"description": "true devolve somente pets castrados. `false` é IGNORADO pelo mesmo motivo de `vaccinated`; o valor de cada pet está em `neutered`."
},
"radius_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Radius Km",
"default": null,
"description": "Raio em km (1 a 100) para `area=radius`. Mandar só `radius_km` já significa raio."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Vaccinated",
"default": null,
"description": "true devolve somente pets vacinados. `false` é IGNORADO: a maioria dos anúncios não informa vacinação, então filtrar por 'não vacinado' esconderia quase todo o catálogo. O valor de cada pet está em `vaccinated` (null = a ONG não informou)."
},
"include_older": {
"type": "boolean",
"title": "Include Older",
"default": false,
"description": "Sem efeito no momento: o catálogo devolve os pets anunciados em qualquer data, independente deste parâmetro. Mantido por compatibilidade. Um resultado pode ser antigo: `days_without_update`, quando vem, diz há quanto tempo."
},
"special_needs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Special Needs",
"default": null,
"description": "true devolve somente pets com cuidados especiais; false devolve somente os que não têm nenhum registrado."
},
"age_max_months": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Age Max Months",
"default": null,
"description": "Idade máxima em meses. O catálogo só distingue três faixas — filhote, adulto e idoso — então sem porte 6 e 12 selecionam os mesmos pets. Os cortes mudam com espécie e porte: idoso a partir de 8 anos no cão grande, 9 no médio, 10 no pequeno e no gato."
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Cats",
"default": null,
"description": "Somente pets que convivem bem com gatos."
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Dogs",
"default": null,
"description": "Somente pets que convivem bem com cães."
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Kids",
"default": null,
"description": "Somente pets que convivem bem com crianças."
},
"widen_if_empty": {
"type": "boolean",
"title": "Widen If Empty",
"default": false,
"description": "Se a área pedida não tiver pets disponíveis com os filtros, amplia a partir dela: cidades vizinhas, depois raio de 50 km, depois 100 km, parando no primeiro passo com pets. `searched_area` diz o que foi usado."
}
},
"additionalProperties": false
}search_pets output schema
{
"type": "object",
"$defs": {
"AgentRescuer": {
"type": "object",
"title": "AgentRescuer",
"required": [
"name",
"instagram_url"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"description": "Nome da ONG ou protetor responsável pelo pet."
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Instagram Url",
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url."
}
}
},
"AgentNameMatch": {
"type": "object",
"title": "AgentNameMatch",
"required": [
"query",
"confidence"
],
"properties": {
"query": {
"type": "string",
"title": "Query",
"description": "O nome que foi buscado."
},
"confidence": {
"enum": [
"high",
"low"
],
"type": "string",
"title": "Confidence",
"description": "'high' = é este pet: afirme direto. 'low' = NÃO afirme qual é; mostre os pets da lista e pergunte qual deles."
}
}
},
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentPetSummary": {
"type": "object",
"title": "AgentPetSummary",
"required": [
"short_code",
"name",
"species",
"sex",
"size",
"breed",
"age",
"age_category",
"city",
"status",
"photo_url",
"adoption_url",
"rescuer"
],
"properties": {
"age": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Age",
"description": "Idade legível, ex.: '6 meses', '2 anos'. Acima de um ano a idade é dada em anos inteiros; abaixo, em meses."
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sex",
"description": "'macho' ou 'fêmea'."
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"description": "Cidade e UF onde o pet está, ex.: 'Campinas - SP'."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"description": "Nome do pet, quando a ONG informou."
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size",
"description": "Porte: 'pequeno', 'médio' ou 'grande'."
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Breed",
"description": "Raça informada; a maioria é SRD (sem raça definida)."
},
"status": {
"type": "string",
"title": "Status",
"description": "'available', 'adopted', 'deceased' ou 'source_gone' (post original saiu do ar: pode ter sido adotado; confirme com o protetor). Nunca ofereça um pet que não esteja 'available'. 'available' só diz que ninguém sinalizou mudança: leia `days_without_update` antes de afirmar que está disponível."
},
"rescuer": {
"$ref": "#/$defs/AgentRescuer",
"description": "Quem cuida do pet."
},
"species": {
"type": "string",
"title": "Species",
"description": "'cachorro' ou 'gato'."
},
"dewormed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Dewormed",
"default": null,
"description": "null = a ONG não informou."
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Neutered",
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não castrado' quando for null."
},
"photo_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Photo Url",
"description": "Foto principal do pet."
},
"short_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Short Code",
"description": "Código curto do pet (o mesmo de adoteca.com.br/p/{code})."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Vaccinated",
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não vacinado' quando for null."
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Contact Url",
"default": null,
"description": "Link para falar com a ONG sobre este pet: abre uma página da Adoteca que leva ao post original no Instagram. Mostre este link ao indicar contato."
},
"distance_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Distance Km",
"default": null,
"description": "Distância em km entre o centro da cidade do pet e o da cidade buscada (0 = a própria cidade). Só vem quando a busca usou `area` ou `widen_if_empty`."
},
"adoption_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Adoption Url",
"description": "Link da ficha do pet. SEMPRE mostre este link na resposta."
},
"age_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Age Category",
"description": "Faixa etária: 'filhote', 'adulto' ou 'idoso'."
},
"microchipped": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Microchipped",
"default": null,
"description": "null = a ONG não informou."
},
"foster_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Foster Status",
"default": null,
"description": "'aceita lar temporário' ou 'precisa de lar temporário'. Muda o que se pede à pessoa: não é adoção definitiva. null = não classificado."
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Cats",
"default": null,
"description": "null = a ONG não informou."
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Dogs",
"default": null,
"description": "null = a ONG não informou."
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Kids",
"default": null,
"description": "null = a ONG não informou."
},
"adoption_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Adoption Evidence",
"default": null,
"description": "Só quando status='adopted': 'announced' (a ONG anunciou) ou 'unlisted' (o post saiu do ar e a ONG confirma isso como adoção). null nos demais status."
},
"published_recently": {
"anyOf": [
{
"$ref": "#/$defs/AgentPublishedRecently"
},
{
"type": "null"
}
],
"default": null,
"description": "Preenchido só na busca por nome: a Adoteca postou este pet nesta rede há pouco. Use para situar a pessoa ('o que postamos no Instagram') em vez de afirmar sem contexto."
},
"days_without_update": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Days Without Update",
"default": null,
"description": "Dias desde a última notícia nova sobre este pet (publicação da ONG ou sinal de adoção). null = desfecho confirmado ou data desconhecida. Passado um mês, diga que nada novo chegou desde então e que o pet pode ou não continuar disponível; quem confirma é quem cuida dele."
}
}
},
"AgentSearchedArea": {
"type": "object",
"title": "AgentSearchedArea",
"required": [
"area",
"radius_km",
"widened",
"cities"
],
"properties": {
"area": {
"enum": [
"city",
"neighbors",
"radius"
],
"type": "string",
"title": "Area",
"description": "Área usada: 'city' (só a cidade), 'neighbors' (a cidade e as que fazem divisa com ela) ou 'radius' (também as cidades a até `radius_km`)."
},
"cities": {
"type": "integer",
"title": "Cities",
"description": "Quantas cidades a área cobriu (0 = busca sem cidade)."
},
"widened": {
"type": "boolean",
"title": "Widened",
"description": "true quando a cidade não tinha pets e a busca foi ampliada sozinha (widen_if_empty). Diga isso à pessoa e cite a cidade de cada pet."
},
"radius_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Radius Km",
"description": "Raio em km quando `area` é 'radius'; senão null."
}
},
"description": "The area the pet search actually ran — after any automatic widening."
},
"AgentSearchResponse": {
"type": "object",
"title": "AgentSearchResponse",
"required": [
"total",
"available_total",
"page",
"pets"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"description": "Página devolvida (começa em 1)."
},
"pets": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentPetSummary"
},
"title": "Pets",
"description": "Os pets desta página."
},
"total": {
"type": "integer",
"title": "Total",
"description": "Total de pets que atendem aos filtros."
},
"name_match": {
"anyOf": [
{
"$ref": "#/$defs/AgentNameMatch"
},
{
"type": "null"
}
],
"default": null,
"description": "Só quando a busca enviou `name`. Leia `confidence` antes de afirmar de qual pet a pessoa está falando."
},
"searched_area": {
"anyOf": [
{
"$ref": "#/$defs/AgentSearchedArea"
},
{
"type": "null"
}
],
"default": null,
"description": "A área que a busca realmente cobriu. Se `widened` for true, os pets não são da cidade pedida: diga isso antes de listá-los."
},
"available_total": {
"type": "integer",
"title": "Available Total",
"description": "Quantos desses pets estão disponíveis para adoção (status 'available'). É o número do título do catálogo; use este, não `total`, ao dizer quantos pets há para adotar."
}
}
},
"AgentPublishedRecently": {
"type": "object",
"title": "AgentPublishedRecently",
"required": [
"platform",
"published_at"
],
"properties": {
"platform": {
"type": "string",
"title": "Platform",
"description": "Rede onde a Adoteca postou este pet, ex.: 'Instagram'."
},
"published_at": {
"type": "string",
"title": "Published At",
"format": "date-time",
"description": "Quando a Adoteca postou."
}
}
}
},
"title": "search_petsOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentSearchResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}search_pets annotations
{
"title": "Buscar pets para adoção",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_pet_details — Ver ficha completa do pet
Advertised read-onlyOpen-world
Ficha completa de um pet: saúde, cuidados, convivência e como falar com a ONG. Aceita o código curto do link ou o id de um pet já listado. Traz o `status` do pet e o resultado de cada item de `health_conditions`.
get_pet_details input schema
{
"type": "object",
"title": "get_pet_detailsArguments",
"required": [
"pet_ref"
],
"properties": {
"pet_ref": {
"type": "string",
"title": "Pet Ref",
"description": "Código curto do pet (ex.: 'ab12cd') ou o identificador da ficha."
}
},
"additionalProperties": false
}get_pet_details output schema
{
"type": "object",
"$defs": {
"AgentContact": {
"type": "object",
"title": "AgentContact",
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"type": "string",
"title": "Kind",
"description": "Tipo do canal, já em português: 'WhatsApp', 'Telefone', 'E-mail' ou 'Site'."
},
"value": {
"type": "string",
"title": "Value",
"description": "O contato em si, já validado e formatado."
}
}
},
"AgentRescuer": {
"type": "object",
"title": "AgentRescuer",
"required": [
"name",
"instagram_url"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"description": "Nome da ONG ou protetor responsável pelo pet."
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Instagram Url",
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url."
}
}
},
"AgentPetDetail": {
"type": "object",
"title": "AgentPetDetail",
"required": [
"short_code",
"name",
"species",
"sex",
"size",
"breed",
"age",
"age_category",
"city",
"status",
"photo_url",
"adoption_url",
"rescuer"
],
"properties": {
"age": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Age",
"description": "Idade legível, ex.: '6 meses', '2 anos'. Acima de um ano a idade é dada em anos inteiros; abaixo, em meses."
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sex",
"description": "'macho' ou 'fêmea'."
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"description": "Cidade e UF onde o pet está, ex.: 'Campinas - SP'."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"description": "Nome do pet, quando a ONG informou."
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size",
"description": "Porte: 'pequeno', 'médio' ou 'grande'."
},
"about": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "About",
"default": null,
"description": "Seções do 'Sobre o pet' (personalidade, rotina, cuidados)."
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Breed",
"description": "Raça informada; a maioria é SRD (sem raça definida)."
},
"colors": {
"type": "array",
"items": {
"type": "string"
},
"title": "Colors",
"description": "Cores e padrões da pelagem, já em português (ex.: 'preto', 'rajada')."
},
"photos": {
"type": "array",
"items": {
"type": "string"
},
"title": "Photos",
"description": "Todas as fotos do pet."
},
"status": {
"type": "string",
"title": "Status",
"description": "'available', 'adopted', 'deceased' ou 'source_gone' (post original saiu do ar: pode ter sido adotado; confirme com o protetor). Nunca ofereça um pet que não esteja 'available'. 'available' só diz que ninguém sinalizou mudança: leia `days_without_update` antes de afirmar que está disponível."
},
"rescuer": {
"$ref": "#/$defs/AgentRescuer",
"description": "Quem cuida do pet."
},
"species": {
"type": "string",
"title": "Species",
"description": "'cachorro' ou 'gato'."
},
"contacts": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentContact"
},
"title": "Contacts",
"description": "Contatos do próprio anúncio."
},
"dewormed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Dewormed",
"default": null,
"description": "null = a ONG não informou."
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Neutered",
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não castrado' quando for null."
},
"vaccines": {
"type": "array",
"items": {
"type": "string"
},
"title": "Vaccines",
"description": "Vacinas já aplicadas, já em português (ex.: 'antirrábica', 'V10')."
},
"photo_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Photo Url",
"description": "Foto principal do pet."
},
"short_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Short Code",
"description": "Código curto do pet (o mesmo de adoteca.com.br/p/{code})."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Vaccinated",
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não vacinado' quando for null."
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Contact Url",
"default": null,
"description": "Link para falar com a ONG sobre este pet: abre uma página da Adoteca que leva ao post original no Instagram. Mostre este link ao indicar contato."
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description",
"default": null,
"description": "Texto sobre o pet, transcrito do post original."
},
"distance_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Distance Km",
"default": null,
"description": "Distância em km entre o centro da cidade do pet e o da cidade buscada (0 = a própria cidade). Só vem quando a busca usou `area` ou `widen_if_empty`."
},
"adoption_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Adoption Url",
"description": "Link da ficha do pet. SEMPRE mostre este link na resposta."
},
"age_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Age Category",
"description": "Faixa etária: 'filhote', 'adulto' ou 'idoso'."
},
"disabilities": {
"type": "array",
"items": {
"type": "string"
},
"title": "Disabilities",
"description": "Deficiências informadas, já em português (ex.: 'cega', 'baixa visão')."
},
"microchipped": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Microchipped",
"default": null,
"description": "null = a ONG não informou."
},
"foster_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Foster Status",
"default": null,
"description": "'aceita lar temporário' ou 'precisa de lar temporário'. Muda o que se pede à pessoa: não é adoção definitiva. null = não classificado."
},
"special_needs": {
"type": "array",
"items": {
"type": "string"
},
"title": "Special Needs",
"description": "Cuidados e requisitos de adoção, já em português (ex.: 'lar com telas')."
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Cats",
"default": null,
"description": "null = a ONG não informou."
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Dogs",
"default": null,
"description": "null = a ONG não informou."
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Kids",
"default": null,
"description": "null = a ONG não informou."
},
"source_post_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Post Url",
"default": null,
"description": "Post original da ONG no Instagram."
},
"rescuer_contacts": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentContact"
},
"title": "Rescuer Contacts",
"description": "Contatos gerais da ONG — use quando 'contacts' estiver vazio."
},
"adoption_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Adoption Evidence",
"default": null,
"description": "Só quando status='adopted': 'announced' (a ONG anunciou) ou 'unlisted' (o post saiu do ar e a ONG confirma isso como adoção). null nos demais status."
},
"health_conditions": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentHealthCondition"
},
"title": "Health Conditions",
"description": "Condições examinadas COM o resultado de cada uma. Nunca cite uma condição sem ler o `status` — 'negativo' significa que o pet não a tem."
},
"published_recently": {
"anyOf": [
{
"$ref": "#/$defs/AgentPublishedRecently"
},
{
"type": "null"
}
],
"default": null,
"description": "Preenchido só na busca por nome: a Adoteca postou este pet nesta rede há pouco. Use para situar a pessoa ('o que postamos no Instagram') em vez de afirmar sem contexto."
},
"days_without_update": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Days Without Update",
"default": null,
"description": "Dias desde a última notícia nova sobre este pet (publicação da ONG ou sinal de adoção). null = desfecho confirmado ou data desconhecida. Passado um mês, diga que nada novo chegou desde então e que o pet pode ou não continuar disponível; quem confirma é quem cuida dele."
}
}
},
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentHealthCondition": {
"type": "object",
"title": "AgentHealthCondition",
"required": [
"condition",
"status"
],
"properties": {
"status": {
"type": "string",
"title": "Status",
"description": "Resultado: 'positivo', 'negativo', 'suspeito' ou 'tratado'. LEIA este campo antes de afirmar qualquer coisa: 'negativo' significa que o pet NÃO tem a condição."
},
"condition": {
"type": "string",
"title": "Condition",
"description": "Condição examinada, ex.: 'FIV', 'FELV'."
}
},
"description": "A reported condition AND its diagnostic result.\n\nThe two travel together or not at all: a NEGATIVE FIV exam is the opposite\nof an FIV diagnosis, and emitting the condition alone would have an\nassistant tell an adopter the pet is positive when the ONG said it is not."
},
"AgentPublishedRecently": {
"type": "object",
"title": "AgentPublishedRecently",
"required": [
"platform",
"published_at"
],
"properties": {
"platform": {
"type": "string",
"title": "Platform",
"description": "Rede onde a Adoteca postou este pet, ex.: 'Instagram'."
},
"published_at": {
"type": "string",
"title": "Published At",
"format": "date-time",
"description": "Quando a Adoteca postou."
}
}
}
},
"title": "get_pet_detailsOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentPetDetail"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}get_pet_details annotations
{
"title": "Ver ficha completa do pet",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}search_similar_pets — Ver pets parecidos
Advertised read-onlyOpen-world
Pets parecidos com UM pet específico, mesma espécie e mesma cidade — não é a busca geral do catálogo. Use quando o pet desejado já não estiver disponível. Só traz pets disponíveis, cada um com o `adoption_url`, e pode vir vazia. `total` é o tamanho desta lista; não há página 2.
search_similar_pets input schema
{
"type": "object",
"title": "search_similar_petsArguments",
"required": [
"pet_ref"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 6,
"description": "Quantos pets parecidos devolver, no máximo 24. Esta lista não tem páginas: não existe `page` aqui."
},
"pet_ref": {
"type": "string",
"title": "Pet Ref",
"description": "Código curto do pet (ex.: 'ab12cd') ou o identificador da ficha."
}
},
"additionalProperties": false
}search_similar_pets output schema
{
"type": "object",
"$defs": {
"AgentRescuer": {
"type": "object",
"title": "AgentRescuer",
"required": [
"name",
"instagram_url"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"description": "Nome da ONG ou protetor responsável pelo pet."
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Instagram Url",
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url."
}
}
},
"AgentNameMatch": {
"type": "object",
"title": "AgentNameMatch",
"required": [
"query",
"confidence"
],
"properties": {
"query": {
"type": "string",
"title": "Query",
"description": "O nome que foi buscado."
},
"confidence": {
"enum": [
"high",
"low"
],
"type": "string",
"title": "Confidence",
"description": "'high' = é este pet: afirme direto. 'low' = NÃO afirme qual é; mostre os pets da lista e pergunte qual deles."
}
}
},
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentPetSummary": {
"type": "object",
"title": "AgentPetSummary",
"required": [
"short_code",
"name",
"species",
"sex",
"size",
"breed",
"age",
"age_category",
"city",
"status",
"photo_url",
"adoption_url",
"rescuer"
],
"properties": {
"age": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Age",
"description": "Idade legível, ex.: '6 meses', '2 anos'. Acima de um ano a idade é dada em anos inteiros; abaixo, em meses."
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sex",
"description": "'macho' ou 'fêmea'."
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"description": "Cidade e UF onde o pet está, ex.: 'Campinas - SP'."
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"description": "Nome do pet, quando a ONG informou."
},
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Size",
"description": "Porte: 'pequeno', 'médio' ou 'grande'."
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Breed",
"description": "Raça informada; a maioria é SRD (sem raça definida)."
},
"status": {
"type": "string",
"title": "Status",
"description": "'available', 'adopted', 'deceased' ou 'source_gone' (post original saiu do ar: pode ter sido adotado; confirme com o protetor). Nunca ofereça um pet que não esteja 'available'. 'available' só diz que ninguém sinalizou mudança: leia `days_without_update` antes de afirmar que está disponível."
},
"rescuer": {
"$ref": "#/$defs/AgentRescuer",
"description": "Quem cuida do pet."
},
"species": {
"type": "string",
"title": "Species",
"description": "'cachorro' ou 'gato'."
},
"dewormed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Dewormed",
"default": null,
"description": "null = a ONG não informou."
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Neutered",
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não castrado' quando for null."
},
"photo_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Photo Url",
"description": "Foto principal do pet."
},
"short_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Short Code",
"description": "Código curto do pet (o mesmo de adoteca.com.br/p/{code})."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Vaccinated",
"default": null,
"description": "null = a ONG não informou. Nunca afirme 'não vacinado' quando for null."
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Contact Url",
"default": null,
"description": "Link para falar com a ONG sobre este pet: abre uma página da Adoteca que leva ao post original no Instagram. Mostre este link ao indicar contato."
},
"distance_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Distance Km",
"default": null,
"description": "Distância em km entre o centro da cidade do pet e o da cidade buscada (0 = a própria cidade). Só vem quando a busca usou `area` ou `widen_if_empty`."
},
"adoption_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Adoption Url",
"description": "Link da ficha do pet. SEMPRE mostre este link na resposta."
},
"age_category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Age Category",
"description": "Faixa etária: 'filhote', 'adulto' ou 'idoso'."
},
"microchipped": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Microchipped",
"default": null,
"description": "null = a ONG não informou."
},
"foster_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Foster Status",
"default": null,
"description": "'aceita lar temporário' ou 'precisa de lar temporário'. Muda o que se pede à pessoa: não é adoção definitiva. null = não classificado."
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Cats",
"default": null,
"description": "null = a ONG não informou."
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Dogs",
"default": null,
"description": "null = a ONG não informou."
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Kids",
"default": null,
"description": "null = a ONG não informou."
},
"adoption_evidence": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Adoption Evidence",
"default": null,
"description": "Só quando status='adopted': 'announced' (a ONG anunciou) ou 'unlisted' (o post saiu do ar e a ONG confirma isso como adoção). null nos demais status."
},
"published_recently": {
"anyOf": [
{
"$ref": "#/$defs/AgentPublishedRecently"
},
{
"type": "null"
}
],
"default": null,
"description": "Preenchido só na busca por nome: a Adoteca postou este pet nesta rede há pouco. Use para situar a pessoa ('o que postamos no Instagram') em vez de afirmar sem contexto."
},
"days_without_update": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Days Without Update",
"default": null,
"description": "Dias desde a última notícia nova sobre este pet (publicação da ONG ou sinal de adoção). null = desfecho confirmado ou data desconhecida. Passado um mês, diga que nada novo chegou desde então e que o pet pode ou não continuar disponível; quem confirma é quem cuida dele."
}
}
},
"AgentSearchedArea": {
"type": "object",
"title": "AgentSearchedArea",
"required": [
"area",
"radius_km",
"widened",
"cities"
],
"properties": {
"area": {
"enum": [
"city",
"neighbors",
"radius"
],
"type": "string",
"title": "Area",
"description": "Área usada: 'city' (só a cidade), 'neighbors' (a cidade e as que fazem divisa com ela) ou 'radius' (também as cidades a até `radius_km`)."
},
"cities": {
"type": "integer",
"title": "Cities",
"description": "Quantas cidades a área cobriu (0 = busca sem cidade)."
},
"widened": {
"type": "boolean",
"title": "Widened",
"description": "true quando a cidade não tinha pets e a busca foi ampliada sozinha (widen_if_empty). Diga isso à pessoa e cite a cidade de cada pet."
},
"radius_km": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Radius Km",
"description": "Raio em km quando `area` é 'radius'; senão null."
}
},
"description": "The area the pet search actually ran — after any automatic widening."
},
"AgentSearchResponse": {
"type": "object",
"title": "AgentSearchResponse",
"required": [
"total",
"available_total",
"page",
"pets"
],
"properties": {
"page": {
"type": "integer",
"title": "Page",
"description": "Página devolvida (começa em 1)."
},
"pets": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentPetSummary"
},
"title": "Pets",
"description": "Os pets desta página."
},
"total": {
"type": "integer",
"title": "Total",
"description": "Total de pets que atendem aos filtros."
},
"name_match": {
"anyOf": [
{
"$ref": "#/$defs/AgentNameMatch"
},
{
"type": "null"
}
],
"default": null,
"description": "Só quando a busca enviou `name`. Leia `confidence` antes de afirmar de qual pet a pessoa está falando."
},
"searched_area": {
"anyOf": [
{
"$ref": "#/$defs/AgentSearchedArea"
},
{
"type": "null"
}
],
"default": null,
"description": "A área que a busca realmente cobriu. Se `widened` for true, os pets não são da cidade pedida: diga isso antes de listá-los."
},
"available_total": {
"type": "integer",
"title": "Available Total",
"description": "Quantos desses pets estão disponíveis para adoção (status 'available'). É o número do título do catálogo; use este, não `total`, ao dizer quantos pets há para adotar."
}
}
},
"AgentPublishedRecently": {
"type": "object",
"title": "AgentPublishedRecently",
"required": [
"platform",
"published_at"
],
"properties": {
"platform": {
"type": "string",
"title": "Platform",
"description": "Rede onde a Adoteca postou este pet, ex.: 'Instagram'."
},
"published_at": {
"type": "string",
"title": "Published At",
"format": "date-time",
"description": "Quando a Adoteca postou."
}
}
}
},
"title": "search_similar_petsOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentSearchResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}search_similar_pets annotations
{
"title": "Ver pets parecidos",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}search_rescuers — Buscar ONGs e protetores na cidade
Advertised read-onlyOpen-world
Use quando perguntarem QUAIS ONGs ou protetores existem em uma cidade. Lista quem tem pets no catálogo ali, com o link de cada um. Vem só de anúncios, que podem ser antigos: não é registro completo e não indica se a ONG está ativa nem se tem vaga para acolher.
search_rescuers input schema
{
"type": "object",
"title": "search_rescuersArguments",
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"title": "City",
"description": "Nome do MUNICÍPIO por extenso, ou o slug devolvido pela resolução de cidade. Obrigatório: a resposta é sempre de uma cidade. Se o nome for ambíguo ou ninguém tiver pets ali hoje, o erro diz o que fazer."
},
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"description": "Página, começando em 1."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "Quantos resultados devolver por página. Valores acima de 24 são reduzidos a 24. Buscar por `name` devolve no máximo 5: é uma lista para confirmar, não para navegar."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), se a pessoa informou. Opcional."
}
},
"additionalProperties": false
}search_rescuers output schema
{
"type": "object",
"$defs": {
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentRescuerSummary": {
"type": "object",
"title": "AgentRescuerSummary",
"required": [
"short_code",
"name",
"city",
"available_count",
"adopted_count",
"profile_url",
"instagram_url",
"avatar_url"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"description": "Cidade base, ex.: 'Niterói - RJ'."
},
"name": {
"type": "string",
"title": "Name",
"description": "Nome da ONG ou protetor."
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Avatar Url",
"description": "Foto de perfil da ONG."
},
"short_code": {
"type": "string",
"title": "Short Code",
"description": "Código curto da ONG (o mesmo de adoteca.com.br/o/{code})."
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Contact Url",
"default": null,
"description": "Link para falar com a ONG: abre uma página da Adoteca que leva ao Instagram dela. Mostre este link ao indicar contato."
},
"profile_url": {
"type": "string",
"title": "Profile Url",
"description": "Página da ONG na Adoteca, com todos os pets e formas de ajudar. SEMPRE mostre este link ao falar da ONG."
},
"adopted_count": {
"type": "integer",
"title": "Adopted Count",
"description": "Pets já adotados através dos anúncios."
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Instagram Url",
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url."
},
"available_count": {
"type": "integer",
"title": "Available Count",
"description": "Pets com anúncio ativo para adoção. O anúncio pode ser antigo — não prometa à pessoa que é recente."
}
}
},
"AgentRescuerSearchResponse": {
"type": "object",
"title": "AgentRescuerSearchResponse",
"required": [
"total",
"page",
"note",
"rescuers"
],
"properties": {
"note": {
"type": "string",
"title": "Note",
"description": "Contexto obrigatório: a lista cobre só quem tem pets anunciados no catálogo, de qualquer data — não é um registro de todas as ONGs da cidade, nem garantia de que estejam ativas hoje."
},
"page": {
"type": "integer",
"title": "Page",
"description": "Página devolvida (começa em 1)."
},
"total": {
"type": "integer",
"title": "Total",
"description": "Total de ONGs e protetores com pets na cidade."
},
"rescuers": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentRescuerSummary"
},
"title": "Rescuers",
"description": "As ONGs desta página."
}
}
}
},
"title": "search_rescuersOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentRescuerSearchResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}search_rescuers annotations
{
"title": "Buscar ONGs e protetores na cidade",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_rescuer_details — Ver ficha da ONG ou protetor
Advertised read-onlyOpen-world
Ficha de uma ONG ou protetor: cidades atendidas, contatos, site e página de doação (`donation_url`). Aceita o código curto do link ou o @ do Instagram da ONG. Não traz chave PIX.
get_rescuer_details input schema
{
"type": "object",
"title": "get_rescuer_detailsArguments",
"required": [
"rescuer_ref"
],
"properties": {
"rescuer_ref": {
"type": "string",
"title": "Rescuer Ref",
"description": "Código curto da ONG (ex.: 'ab12cd', o mesmo de adoteca.com.br/o/{code}) ou o @ do Instagram dela, sem arroba."
}
},
"additionalProperties": false
}get_rescuer_details output schema
{
"type": "object",
"$defs": {
"AgentContact": {
"type": "object",
"title": "AgentContact",
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"type": "string",
"title": "Kind",
"description": "Tipo do canal, já em português: 'WhatsApp', 'Telefone', 'E-mail' ou 'Site'."
},
"value": {
"type": "string",
"title": "Value",
"description": "O contato em si, já validado e formatado."
}
}
},
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentRescuerDetail": {
"type": "object",
"title": "AgentRescuerDetail",
"required": [
"short_code",
"name",
"city",
"available_count",
"adopted_count",
"profile_url",
"instagram_url",
"avatar_url"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"description": "Cidade base, ex.: 'Niterói - RJ'."
},
"cnpj": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cnpj",
"default": null,
"description": "CNPJ da ONG, quando é uma entidade registrada. É um sinal de confiança, não um dado administrativo: antes de doar, a pessoa deve conferir se o nome que aparece na tela do PIX bate com este CNPJ. 14 dígitos, sem pontuação."
},
"name": {
"type": "string",
"title": "Name",
"description": "Nome da ONG ou protetor."
},
"about": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "About",
"default": null,
"description": "Parágrafo de apresentação da ONG."
},
"cities": {
"type": "array",
"items": {
"type": "string"
},
"title": "Cities",
"description": "Cidades atendidas, ex.: 'Niterói - RJ'."
},
"contacts": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentContact"
},
"title": "Contacts",
"description": "Canais de contato da ONG."
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Avatar Url",
"description": "Foto de perfil da ONG."
},
"short_code": {
"type": "string",
"title": "Short Code",
"description": "Código curto da ONG (o mesmo de adoteca.com.br/o/{code})."
},
"contact_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Contact Url",
"default": null,
"description": "Link para falar com a ONG: abre uma página da Adoteca que leva ao Instagram dela. Mostre este link ao indicar contato."
},
"profile_url": {
"type": "string",
"title": "Profile Url",
"description": "Página da ONG na Adoteca, com todos os pets e formas de ajudar. SEMPRE mostre este link ao falar da ONG."
},
"website_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Website Url",
"default": null,
"description": "Site oficial."
},
"donation_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Donation Url",
"default": null,
"description": "Página de doação/vaquinha da ONG. Para doar por PIX, direcione a pessoa ao profile_url — nunca repasse chaves."
},
"adopted_count": {
"type": "integer",
"title": "Adopted Count",
"description": "Pets já adotados através dos anúncios."
},
"founding_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Founding Year",
"default": null,
"description": "Ano de fundação, se informado."
},
"instagram_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Instagram Url",
"description": "Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url."
},
"available_count": {
"type": "integer",
"title": "Available Count",
"description": "Pets com anúncio ativo para adoção. O anúncio pode ser antigo — não prometa à pessoa que é recente."
},
"social_profiles": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentSocialProfile"
},
"title": "Social Profiles",
"description": "Perfis da ONG nas redes."
}
},
"description": "The summary PLUS the fields a person needs before contacting an ONG.\n\nDeliberately NOT everything `account_to_detail` carries: `pix_key` and\n`like_count` are excluded (as is `display_name`, which only the admin\nmapper emits) — see `agent_rescuer_detail`."
},
"AgentSocialProfile": {
"type": "object",
"title": "AgentSocialProfile",
"required": [
"platform",
"url"
],
"properties": {
"url": {
"type": "string",
"title": "Url",
"description": "Link do perfil."
},
"platform": {
"type": "string",
"title": "Platform",
"description": "Rede social, já pronta para mostrar, ex.: 'Instagram', 'TikTok'."
}
}
}
},
"title": "get_rescuer_detailsOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentRescuerDetail"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}get_rescuer_details annotations
{
"title": "Ver ficha da ONG ou protetor",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}search_cities — Encontrar a cidade no catálogo
Advertised read-onlyOpen-world
Converte o nome de uma cidade (com ou sem acento, com erro de grafia) no slug oficial do catálogo, com a UF. Use quando a pessoa citar uma cidade. `ambiguous` vem true quando o nome existe em mais de um estado. Não traz os números da cidade.
search_cities input schema
{
"type": "object",
"title": "search_citiesArguments",
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"title": "City",
"description": "Nome do município como a pessoa escreveu, ex.: 'sao paulo', 'Cachoeirinha'."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), se a pessoa informou. Opcional."
}
},
"additionalProperties": false
}search_cities output schema
{
"type": "object",
"$defs": {
"AgentCityMatch": {
"type": "object",
"title": "AgentCityMatch",
"required": [
"slug",
"name",
"state",
"pet_count",
"rescuer_count"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"description": "Nome do município."
},
"slug": {
"type": "string",
"title": "Slug",
"description": "Slug oficial do município no catálogo, ex.: 'santa-luzia-mg'."
},
"state": {
"type": "string",
"title": "State",
"description": "Sigla da UF, ex.: 'MG'."
},
"pet_count": {
"type": "integer",
"title": "Pet Count",
"description": "Pets já anunciados nessa cidade, de qualquer data. Inclui os já adotados e anúncios antigos, então pode ser bem maior que o número disponível agora. Não prometa à pessoa que são recentes."
},
"rescuer_count": {
"type": "integer",
"title": "Rescuer Count",
"description": "ONGs e protetores com pets anunciados nessa cidade."
}
}
},
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentFindCityResponse": {
"type": "object",
"title": "AgentFindCityResponse",
"required": [
"found",
"ambiguous",
"cities"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null,
"description": "Quando presente, explica o resultado: nenhuma cidade encontrada, ou candidatas demais e a lista foi cortada. Leia e siga."
},
"found": {
"type": "boolean",
"title": "Found",
"description": "Se alguma cidade com esse nome está no catálogo. Veja `pet_count` de cada uma."
},
"cities": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentCityMatch"
},
"title": "Cities",
"description": "Cidades correspondentes, mais pets primeiro."
},
"ambiguous": {
"type": "boolean",
"title": "Ambiguous",
"description": "true = mais de uma cidade corresponde. Escolha pelo contexto da conversa ou pergunte à pessoa; NUNCA chute."
}
}
}
},
"title": "search_citiesOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentFindCityResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}search_cities annotations
{
"title": "Encontrar a cidade no catálogo",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_city_stats — Ver números do catálogo na cidade
Advertised read-onlyOpen-world
Números do catálogo em UMA cidade já resolvida: quantos pets, por espécie, porte e idade, entradas em 24h, adoções, quantas ONGs e as raças mais comuns. Use para 'quantos pets tem em X?'. Não devolve pets, não resolve o nome da cidade e não lista QUAIS são as ONGs.
get_city_stats input schema
{
"type": "object",
"title": "get_city_statsArguments",
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"title": "City",
"description": "Nome do MUNICÍPIO por extenso, ou o slug devolvido pela resolução de cidade. Obrigatório: a resposta é sempre de uma cidade. Se o nome for ambíguo ou ninguém tiver pets ali hoje, o erro diz o que fazer."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), se a pessoa informou. Opcional."
}
},
"additionalProperties": false
}get_city_stats output schema
{
"type": "object",
"$defs": {
"AgentCityStats": {
"type": "object",
"title": "AgentCityStats",
"required": [
"city",
"pet_count",
"available_count",
"total_ever",
"by_species",
"by_age",
"by_size",
"new_last_24h",
"adopted_total",
"rescuer_count",
"rank",
"national_pct",
"top_breeds"
],
"properties": {
"city": {
"type": "string",
"title": "City",
"description": "Cidade e UF, ex.: 'Campinas - SP'."
},
"rank": {
"type": "integer",
"title": "Rank",
"description": "Posição da cidade no ranking nacional por `total_ever` (1 = 1º)."
},
"by_age": {
"type": "object",
"title": "By Age",
"description": "Quantos por faixa etária: 'filhote', 'adulto', 'idoso'. Pets sem idade informada ficam de fora, então pode somar menos que `total_ever`.",
"additionalProperties": {
"type": "integer"
}
},
"by_size": {
"type": "object",
"title": "By Size",
"description": "Quantos por porte: 'pequeno', 'médio', 'grande'. Pets sem porte informado ficam de fora, então pode somar menos que `total_ever`.",
"additionalProperties": {
"type": "integer"
}
},
"pet_count": {
"type": "integer",
"title": "Pet Count",
"description": "Pets já anunciados nessa cidade, de qualquer data. Inclui os já adotados e anúncios antigos, então pode ser bem maior que o número disponível agora. Não prometa à pessoa que são recentes."
},
"by_species": {
"type": "object",
"title": "By Species",
"description": "Quantos por espécie: chaves 'cachorro' e 'gato'. Somam `total_ever`.",
"additionalProperties": {
"type": "integer"
}
},
"top_breeds": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentBreedCount"
},
"title": "Top Breeds",
"description": "As raças mais comuns na cidade em todo o histórico, as mais numerosas primeiro."
},
"total_ever": {
"type": "integer",
"title": "Total Ever",
"description": "Pets já anunciados nessa cidade desde o início do catálogo, sem recorte de tempo. É a base dos campos por espécie, idade e porte, do `rank` e do `national_pct` — todos históricos. `pet_count` carrega hoje o mesmo número: este retorno não tem um recorte de 'anunciado agora'."
},
"national_pct": {
"type": "number",
"title": "National Pct",
"description": "Percentual de todo o catálogo histórico que está nessa cidade, ex.: 2.4. Calculado sobre `total_ever`."
},
"new_last_24h": {
"type": "integer",
"title": "New Last 24H",
"description": "Pets que entraram no catálogo dessa cidade em 24h."
},
"adopted_total": {
"type": "integer",
"title": "Adopted Total",
"description": "Adoções já registradas nessa cidade, desde o início do catálogo."
},
"rescuer_count": {
"type": "integer",
"title": "Rescuer Count",
"description": "ONGs e protetores com pets anunciados nessa cidade."
},
"available_count": {
"type": "integer",
"title": "Available Count",
"description": "Pets dessa cidade disponíveis para adoção agora. É este o número para dizer quantos pets a cidade TEM — `pet_count` e os campos por espécie, idade, porte e raça contam também os já adotados e os anúncios antigos, então são sempre maiores ou iguais a este."
}
},
"description": "Aggregate counts for ONE city. Deliberately carries no pets and no\nneighbouring cities — the pet search and the city lookup answer those."
},
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentBreedCount": {
"type": "object",
"title": "AgentBreedCount",
"required": [
"name",
"count"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"description": "Nome da raça. Pode ser enviado em `breed` na busca de pets."
},
"count": {
"type": "integer",
"title": "Count",
"description": "Pets dessa raça entre os contados em `pet_count`."
},
"by_species": {
"type": "object",
"title": "By Species",
"description": "Quantos desses são de cada espécie: chaves 'cachorro' e 'gato', e somam `count`. Uma raça pode aparecer nas duas — SRD (sem raça definida) aparece. Se a pessoa perguntou por uma espécie só, leia daqui: `name` e `count` juntam as duas.",
"additionalProperties": {
"type": "integer"
}
}
},
"description": "A breed and how many of the city's pets carry it.\n\nNo `slug`, unlike `AgentBreed`: `search_pets(breed=...)` takes the NAME too\n(Breed values are the accent-stripped pt-BR names, and `parse_breed` aliases\nthe one name this surface invents), so a second identifier would only be\nsomething else to keep in sync."
}
},
"title": "get_city_statsOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentCityStats"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}get_city_stats annotations
{
"title": "Ver números do catálogo na cidade",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}list_breeds — Listar raças com pets
Advertised read-onlyOpen-world
Raças com pets no catálogo hoje, mais comuns primeiro, com o slug aceito no filtro `breed`. Use quando perguntarem quais raças existem ou antes de filtrar por raça. A maioria do catálogo é SRD (sem raça definida).
list_breeds input schema
{
"type": "object",
"title": "list_breedsArguments",
"properties": {
"species": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Species",
"default": null,
"description": "Espécie: 'dog'/'cachorro' ou 'cat'/'gato'."
}
},
"additionalProperties": false
}list_breeds output schema
{
"type": "object",
"$defs": {
"AgentBreed": {
"type": "object",
"title": "AgentBreed",
"required": [
"slug",
"name",
"species",
"count"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"description": "Nome da raça para mostrar à pessoa."
},
"slug": {
"type": "string",
"title": "Slug",
"description": "Envie este valor em `breed` na busca de pets, ex.: 'pastor-alemao'."
},
"count": {
"type": "integer",
"title": "Count",
"description": "Pets dessa raça já anunciados, somando o Brasil inteiro. Inclui os já adotados e anúncios antigos, então pode ser bem maior que o número disponível agora — e não diz se há algum na cidade da pessoa. Não prometa que são recentes."
},
"species": {
"type": "string",
"title": "Species",
"description": "'cachorro' ou 'gato'."
}
}
},
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentBreedsResponse": {
"type": "object",
"title": "AgentBreedsResponse",
"required": [
"breeds"
],
"properties": {
"breeds": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentBreed"
},
"title": "Breeds",
"description": "As raças com pets no catálogo, as mais comuns primeiro. UMA LINHA POR RAÇA E ESPÉCIE: uma raça que existe nas duas aparece duas vezes, com o mesmo `slug` e `species` diferentes — não some as duas. SRD (sem raça definida) lidera: é a maioria do catálogo."
}
}
}
},
"title": "list_breedsOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentBreedsResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}list_breeds annotations
{
"title": "Listar raças com pets",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}search_public_services — Buscar serviços públicos para animais
Advertised read-onlyOpen-world
Serviços públicos para animais numa cidade, conferidos à mão e com data: hospital veterinário público ou de universidade, zoonoses, castração, bem-estar animal da prefeitura e canais de denúncia. Filtra por necessidade. A cobertura é parcial, cidade a cidade, e a resposta pode vir vazia.
search_public_services input schema
{
"type": "object",
"title": "search_public_servicesArguments",
"required": [
"city",
"need"
],
"properties": {
"city": {
"type": "string",
"title": "City",
"description": "Nome do MUNICÍPIO por extenso, ou o slug devolvido pela resolução de cidade. Obrigatório: a resposta é sempre de uma cidade. Se o nome for ambíguo ou ninguém tiver pets ali hoje, o erro diz o que fazer."
},
"need": {
"type": "string",
"title": "Need",
"description": "A necessidade: emergencia, atendimento, castracao, mordida, morcego, zoonose, adocao, denuncia, silvestre, animal_preso ou orientacao (ou o mesmo em inglês)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 3,
"description": "Quantos lugares no máximo, de 1 a 5. Padrão 3."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), se a pessoa informou. Opcional."
}
},
"additionalProperties": false
}search_public_services output schema
{
"type": "object",
"$defs": {
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentPublicPlace": {
"type": "object",
"title": "AgentPublicPlace",
"required": [
"type",
"name",
"kind",
"city",
"uf",
"verified_at"
],
"properties": {
"uf": {
"type": "string",
"title": "Uf"
},
"city": {
"type": "string",
"title": "City"
},
"cost": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cost",
"default": null
},
"kind": {
"type": "string",
"title": "Kind",
"description": "FacilityKind, VetHospitalOperator ou PUBLIC_BODY."
},
"name": {
"type": "string",
"title": "Name"
},
"type": {
"enum": [
"body",
"facility",
"hospital"
],
"type": "string",
"title": "Type",
"description": "body = órgão da prefeitura; facility = unidade física; hospital = hospital veterinário."
},
"email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Email",
"default": null
},
"hours": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
}
]
}
}
},
{
"type": "null"
}
],
"title": "Hours",
"default": null
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Phone",
"default": null,
"description": "Nulo se o contato não foi conferido."
},
"whatsapp": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Whatsapp",
"default": null
},
"hours_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Hours Note",
"default": null
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Url",
"default": null
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description",
"default": null
},
"distance_km": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Distance Km",
"default": null,
"description": "Só em cidade vizinha: distância entre os centros, em km."
},
"eligibility": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Eligibility",
"default": null
},
"verified_at": {
"type": "string",
"title": "Verified At",
"format": "date",
"description": "Quando uma pessoa conferiu este serviço."
},
"website_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Website Url",
"default": null
},
"address_line": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Address Line",
"default": null
},
"neighbourhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Neighbourhood",
"default": null
}
}
},
"AgentPublicChannel": {
"type": "object",
"title": "AgentPublicChannel",
"required": [
"kind",
"scope",
"name",
"verified_at"
],
"properties": {
"kind": {
"type": "string",
"title": "Kind"
},
"name": {
"type": "string",
"title": "Name"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Phone",
"default": null,
"description": "Nulo se o contato não foi conferido."
},
"scope": {
"type": "string",
"title": "Scope"
},
"whatsapp": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Whatsapp",
"default": null
},
"hours_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Hours Note",
"default": null
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description",
"default": null
},
"verified_at": {
"type": "string",
"title": "Verified At",
"format": "date"
},
"website_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Website Url",
"default": null
},
"online_form_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Online Form Url",
"default": null
}
}
},
"AgentPublicServicesResponse": {
"type": "object",
"title": "AgentPublicServicesResponse",
"required": [
"city",
"need",
"searched",
"places",
"channels",
"note"
],
"properties": {
"city": {
"type": "string",
"title": "City",
"description": "Cidade de referência, 'Nome - UF'."
},
"need": {
"type": "string",
"title": "Need"
},
"note": {
"type": "string",
"title": "Note",
"description": "Contexto obrigatório: serviços conferidos à mão, com data. Cite só estes, com a data, e diga que podem ter mudado."
},
"places": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentPublicPlace"
},
"title": "Places"
},
"channels": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentPublicChannel"
},
"title": "Channels"
},
"searched": {
"enum": [
"city",
"neighbors",
"none"
],
"type": "string",
"title": "Searched"
}
}
}
},
"title": "search_public_servicesOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentPublicServicesResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}search_public_services annotations
{
"title": "Buscar serviços públicos para animais",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}search_guides — Consultar guias da Adoteca
Advertised read-onlyOpen-world
Guias da Adoteca sobre adoção, saúde e cuidados especiais (FIV, FeLV, leishmaniose, pet surdo, custos) e ajuda sobre como o site funciona. Use para dúvidas que não são busca de pets. Cada guia traz `summary` e `url`; lista vazia significa que não há guia sobre o tema.
search_guides input schema
{
"type": "object",
"title": "search_guidesArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query",
"description": "A dúvida da pessoa, como ela escreveu, ex.: 'meu gato tem FIV' ou 'quanto custa ter um cachorro'. Acentos e erros de grafia são tolerados."
}
},
"additionalProperties": false
}search_guides output schema
{
"type": "object",
"$defs": {
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentGuideResult": {
"type": "object",
"title": "AgentGuideResult",
"required": [
"title",
"summary",
"url"
],
"properties": {
"url": {
"type": "string",
"title": "Url",
"description": "Link do guia no site. SEMPRE mostre este link na resposta."
},
"title": {
"type": "string",
"title": "Title",
"description": "Título do guia ou da resposta de ajuda."
},
"summary": {
"type": "string",
"title": "Summary",
"description": "Resumo do conteúdo, escrito para ser lido à pessoa. Responda com base nele e não invente detalhes que não estejam aqui."
}
},
"description": "One guide article or site-help answer matched by searchGuides."
},
"AgentGuidesResponse": {
"type": "object",
"title": "AgentGuidesResponse",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/$defs/AgentGuideResult"
},
"title": "Results",
"description": "Guias mais relevantes, os melhores primeiro (no máximo 3). Lista vazia = não temos guia sobre isso; diga que não sabe."
}
}
}
},
"title": "search_guidesOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentGuidesResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}search_guides annotations
{
"title": "Consultar guias da Adoteca",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}get_catalog_link — Montar link do catálogo
Advertised read-onlyOpen-world
Monta o link do catálogo com os filtros pedidos e confirma que existem pets neles. Use quando a pessoa quiser ver a lista no site. Sem pets nesses filtros, `url` vem null e `note` explica.
get_catalog_link input schema
{
"type": "object",
"title": "get_catalog_linkArguments",
"properties": {
"age": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Age",
"default": null,
"description": "Faixa etária, uma só: 'filhote', 'adulto' ou 'idoso'. São as três faixas que o catálogo distingue; os cortes mudam com espécie e porte (idoso a partir de 8 anos no cão grande, 9 no médio, 10 no pequeno e no gato)."
},
"sex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sex",
"default": null,
"description": "Sexo: 'male'/'macho' ou 'female'/'femea'."
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null,
"description": "Nome do MUNICÍPIO por extenso, não do bairro nem abreviado: 'Belo Horizonte', não 'BH'. Acento é opcional. Se o nome for ambíguo, ou se nenhuma ONG tiver pets ali hoje, o erro explica o que corrigir; isso não significa que a cidade não exista."
},
"size": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Size",
"default": null,
"description": "Portes, um ou mais: 'small'/'pequeno', 'medium'/'medio', 'large'/'grande'. Envie os dois quando a pessoa aceitar os dois."
},
"sort": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sort",
"default": null,
"description": "Ordem da página: 'recentes' (padrão, os anúncios mais novos primeiro) ou 'disponiveis' (os que ainda estão para adoção primeiro, empurrando os já adotados para o fim)."
},
"breed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Breed",
"default": null,
"description": "Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida)."
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null,
"description": "Sigla de duas letras da UF (SP, MG), apenas para desambiguar `city`. Busca só por estado NÃO é suportada: sempre envie `city` junto."
},
"species": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Species",
"default": null,
"description": "Espécie: 'dog'/'cachorro' ou 'cat'/'gato'."
},
"neutered": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Neutered",
"default": null,
"description": "true devolve somente pets castrados. `false` é IGNORADO pelo mesmo motivo de `vaccinated`; o valor de cada pet está em `neutered`."
},
"vaccinated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Vaccinated",
"default": null,
"description": "true devolve somente pets vacinados. `false` é IGNORADO: a maioria dos anúncios não informa vacinação, então filtrar por 'não vacinado' esconderia quase todo o catálogo. O valor de cada pet está em `vaccinated` (null = a ONG não informou)."
},
"special_needs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Special Needs",
"default": null,
"description": "true monta o link só com pets com cuidados especiais. `false` é IGNORADO: o catálogo não tem o filtro inverso."
},
"good_with_cats": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Cats",
"default": null,
"description": "Somente pets que convivem bem com gatos."
},
"good_with_dogs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Dogs",
"default": null,
"description": "Somente pets que convivem bem com cães."
},
"good_with_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Good With Kids",
"default": null,
"description": "Somente pets que convivem bem com crianças."
}
},
"additionalProperties": false
}get_catalog_link output schema
{
"type": "object",
"$defs": {
"AgentToolError": {
"type": "object",
"title": "AgentToolError",
"required": [
"error"
],
"properties": {
"error": {
"type": "string",
"title": "Error",
"description": "O que impediu a consulta e o que enviar na próxima chamada. Leia e corrija a chamada; NUNCA responda que não existem pets por causa disto."
}
},
"description": "The error branch of every tool's return type.\n\nErrors are DATA, never a raised exception: a raised one aborts the calling\nmodel's tool loop, while this arrives as a normal result the model can read\nand act on. It is part of the declared output schema so a client sees the\nbranch exists before it ever hits one."
},
"AgentLinkResponse": {
"type": "object",
"title": "AgentLinkResponse",
"required": [
"url",
"total"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"description": "Link do catálogo com esses filtros. null = nenhum pet corresponde hoje; nesse caso leia `note` e NUNCA escreva um link à mão."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null,
"description": "Quando presente, explica por que não há link. Leia e siga."
},
"total": {
"type": "integer",
"title": "Total",
"description": "Quantos pets essa página do catálogo mostra hoje."
}
},
"description": "A catalog link that was CONFIRMED to have pets, or no link at all."
}
},
"title": "get_catalog_linkOutput",
"required": [
"result"
],
"properties": {
"result": {
"anyOf": [
{
"$ref": "#/$defs/AgentLinkResponse"
},
{
"$ref": "#/$defs/AgentToolError"
}
],
"title": "Result"
}
}
}get_catalog_link annotations
{
"title": "Montar link do catálogo",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}Prompts
0 advertised
Resources
2 advertised
ui://adoteca/pets.html — Pets da Adoteca
Galeria de cães e gatos disponíveis para adoção.
ui://adoteca/pets.html URI
ui://adoteca/pets.htmlui://adoteca/rescuers.html — ONGs da Adoteca
ONGs e protetores com pets para adoção.
ui://adoteca/rescuers.html URI
ui://adoteca/rescuers.html90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 2 of 2 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1218 ms
- 95th percentile latency
- 1218 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1218 ms · metadata changed · 11 tool(s), 2 resource(s), 0 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http adoteca-mcp https://api.adoteca.com.br/mcpCodex
Codex configuration
codex mcp add adoteca-mcp --url https://api.adoteca.com.br/mcpCursor
Cursor configuration
{
"mcpServers": {
"adoteca-mcp": {
"url": "https://api.adoteca.com.br/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"adoteca-mcp": {
"type": "streamableHttp",
"url": "https://api.adoteca.com.br/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"adoteca-mcp": {
"type": "http",
"url": "https://api.adoteca.com.br/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http adoteca-mcp https://api.adoteca.com.br/mcpClaude Desktop
Claude Desktop configuration
https://api.adoteca.com.br/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"adoteca-mcp": {
"serverUrl": "https://api.adoteca.com.br/mcp"
}
}
}Let your agent find its tools
Find servers like Adoteca MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other productivity and knowledge servers
Do you run Adoteca MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.