chercher_adoptions

Search cats and dogs for adoption in France, at Mission Museaux and other shelters, near a town, in a department or region, or nationwide, by breed, sex, age and gets-on-with. Returns up to 25 animals with shelter, fee, photo, dates and link; else the closest within 300 km. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
race	string	Breed in French or English (string, 2 to 60 characters), e.g. "labrador", "Maine coon" or "berger australien". A partial name such as "lévrier" covers every breed containing it.
sexe	string	Sex: male or femelle (female). Animals of unstated sex are kept and flagged as not stated.
espece	string	Species: chat (cat) or chien (dog); adoptions only cover cats and dogs. cat, kitten, dog or puppy are accepted. Omit for both.
langue	string	Response language: "fr" (French, default) or "en" (English). A request written in English is answered in English even without it.
limite	integer	Number of animals to return (whole number, 1 to 25, default 10); a larger value is lowered to 25. Use decalage for the next page.
commune	string	French town name or 5-digit postcode (string, 2 to 80 characters), e.g. "Nemours", "77140" or "Chaumont 52" (department number to tell namesakes apart). France only; a place abroad returns no result.
decalage	integer	Number of animals to skip, for paging (whole number, 0 to 500, default 0), e.g. 10 for the second page of 10.
ententes	array	Gets on with (list of 1 to 4 values): chats (cats), chiens (dogs), enfants (children), premier_animal (suits a first-time owner), e.g. ["chats", "enfants"]. Only animals whose profile says so are kept.
latitude	number	Latitude of the search centre in decimal degrees (number, -90 to 90), e.g. 48.267. Give it with longitude, instead of commune.
rayon_km	number	Search radius in km around commune or the coordinates (number, 1 to 300, default 60). Without a centre or departement, all of France.
longitude	number	Longitude of the search centre in decimal degrees (number, -180 to 180), e.g. 2.693. Give it with latitude, instead of commune.
departement	string	Department or region instead of a radius (string): code or name, several separated by commas, e.g. "77", "2A", "Bretagne" or "75, 92, 93". A commune given with it only sorts by distance.
age_max_mois	integer	Maximum age in months, inclusive (whole number, 0 to 300), e.g. 11 for under one year or 23 for under two. Animals of unstated age are left out.
age_min_mois	integer	Minimum age in months, inclusive (whole number, 0 to 300), e.g. 96 for 8 years or older. Read from the age the shelter wrote; animals of unstated age are left out.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "race": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "Breed in French or English (string, 2 to 60 characters), e.g. \"labrador\", \"Maine coon\" or \"berger australien\". A partial name such as \"lévrier\" covers every breed containing it."
    },
    "sexe": {
      "enum": [
        "male",
        "femelle"
      ],
      "type": "string",
      "description": "Sex: male or femelle (female). Animals of unstated sex are kept and flagged as not stated."
    },
    "espece": {
      "enum": [
        "chat",
        "chien"
      ],
      "type": "string",
      "description": "Species: chat (cat) or chien (dog); adoptions only cover cats and dogs. cat, kitten, dog or puppy are accepted. Omit for both."
    },
    "langue": {
      "enum": [
        "fr",
        "en"
      ],
      "type": "string",
      "default": "fr",
      "description": "Response language: \"fr\" (French, default) or \"en\" (English). A request written in English is answered in English even without it."
    },
    "limite": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "description": "Number of animals to return (whole number, 1 to 25, default 10); a larger value is lowered to 25. Use decalage for the next page."
    },
    "commune": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "French town name or 5-digit postcode (string, 2 to 80 characters), e.g. \"Nemours\", \"77140\" or \"Chaumont 52\" (department number to tell namesakes apart). France only; a place abroad returns no result."
    },
    "decalage": {
      "type": "integer",
      "default": 0,
      "maximum": 500,
      "minimum": 0,
      "description": "Number of animals to skip, for paging (whole number, 0 to 500, default 0), e.g. 10 for the second page of 10."
    },
    "ententes": {
      "type": "array",
      "items": {
        "enum": [
          "chats",
          "chiens",
          "enfants",
          "premier_animal"
        ],
        "type": "string"
      },
      "maxItems": 4,
      "minItems": 1,
      "description": "Gets on with (list of 1 to 4 values): chats (cats), chiens (dogs), enfants (children), premier_animal (suits a first-time owner), e.g. [\"chats\", \"enfants\"]. Only animals whose profile says so are kept."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude of the search centre in decimal degrees (number, -90 to 90), e.g. 48.267. Give it with longitude, instead of commune."
    },
    "rayon_km": {
      "type": "number",
      "default": 60,
      "maximum": 300,
      "minimum": 1,
      "description": "Search radius in km around commune or the coordinates (number, 1 to 300, default 60). Without a centre or departement, all of France."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude of the search centre in decimal degrees (number, -180 to 180), e.g. 2.693. Give it with latitude, instead of commune."
    },
    "departement": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Department or region instead of a radius (string): code or name, several separated by commas, e.g. \"77\", \"2A\", \"Bretagne\" or \"75, 92, 93\". A commune given with it only sorts by distance."
    },
    "age_max_mois": {
      "type": "integer",
      "maximum": 300,
      "minimum": 0,
      "description": "Maximum age in months, inclusive (whole number, 0 to 300), e.g. 11 for under one year or 23 for under two. Animals of unstated age are left out."
    },
    "age_min_mois": {
      "type": "integer",
      "maximum": 300,
      "minimum": 0,
      "description": "Minimum age in months, inclusive (whole number, 0 to 300), e.g. 96 for 8 years or older. Read from the age the shelter wrote; animals of unstated age are left out."
    }
  }
}

chercher_annonces

Search Mission Museaux's listings of lost, found and stray pets in France near a town or point, by species, breed, colour, sex, date or words. Use statut trouve_ou_errant for a lost pet, perdu for a found one. Returns up to 25 listings with photo, dates, source and link. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
tri	string	Sort order: recent (most recent first, default) or proche (closest to the centre first; needs commune or coordinates).
race	string	Breed or kind of animal in French or English (string, 2 to 60 characters), e.g. "labrador", "German Shepherd" or "rabbit". A partial name such as "berger" covers every breed containing it; chercher_races lists recognised names.
sexe	string	Sex: male or femelle (female). Listings of unknown sex are kept and flagged as not stated.
jours	integer	Only listings from the last N calendar days, Paris time (whole number, 1 to 365, default 60), e.g. 30.
texte	string	Free words or a phrase in French or English (string, up to 120 characters), e.g. "black lab mix red collar". Breed, colour and sex are recognised; other words are searched in the listing text. The answer says how it was understood.
espece	string	Species: chat (cat), chien (dog), oiseau (bird) or autre (rabbit, ferret, tortoise…). cat, kitten, dog or puppy are accepted. Omit for all species.

chercher_missions_benevolat

Find animal volunteering missions in France (shelters, wildlife, horses) near a town, in a department or nationwide, from API Engagement data. Use it to help someone volunteer. Returns up to 25 missions with organisation, place, dates and the Mission Museaux page to apply. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
type	string	Kind of mission: tous (all, default), benevolat (volunteering), service_civique (French civic service, ages 16 to 25) or volontariat (other volunteer schemes).
langue	string	Response language: "fr" (French, default) or "en" (English). A request written in English is answered in English even without it.
limite	integer	Number of missions to return (whole number, 1 to 25, default 10); a larger value is lowered to 25. Use decalage for the next page.
commune	string	French town name or 5-digit postcode (string, 2 to 80 characters), e.g. "Nemours", "77140" or "Chaumont 52" (department number to tell namesakes apart). France only; a place abroad returns no result.
decalage	integer	Number of missions to skip, for paging (whole number, 0 to 500, default 0), e.g. 10 for the second page of 10.
latitude	number	Latitude of the search centre in decimal degrees (number, -90 to 90), e.g. 48.267. Give it with longitude, instead of commune.

chercher_par_photo

Find LISTINGS whose photo looks like a pet photo (https url or base64), to see if a lost or found animal was reported. To only identify a breed, use reconnaitre_race. Returns up to 10 listings with likeness %, dates and source, plus a breed estimate. Photo not stored. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
cible	string	Which listings to compare with: trouves (found or stray animals, default: for an owner who lost a pet), perdus (lost animals: for someone who found one) or tous (all). found and lost are accepted.
espece	string	Species: chat (cat), chien (dog), oiseau (bird) or autre (other animal). cat or dog are accepted. Omit it and the species is inferred from the photo.
langue	string	Response language: "fr" (French, default) or "en" (English). A request written in English is answered in English even without it.
commune	string	French town name or 5-digit postcode (string, 2 to 80 characters), e.g. "Nemours", "77140" or "Chaumont 52" (department number to tell namesakes apart). France only; a place abroad returns no result.
latitude	number	Latitude of the search centre in decimal degrees (number, -90 to 90), e.g. 48.267. Give it with longitude, instead of commune.
rayon_km	number

chercher_races

Look up dog and cat breeds in Mission Museaux's directory by full or partial name, or list the most common. Use it to check a breed name. Returns French and English names, other names, FCI standard, origin, listings and adoptions per breed, and its page. Dogs and cats only. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
espece	string	Species: chat (cat) or chien (dog); the directory only covers cats and dogs. cat or dog are accepted. Omit for both.
langue	string	Response language: "fr" (French, default) or "en" (English). A request written in English is answered in English even without it.
limite	integer	Number of breeds to return (whole number, 1 to 30, default 10); a larger value is lowered to 30.
recherche	string	Breed name in French or English, full or partial (string, 2 to 60 characters), e.g. "berger", "retriever" or "Maine coon". Omit it to list the most common breeds.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "espece": {
      "enum": [
        "chat",
        "chien"
      ],
      "type": "string",
      "description": "Species: chat (cat) or chien (dog); the directory only covers cats and dogs. cat or dog are accepted. Omit for both."
    },
    "langue": {
      "enum": [
        "fr",
        "en"
      ],
      "type": "string",
      "default": "fr",
      "description": "Response language: \"fr\" (French, default) or \"en\" (English). A request written in English is answered in English even without it."
    },
    "limite": {
      "type": "integer",
      "default": 10,
      "maximum": 30,
      "minimum": 1,
      "description": "Number of breeds to return (whole number, 1 to 30, default 10); a larger value is lowered to 30."
    },
    "recherche": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "Breed name in French or English, full or partial (string, 2 to 60 characters), e.g. \"berger\", \"retriever\" or \"Maine coon\". Omit it to list the most common breeds."
    }
  }
}

obtenir_conseils

Get Mission Museaux's step-by-step advice for one situation: lost pet, found animal, kittens outdoors, injured animal, stray cats, mistreatment, identification (microchip, I-CAD) or adoption. Use it when someone asks what to do. Returns steps, FAQ and links, for France. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
langue	string	Response language: "fr" (French, default) or "en" (English). A request written in English is answered in English even without it.
situation*	string	The situation (required): chat_perdu (lost cat), chien_perdu (lost dog), animal_trouve (found animal), chatons (kittens outdoors), animal_blesse (injured), chats_errants (stray cats), maltraitance (mistreatment), identification (microchip, I-CAD) or adoption, e.g. "chat_perdu".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "situation"
  ],
  "properties": {
    "langue": {
      "enum": [
        "fr",
        "en"
      ],
      "type": "string",
      "default": "fr",
      "description": "Response language: \"fr\" (French, default) or \"en\" (English). A request written in English is answered in English even without it."
    },
    "situation": {
      "enum": [
        "chat_perdu",
        "chien_perdu",
        "animal_trouve",
        "chatons",
        "animal_blesse",
        "chats_errants",
        "maltraitance",
        "identification",
        "adoption"
      ],
      "type": "string",
      "description": "The situation (required): chat_perdu (lost cat), chien_perdu (lost dog), animal_trouve (found animal), chatons (kittens outdoors), animal_blesse (injured), chats_errants (stray cats), maltraitance (mistreatment), identification (microchip, I-CAD) or adoption, e.g. \"chat_perdu\"."
    }
  }
}

reconnaitre_race

Estimate the BREED of a dog or cat on a photo (https or base64), or the kind of bird or small pet (budgerigar, rabbit…). For matching listings, use chercher_par_photo. Returns likely breeds with shares, type or mix, and pages; an estimate, not a certainty. Photo not stored. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
espece*	string	Species shown on the photo (required): chat (cat), chien (dog), oiseau (bird) or autre (rabbit, guinea pig, tortoise, ferret…). cat, dog or rabbit are accepted.
langue	string	Response language: "fr" (French, default) or "en" (English). A request written in English is answered in English even without it.
photo_url	string	Public https address of the photo itself (string url; jpeg, png or webp, 8 MB at most), e.g. "https://example.com/dog.jpg". Give photo_url or photo_base64, not both.
photo_base64	string	The photo encoded in base64 (string, with or without a data: header, about 2.5 MB at most), instead of photo_url; an image received in the conversation goes here.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "espece"
  ],
  "properties": {
    "espece": {
      "enum": [
        "chat",
        "chien",
        "oiseau",
        "autre"
      ],
      "type": "string",
      "description": "Species shown on the photo (required): chat (cat), chien (dog), oiseau (bird) or autre (rabbit, guinea pig, tortoise, ferret…). cat, dog or rabbit are accepted."
    },
    "langue": {
      "enum": [
        "fr",
        "en"
      ],
      "type": "string",
      "default": "fr",
      "description": "Response language: \"fr\" (French, default) or \"en\" (English). A request written in English is answered in English even without it."
    },
    "photo_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2000,
      "description": "Public https address of the photo itself (string url; jpeg, png or webp, 8 MB at most), e.g. \"https://example.com/dog.jpg\". Give photo_url or photo_base64, not both."
    },
    "photo_base64": {
      "type": "string",
      "maxLength": 4000000,
      "description": "The photo encoded in base64 (string, with or without a data: header, about 2.5 MB at most), instead of photo_url; an image received in the conversation goes here."
    }
  }
}

trouver_aide_locale

Find local help near a French town, postcode or listing: town hall (phone, hours, pound), nearest vets, shelters and pounds within 50 km, neutering aid. Use it after a pet is lost or found. Returns up to 10 places with distance, phone, hours, source; open data, call first. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
besoin	string	What is needed: tous (all, default), veterinaire (vets), refuge (shelters), fourriere (pound), mairie (town hall) or sterilisation (neutering aid for stray cats).
langue	string	Response language: "fr" (French, default) or "en" (English). A request written in English is answered in English even without it.
annonce	string	Listing id or url from chercher_annonces or voir_annonce (string), e.g. a 36-character UUID, instead of commune: searches around the centre of its town, never its exact spot.
commune	string	French town name or 5-digit postcode (string, 2 to 80 characters), e.g. "Nemours" or "77140". Searches around the town centre. France only; give commune or annonce.
rayon_km	number	Search radius in km around the town centre (number, 1 to 50, default 50). Shelters and pounds are listed within 10, then 25, then 50 km.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "besoin": {
      "enum": [
        "tous",
        "veterinaire",
        "refuge",
        "fourriere",
        "mairie",
        "sterilisation"
      ],
      "type": "string",
      "default": "tous",
      "description": "What is needed: tous (all, default), veterinaire (vets), refuge (shelters), fourriere (pound), mairie (town hall) or sterilisation (neutering aid for stray cats)."
    },
    "langue": {
      "enum": [
        "fr",
        "en"
      ],
      "type": "string",
      "default": "fr",
      "description": "Response language: \"fr\" (French, default) or \"en\" (English). A request written in English is answered in English even without it."
    },
    "annonce": {
      "type": "string",
      "maxLength": 300,
      "minLength": 8,
      "description": "Listing id or url from chercher_annonces or voir_annonce (string), e.g. a 36-character UUID, instead of commune: searches around the centre of its town, never its exact spot."
    },
    "commune": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "French town name or 5-digit postcode (string, 2 to 80 characters), e.g. \"Nemours\" or \"77140\". Searches around the town centre. France only; give commune or annonce."
    },
    "rayon_km": {
      "type": "number",
      "default": 50,
      "maximum": 50,
      "minimum": 1,
      "description": "Search radius in km around the town centre (number, 1 to 50, default 50). Shelters and pounds are listed within 10, then 25, then 50 km."
    }
  }
}

voir_annonce

Read one listing or adoptable animal in full after a search, by the id or url from chercher_annonces, chercher_par_photo or chercher_adoptions. Returns description, marks, dates, source, photos and sightings, or temperament, health and fee. Never returns contact details. Accepts French or English; replies in French, or English with langue "en".

read-only

Argument	Type	Description
langue	string	Response language: "fr" (French, default) or "en" (English). A request written in English is answered in English even without it.
annonce*	string	Listing or adoptable animal to read (string): the id or url returned by chercher_annonces, chercher_par_photo or chercher_adoptions, e.g. "3f2b9c1e-5d4a-4b8e-9c7f-1a2b3c4d5e6f" or "https://missionmuseaux.fr/fiches/<id>".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "annonce"
  ],
  "properties": {
    "langue": {
      "enum": [
        "fr",
        "en"
      ],
      "type": "string",
      "default": "fr",
      "description": "Response language: \"fr\" (French, default) or \"en\" (English). A request written in English is answered in English even without it."
    },
    "annonce": {
      "type": "string",
      "maxLength": 300,
      "minLength": 8,
      "description": "Listing or adoptable animal to read (string): the id or url returned by chercher_annonces, chercher_par_photo or chercher_adoptions, e.g. \"3f2b9c1e-5d4a-4b8e-9c7f-1a2b3c4d5e6f\" or \"https://missionmuseaux.fr/fiches/<id>\"."
    }
  }
}

Mission Museaux

Try it

chercher_adoptions Read-only

Mission Museaux

Try it

chercher_adoptions Read-only

Tools (9)