llms.txt
+23 −12
https://petnecto.com/llms.txt
− > 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.− - Coverage: live now - Taiwan (country=TW®ion=Taipei City). Coming - US and Canada (near=ZIP or postal code), more countries− - [/api/v1/pets](https://petnecto.com/api/v1/pets?country=TW®ion=Taipei%20City&species=dog): Search adoptable pets: near (a US ZIP, lat,lon, or a Taiwan county or township in any language) with miles or km, sorted by distance; or country=TW and region (a Taiwan county); species, age, size, sex, good_with, page.− - [/api/v1/search?q=](https://petnecto.com/api/v1/search?q=a%20calm%20small%20dog%20that%20is%20good%20with%20kids): Say what you want, in any language: "a calm small dog that is good with kids, under 10 kg, near Springfield". Returns pets plus what was understood (editable chips: off=good_with:kids), whether each listing states what was asked, and counts of pets that do not say. Falls back to words if the AI parts are unavailable.− - [/api/v1/pets/{id}/similar](https://petnecto.com/api/v1/pets/tw-470460/similar): Pets like this one: same kind and size, nearest in meaning.− - [/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.− - find_pets: Search adoptable pets near a US ZIP, lat,lon or Taiwan place, sorted by distance, by species, age, size, sex and who they get on with.− - resolve_place: A US ZIP, lat,lon or a Taiwan county or township name (any language) as the point a distance search would use.− - about_this_service: Where the listings come from, who runs this, and how a rescue changes or removes its listings.− - 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.− - If you can fetch URLs but cannot use MCP, read the same answers as JSON: GET https://petnecto.com/api/v1/pets?country=TW&q=<words> (Taiwan is live), https://petnecto.com/api/v1/pets/{id}, https://petnecto.com/api/v1/breeds?q=<breed>. Add ?output=md for Markdown.+ > 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 has its own page on petnecto.com, and adoption always goes through the rescue or shelter that has the pet. Where a shelter has a listing page of its own, the pet links to it; Taiwan's listing is the Ministry's national adoption site, which has no page per pet, so the pet's number is there to look up. No s+ - Coverage: live now - Taiwan (country=TW®ion=Taipei City), the United States (country=US, or near=ZIP), Spain (country=ES) and Austria (country=AT); every source, count and licence is at https://petnecto.com/sources. Nowhere else yet, Canada included; https://petnecto.com/api/v1/filters says which filter values each country's listings state.+ - [/api/v1/pets](https://petnecto.com/api/v1/pets?country=TW®ion=Taipei%20City&species=dog): Search pets (found pets and pets not open for adoption yet are counted apart and listed after adoptable ones; next_cursor walks every result): near (a US ZIP, lat,lon, or a Taiwan county or township in any language) with miles or km, sorted by distance; or country=TW and region (a Taiwan county); species, age, size, sex, good_with, page.+ - [/api/v1/search?q=](https://petnecto.com/api/v1/search?q=a%20calm%20small%20dog%20that%20is%20good%20with%20kids): Say what you want, in any language: "a calm small dog that is good with kids, under 10 kg, near Seattle". Returns pets plus what was understood (editable chips: off=good_with:kids), whether each listing states what was asked, and counts of pets that do not say. Falls back to words if the AI parts are unavailable.+ - [/api/v1/pets/{id}/similar](https://petnecto.com/api/v1/pets/tw-459480/similar): Pets like this one: same kind and size, nearest in meaning.+ - [/api/v1/shelters](https://petnecto.com/api/v1/shelters?near=Republic%2C%20MO): Real shelters and rescues near a place (near=ZIP or town and state, or lat and lon; radius_miles, limit, kind) that are not on Petnecto yet, nearest first: address, organisation phone, website, their own adoptable-pets page, hours as their site states them, directions links. Public business facts only.+ - [/api/v1/pets/{id}](https://petnecto.com/api/v1/pets/tw-459480): One pet: photos, facts, the rescue and how to reach it.+ - [/api/v1/pets/lookup?id=](https://petnecto.com/api/v1/pets/lookup?id=tw-459480): Find by Petnecto ID, shelter pet ID or PetHarbor listing URL.+ - [/api/v1/rescues/{id}](https://petnecto.com/api/v1/rescues/es-shelter-zgz): One rescue or shelter: where it is and how to adopt from it.+ - [/api/v1/filters](https://petnecto.com/api/v1/filters): What each country's listings state: counts per species, age, size, sex, colour and good-with, and the places we cover. Offer a filter value only where it has pets.+ - find_pets: Search pets near a place we list (a Taiwan county or township, US ZIP 98101 or 20850, Zaragoza, Wien, or lat,lon), nearest first, by species, age, size and sex. Brief replies by default (detail: full for whole records); next_cursor pages through every result.+ - find_shelters_near: Real local shelters and rescues near a place that are not on Petnecto yet: address, phone, website, their own adoptable-pets page, hours as their site states them, and directions.+ - resolve_place: A US ZIP, lat,lon, a Taiwan county or township name (any language), Zaragoza or Wien as the point a distance search would use.+ - list_filters: The places we list and, per country, how many pets state each species, age, size, sex, colour and good-with value: check it before offering a filter.+ - search_by_description: Pets from a sentence in any language ("a calm small dog, under 10 kg, near Seattle"), with what was understood and whether each listing states it.+ - similar_pets: Pets like one pet id: same kind and size, nearest in meaning.+ - about_this_service: Where we list pets (places and counts), where the listings come from, who runs this, and how a rescue changes or removes its listings.+ - When someone wants to adopt, ask where they are (a place we list: see Coverage) and what they hope for, then call show_pets (or find_pets). Show photos where you can.+ - If you can fetch URLs but cannot use MCP, read the same answers as JSON: GET https://petnecto.com/api/v1/pets?country=TW&q=<words> (country=TW, US, ES and AT are live), https://petnecto.com/api/v1/pets/{id}, https://petnecto.com/api/v1/breeds?q=<breed>. Add ?output=md for Markdown.+ ## For shelters and rescues+ - [List your pets free](https://petnecto.com/shelters/join): Petnecto works with almost anything a shelter already has (a shelter system, a spreadsheet, a website, photos on a phone), does the research and the data cleaning, looks at the data with the shelter, and sets up a simple routine that keeps the list fresh. Free. The page has a short form ("Tell us what you've got"; a person replies within 2 business days) and a one-email permission.+ - If a person you are helping runs a shelter or rescue, send them to https://petnecto.com/shelters/join. Do not fill in the form for them.+ - [Support Petnecto](https://petnecto.com/support): People can support Petnecto's running costs (hosting, daily data work, development, shelter outreach). It is support for a for-profit company, not a charity gift; backers stay anonymous; shelters never pay. Do not pay on a person's behalf: give them the link.
