Adoteca — Adoção de Pets no Brasil

Ver números do catálogo na cidade

get_city_stats

Read-only

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`city`	Yes	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`	No	Sigla de duas letras da UF (SP, MG), se a pessoa informou. Opcional.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedSep 4, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

addedOutput schema / $defs / AgentBreedCount / properties / by_species

Added value: +{
+  "additionalProperties": {
+    "type": "integer"
+  },
+  "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.",
+  "title": "By Species",
+  "type": "object"
+}

addedOutput schema / $defs / AgentCityStats / properties / available_count

Added value: +{
+  "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.",
+  "title": "Available Count",
+  "type": "integer"
+}

changedOutput schema / $defs / AgentCityStats / required

Previous value: -[
-  "city",
-  "pet_count",
-  "total_ever",
-  "by_species",
-  "by_age",
-  "by_size",
-  "new_last_24h",
-  "adopted_total",
-  "rescuer_count",
-  "rank",
-  "national_pct",
-  "top_breeds"
-]New value: +[
+  "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"
+]

Changed3 schema fields changedAug 30, 2026

changedOutput schema / $defs / AgentCityStats / properties / national_pct / description

Previous value: -"Percentual de todo o catálogo histórico que está nessa cidade, ex.: 2.4. Calculado sobre `total_ever`, não sobre o que está anunciado agora."New value: +"Percentual de todo o catálogo histórico que está nessa cidade, ex.: 2.4. Calculado sobre `total_ever`."

changedOutput schema / $defs / AgentCityStats / properties / pet_count / description

Previous value: -"Pets anunciados nessa cidade nos últimos 90 dias. Inclui os já adotados, então pode ser maior que o número disponível agora."New value: +"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."

changedOutput schema / $defs / AgentCityStats / properties / total_ever / description

Previous value: -"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. Para saber o que está anunciado agora, use `pet_count`."New value: +"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'."

Changed8 schema fields changedAug 17, 2026

changedOutput schema / $defs / AgentCityStats / properties / by_age / description

Previous value: -"Quantos por faixa etária: 'filhote', 'adulto', 'idoso'. Pets sem idade informada ficam de fora, então pode somar menos que `pet_count`."New value: +"Quantos por faixa etária: 'filhote', 'adulto', 'idoso'. Pets sem idade informada ficam de fora, então pode somar menos que `total_ever`."

changedOutput schema / $defs / AgentCityStats / properties / by_size / description

Previous value: -"Quantos por porte: 'pequeno', 'médio', 'grande'. Pets sem porte informado ficam de fora, então pode somar menos que `pet_count`."New value: +"Quantos por porte: 'pequeno', 'médio', 'grande'. Pets sem porte informado ficam de fora, então pode somar menos que `total_ever`."

changedOutput schema / $defs / AgentCityStats / properties / by_species / description

Previous value: -"Quantos por espécie: chaves 'cachorro' e 'gato'. Somam `pet_count`."New value: +"Quantos por espécie: chaves 'cachorro' e 'gato'. Somam `total_ever`."

changedOutput schema / $defs / AgentCityStats / properties / national_pct / description

Previous value: -"Percentual do catálogo nacional que está nessa cidade, ex.: 2.4."New value: +"Percentual de todo o catálogo histórico que está nessa cidade, ex.: 2.4. Calculado sobre `total_ever`, não sobre o que está anunciado agora."

changedOutput schema / $defs / AgentCityStats / properties / rank / description

Previous value: -"Posição da cidade no ranking nacional por `pet_count` (1 = 1º)."New value: +"Posição da cidade no ranking nacional por `total_ever` (1 = 1º)."

changedOutput schema / $defs / AgentCityStats / properties / top_breeds / description

Previous value: -"As raças mais comuns na cidade, as mais numerosas primeiro."New value: +"As raças mais comuns na cidade em todo o histórico, as mais numerosas primeiro."

addedOutput schema / $defs / AgentCityStats / properties / total_ever

Added value: +{
+  "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. Para saber o que está anunciado agora, use `pet_count`.",
+  "title": "Total Ever",
+  "type": "integer"
+}

changedOutput schema / $defs / AgentCityStats / required

Previous value: -[
-  "city",
-  "pet_count",
-  "by_species",
-  "by_age",
-  "by_size",
-  "new_last_24h",
-  "adopted_total",
-  "rescuer_count",
-  "rank",
-  "national_pct",
-  "top_breeds"
-]New value: +[
+  "city",
+  "pet_count",
+  "total_ever",
+  "by_species",
+  "by_age",
+  "by_size",
+  "new_last_24h",
+  "adopted_total",
+  "rescuer_count",
+  "rank",
+  "national_pct",
+  "top_breeds"
+]

Changed3 schema fields changedAug 14, 2026

removedOutput schema / $defs / AgentCityStats / properties / ngo_count

Removed value: -{
-  "description": "ONGs e protetores com pets anunciados nessa cidade.",
-  "title": "Ngo Count",
-  "type": "integer"
-}

addedOutput schema / $defs / AgentCityStats / properties / rescuer_count

Added value: +{
+  "description": "ONGs e protetores com pets anunciados nessa cidade.",
+  "title": "Rescuer Count",
+  "type": "integer"
+}

changedOutput schema / $defs / AgentCityStats / required

Previous value: -[
-  "city",
-  "pet_count",
-  "by_species",
-  "by_age",
-  "by_size",
-  "new_last_24h",
-  "adopted_total",
-  "ngo_count",
-  "rank",
-  "national_pct",
-  "top_breeds"
-]New value: +[
+  "city",
+  "pet_count",
+  "by_species",
+  "by_age",
+  "by_size",
+  "new_last_24h",
+  "adopted_total",
+  "rescuer_count",
+  "rank",
+  "national_pct",
+  "top_breeds"
+]

Changed1 schema field changedAug 12, 2026

changedOutput schema / $defs / AgentCityStats / description

Previous value: -"Aggregate counts for ONE city. Deliberately carries no pets and no\nneighbouring cities — searchPets and findCity answer those."New value: +"Aggregate counts for ONE city. Deliberately carries no pets and no\nneighbouring cities — the pet search and the city lookup answer those."

AddedAug 12, 2026

TDQS

Score is being calculated.

All Adoteca — Adoção de Pets no Brasil tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?