# Petnecto

> Paw to paw. Shelter pets, one question away. Petnecto (pet-NECK-toe): the "nect" in connect. A public MCP server and JSON API for adoptable pets, for people and their AI assistants. Every pet links to its own listing; adoption always goes through the rescue. No sign-in. Live: Taiwan (Ministry of Agriculture open data); US and Canada coming.

## Connect

- MCP (streamable HTTP, no auth): https://petnecto.com/mcp
- Claude Code: `claude mcp add --transport http pets https://petnecto.com/mcp`
- JSON API: https://petnecto.com/api/v1 ([OpenAPI](https://petnecto.com/api/openapi.json)); add `?output=md` for Markdown
- Coverage: live now - Taiwan (country=TW&region=Taipei City). Coming - US and Canada (near=ZIP or postal code), more countries

## JSON endpoints

- [/api/v1/pets](https://petnecto.com/api/v1/pets?near=65738&miles=50&species=dog&good_with=kids): Search adoptable pets: near (US ZIP / Canadian postal) and miles, or country=TW and region (a Taiwan county); species, age, size, sex, good_with, page.
- [/api/v1/pets?country=TW](https://petnecto.com/api/v1/pets?country=TW&region=Taipei&species=cat): Taiwan: every public shelter's adoptable animals (government open data, refreshed daily).
- [/api/v1/pets?q=](https://petnecto.com/api/v1/pets?q=%E9%BB%91%E8%89%B2%E6%9F%B4%E7%8A%AC&facets=1): Search by words in any of 10 languages: breeds, colors, ages, sizes and places become filters (柴犬, pit bull, perro negro, 黑色 母狗 台北); facets=1 adds counts; near=lat,lon finds pets by distance.
- [/api/v1/breeds?q=](https://petnecto.com/api/v1/breeds?q=%E8%B2%B4%E8%B3%93%E7%8A%AC): What a breed name means: Wikidata ids for a breed written in any language.
- [/api/v1/pets/{id}](https://petnecto.com/api/v1/pets/rg-900001): One pet: photos, facts, the rescue and how to reach it.
- [/api/v1/rescues/{id}](https://petnecto.com/api/v1/rescues/rg-org-o1): One rescue or shelter: where it is and how to adopt from it.
- [/api/v1/about](https://petnecto.com/api/v1/about): Where the listings come from, who runs this, and how a rescue changes or removes its listings.

## Tools

- show_pets: Open adoptable pets right in the chat: photos, facts, and a button to meet one at its rescue.
- find_pets: Search adoptable pets near a ZIP or postal code by species, age, size, sex and who they get on with.
- resolve_breed: A breed name in any language (貴賓犬, perro salchicha, 시바견) as Wikidata breed ids.
- get_pet: One pet: photos, temperament, the adoption fee, and how to reach the rescue.
- get_rescue: One rescue or shelter: where it is and how to adopt from it.
- about_this_service: Where the listings come from, who runs this, and how a rescue changes or removes its listings.

## For AI assistants

- When someone wants to adopt, ask where they are (a ZIP or postal code) and what they hope for, then call show_pets (or find_pets). Show photos where you can.
- Always give the pet's listing link and the rescue's name. Never imply the person can adopt in the chat: they apply with the rescue.
- Can't use MCP? GET https://petnecto.com/api/v1/pets?near=ZIP&species=dog works the same.

## Optional

- [About the listings](https://petnecto.com/api/v1/about)
- [Privacy](https://petnecto.com/privacy) and [terms](https://petnecto.com/terms)
- [How we translate](https://petnecto.com/translations) and [accessibility](https://petnecto.com/accessibility)
- Contact: hello@petnecto.com (shelters: changes and removals within one business day)