Skip to main content
Glama

Adoteca — Adoção de Pets no Brasil

Ver ficha completa do pet

get_pet_details
Read-only

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.

Input Schema

NameRequiredDescriptionDefault
pet_refYesCódigo curto do pet (ex.: 'ab12cd') ou o identificador da ficha.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / $defs / AgentPetDetail / properties / distance_km
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "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`.",
      +  "title": "Distance Km"
      +}
  2. Changed1 schema field changed
    • addedOutput schema / $defs / AgentPetDetail / properties / adoption_evidence
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "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.",
      +  "title": "Adoption Evidence"
      +}
  3. Changed2 schema fields changed
    • addedOutput schema / $defs / AgentPetDetail / properties / contact_url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "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.",
      +  "title": "Contact Url"
      +}
    • changedOutput schema / $defs / AgentRescuer / properties / instagram_url / description
      Previous value: -"Perfil oficial da ONG no Instagram."New value: +"Perfil oficial da ONG no Instagram. Para indicar contato, mostre contact_url."
  4. Changed1 schema field changed
    • changedOutput schema / $defs / AgentPetDetail / properties / status / description
      Previous value: -"'available', 'adopted', 'deceased' ou 'source_gone' (posts apagados, desfecho incerto). Nunca ofereça um pet que não esteja 'available'. E 'available' não confirma que o pet continua esperando: diz só que ninguém sinalizou mudança. Leia `days_without_update` antes de afirmar que está disponível."New value: +"'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."
  5. Changed1 schema field changed
    • changedOutput schema / $defs / AgentPetDetail / properties / status / description
      Previous value: -"'available', 'adopted' ou 'deceased'. Nunca ofereça um pet que não esteja 'available'. E 'available' não confirma que o pet continua esperando: diz só que ninguém sinalizou mudança. Leia `days_without_update` antes de afirmar que está disponível."New value: +"'available', 'adopted', 'deceased' ou 'source_gone' (posts apagados, desfecho incerto). Nunca ofereça um pet que não esteja 'available'. E 'available' não confirma que o pet continua esperando: diz só que ninguém sinalizou mudança. Leia `days_without_update` antes de afirmar que está disponível."
  6. Changed1 schema field changed
    • changedOutput schema / $defs / AgentPetDetail / properties / short_code / description
      Previous value: -"Código curto do pet (o mesmo de www.adoteca.com.br/p/{code})."New value: +"Código curto do pet (o mesmo de adoteca.com.br/p/{code})."
  7. Changed1 schema field changed
    • changedOutput schema / $defs / AgentPetDetail / properties / short_code / description
      Previous value: -"Código curto do pet (o mesmo de adoteca.com.br/p/{code})."New value: +"Código curto do pet (o mesmo de www.adoteca.com.br/p/{code})."
  8. Changed1 schema field changed
    • addedInput schema / additionalProperties
      Added value: +false
  9. Changed2 schema fields changed
    • addedOutput schema / $defs / AgentPetDetail / properties / days_without_update
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "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.",
      +  "title": "Days Without Update"
      +}
    • changedOutput schema / $defs / AgentPetDetail / properties / status / description
      Previous value: -"'available', 'adopted' ou 'deceased'. Nunca ofereça um pet que não esteja 'available'."New value: +"'available', 'adopted' ou 'deceased'. Nunca ofereça um pet que não esteja 'available'. E 'available' não confirma que o pet continua esperando: diz só que ninguém sinalizou mudança. Leia `days_without_update` antes de afirmar que está disponível."
  10. Changed2 schema fields changed
    • changedOutput schema / $defs / AgentPetDetail / properties / foster_status / description
      Previous value: -"null = a ONG não informou ou não classificou."New value: +"'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."
    • changedOutput schema / $defs / AgentPetDetail / properties / neutered / description
      Previous value: -"null = a ONG não informou."New value: +"null = a ONG não informou. Nunca afirme 'não castrado' quando for null."
  11. Changed1 schema field changed
    • addedOutput schema / $defs / AgentPetDetail / properties / foster_status
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "null = a ONG não informou ou não classificou.",
      +  "title": "Foster Status"
      +}
  12. Changed7 schema fields changed
    • removedOutput schema / $defs / AgentNgo
      Removed value: -{
      -  "properties": {
      -    "instagram_url": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Perfil oficial da ONG no Instagram.",
      -      "title": "Instagram Url"
      -    },
      -    "name": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "description": "Nome da ONG ou protetor responsável pelo pet.",
      -      "title": "Name"
      -    }
      -  },
      -  "required": [
      -    "name",
      -    "instagram_url"
      -  ],
      -  "title": "AgentNgo",
      -  "type": "object"
      -}
    • removedOutput schema / $defs / AgentPetDetail / properties / ngo
      Removed value: -{
      -  "$ref": "#/$defs/AgentNgo",
      -  "description": "Quem cuida do pet."
      -}
    • removedOutput schema / $defs / AgentPetDetail / properties / ngo_contacts
      Removed value: -{
      -  "description": "Contatos gerais da ONG — use quando 'contacts' estiver vazio.",
      -  "items": {
      -    "$ref": "#/$defs/AgentContact"
      -  },
      -  "title": "Ngo Contacts",
      -  "type": "array"
      -}
    • addedOutput schema / $defs / AgentPetDetail / properties / rescuer
      Added value: +{
      +  "$ref": "#/$defs/AgentRescuer",
      +  "description": "Quem cuida do pet."
      +}
    • addedOutput schema / $defs / AgentPetDetail / properties / rescuer_contacts
      Added value: +{
      +  "description": "Contatos gerais da ONG — use quando 'contacts' estiver vazio.",
      +  "items": {
      +    "$ref": "#/$defs/AgentContact"
      +  },
      +  "title": "Rescuer Contacts",
      +  "type": "array"
      +}
    • changedOutput schema / $defs / AgentPetDetail / required
      Previous value: -[
      -  "short_code",
      -  "name",
      -  "species",
      -  "sex",
      -  "size",
      -  "breed",
      -  "age",
      -  "age_category",
      -  "city",
      -  "status",
      -  "photo_url",
      -  "adoption_url",
      -  "ngo"
      -]New value: +[
      +  "short_code",
      +  "name",
      +  "species",
      +  "sex",
      +  "size",
      +  "breed",
      +  "age",
      +  "age_category",
      +  "city",
      +  "status",
      +  "photo_url",
      +  "adoption_url",
      +  "rescuer"
      +]
    • addedOutput schema / $defs / AgentRescuer
      Added value: +{
      +  "properties": {
      +    "instagram_url": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Perfil oficial da ONG no Instagram.",
      +      "title": "Instagram Url"
      +    },
      +    "name": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Nome da ONG ou protetor responsável pelo pet.",
      +      "title": "Name"
      +    }
      +  },
      +  "required": [
      +    "name",
      +    "instagram_url"
      +  ],
      +  "title": "AgentRescuer",
      +  "type": "object"
      +}
  13. Changed2 schema fields changed
    • addedOutput schema / $defs / AgentPetDetail / properties / published_recently
      Added value: +{
      +  "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."
      +}
    • addedOutput schema / $defs / AgentPublishedRecently
      Added value: +{
      +  "properties": {
      +    "platform": {
      +      "description": "Rede onde a Adoteca postou este pet, ex.: 'Instagram'.",
      +      "title": "Platform",
      +      "type": "string"
      +    },
      +    "published_at": {
      +      "description": "Quando a Adoteca postou.",
      +      "format": "date-time",
      +      "title": "Published At",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "platform",
      +    "published_at"
      +  ],
      +  "title": "AgentPublishedRecently",
      +  "type": "object"
      +}
  14. Changed1 schema field changed
    • changedOutput schema / $defs / AgentContact / properties / kind / description
      Previous value: -"Tipo do canal: WHATSAPP, PHONE, EMAIL ou WEBSITE."New value: +"Tipo do canal, já em português: 'WhatsApp', 'Telefone', 'E-mail' ou 'Site'."
  15. Changed4 schema fields changed
    • changedOutput schema / $defs / AgentPetDetail / properties / colors / description
      Previous value: -"Cores da pelagem, em códigos (ex.: 'BLACK', 'WHITE'). Traduza para o usuário."New value: +"Cores e padrões da pelagem, já em português (ex.: 'preto', 'rajada')."
    • changedOutput schema / $defs / AgentPetDetail / properties / disabilities / description
      Previous value: -"Deficiências informadas, em códigos. Traduza para o usuário."New value: +"Deficiências informadas, já em português (ex.: 'cega', 'baixa visão')."
    • changedOutput schema / $defs / AgentPetDetail / properties / special_needs / description
      Previous value: -"Cuidados especiais, em códigos. Traduza para o usuário."New value: +"Cuidados e requisitos de adoção, já em português (ex.: 'lar com telas')."
    • changedOutput schema / $defs / AgentPetDetail / properties / vaccines / description
      Previous value: -"Vacinas já aplicadas, em códigos (ex.: 'ANTIRRABICA'). Traduza para o usuário."New value: +"Vacinas já aplicadas, já em português (ex.: 'antirrábica', 'V10')."
  16. First observed

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=true, so the safety profile is covered. The description adds that the response carries the pet's `status` and per-item `health_conditions` results, but since an output schema exists that content is partially redundant, and nothing is said about external lookups despite openWorldHint.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences with the resource and contents front-loaded, then input forms, then key return fields. No filler; slight redundancy between the first and third sentence about what the ficha contains.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a full output schema, complete parameter coverage and annotations, the description only needs to state purpose, accepted inputs and highlights. It does all three; the only gap is not clarifying relationship to sibling tools like search_similar_pets or get_rescuer_details.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the single parameter already documents both accepted forms (short code or ficha identifier). The description restates this with the added nuance that the id comes from an already-listed pet, but adds no format or validation detail beyond the schema, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb+resource ("Ficha completa de um pet") and enumerates what the record covers: saúde, cuidados, convivência and how to contact the ONG. This makes it distinguishable from listing tools like search_pets, even though no sibling is named explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Aceita o código curto do link ou o id de um pet já listado" implies the tool is used on a pet that was previously found via a listing or link, which is useful implied guidance. However, no explicit when-to-use/when-not or alternative tool (search_similar_pets, get_rescuer_details) is mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources