About Adoteca — Adoção de Pets no Brasil
Dogs and cats available for adoption in Brazil, from NGOs and independent caregivers. Search by city, size, age and health
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
Endpoint
https://api.adoteca.com.br/mcpCopy install command
Claude CodeTerminal
claude mcp add --transport http br-com-adoteca-adoteca https://api.adoteca.com.br/mcpCursor.cursor/mcp.json
{"mcpServers":{"br-com-adoteca-adoteca":{"type":"http","url":"https://api.adoteca.com.br/mcp"}}}Open in CursorVS Code.vscode/mcp.json
{"servers":{"br-com-adoteca-adoteca":{"type":"http","url":"https://api.adoteca.com.br/mcp"}}}Open in VS CodeClaude Desktopclaude_desktop_config.json
{"mcpServers":{"br-com-adoteca-adoteca":{"type":"http","url":"https://api.adoteca.com.br/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"br-com-adoteca-adoteca":{"serverUrl":"https://api.adoteca.com.br/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
11| Parameter | Type | Required | Description |
|---|---|---|---|
| sex | any | No | Sexo: 'male'/'macho' ou 'female'/'femea'. |
| area | any | No | 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 | any | No | 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 | any | No | 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 | integer | No | Página, começando em 1. |
| size | any | No | Porte: 'small'/'pequeno', 'medium'/'medio', 'large'/'grande'. |
| breed | any | No | Raça: slug ('golden-retriever') ou nome em português ('pastor alemão'). A maioria do catálogo é SRD (sem raça definida). |
| limit | integer | No | Number of results to return per page. Values above 24 are reduced to 24. Searching by `name` returns at most 5: this is a list for confirmation, not for browsing. |
| state | any | No | Two-letter abbreviation for the state (SP, MG), only to disambiguate `city`. Searching by state alone is NOT supported: always send `city` as well. |
| rescuer | any | No | Restricts the search to ONE NGO or rescuer: the short code from the link or the NGO's Instagram @ handle. Combines with other filters ('kittens from this NGO'). Without it, the search covers the entire catalog. |
| species | any | No | Species: 'dog'/'cachorro' or 'cat'/'gato'. |
| neutered | any | No | true returns only neutered pets. `false` is IGNORED for the same reason as `vaccinated`; each pet's value is in `neutered`. |
| radius_km | any | No | Radius in km (1 to 100) for `area=radius`. Sending only `radius_km` already means radius. |
| vaccinated | any | No | true returns only vaccinated pets. `false` is IGNORED: most listings do not specify vaccination, so filtering for 'not vaccinated' would hide almost the entire catalog. Each pet's value is in `vaccinated` (null = the NGO did not provide the information). |
| include_older | boolean | No | No effect at the moment: the catalog returns pets listed on any date, regardless of this parameter. Kept for compatibility. A result may be old: when present, `days_without_update` says how long ago it was updated. |
| special_needs | any | No | true returns only pets with special care needs; false returns only those with none recorded. |
| age_max_months | any | No | Maximum age in months. The catalog distinguishes only three age groups—puppy/kitten, adult, and senior—so without size, 6 and 12 select the same pets. The cutoffs vary by species and size: senior starts at 8 years for large dogs, 9 for medium dogs, and 10 for small dogs and cats. |
| good_with_cats | any | No | Only pets that get along well with cats. |
| good_with_dogs | any | No | Only pets that get along well with dogs. |
| good_with_kids | any | No | Only pets that get along well with children. |
| widen_if_empty | boolean | No | If the requested area has no available pets matching the filters, expands outward from it: nearby cities, then a 50 km radius, then 100 km, stopping at the first step with pets. `searched_area` indicates what was used. |
Details
The maintainer has not added details yet. Check the README in the repository.
Comments
Markdown supported
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.