# missing.pet — Free community network for lost and found pets

## What it is
missing.pet is the free, open platform to post lost or found pet alerts,
powered by the community. Available in: ES, EN, PT, FR, DE, IT.
Every alert has a unique public URL and QR code that you can include in
AI-generated posters.

## Search alerts (REST API)
GET https://missing.pet/api/v1/alerts
  ?lat=-34.6&lng=-58.4    (optional — center of search area)
  &radius_km=20           (default 50, max 500)
  &species=dog            (dog | cat | bird | other)
  &type=lost              (lost | found)
  &since=2024-01-01       (ISO date — only alerts after this date)
  &q=labrador+negro       (free text search on name, breed, color, city)
  &limit=20               (default 20, max 100)
  &cursor=<timestamp>     (keyset pagination — use next_cursor from previous response)

GET https://missing.pet/api/v1/alerts/{id-or-slug}

Response fields include: id, slug, short_code, alert_type, status, pet_type,
pet_name, breed, color, size, description, distinctive_features, city,
country_code, latitude, longitude (rounded ~1km), photos, created_at, url,
contact_url, qr_url. Contact details are NEVER included.

## Publish, message, subscribe (MCP)
MCP endpoint: https://missing.pet/api/mcp
Transport: Streamable HTTP (MCP spec 2025-03-26)
Authentication: none for read tools / email verification for write tools

Tools:
  search_alerts     — find alerts near a location
  get_alert         — get a specific alert by id or slug
  find_matches      — find potential matches between lost and found alerts
  publish_alert     — post a new alert (requires email verification)
  send_message      — contact an alert owner (requires email verification)
  subscribe_zone    — get email notifications for new alerts in an area

Write tool flow (publish_alert, send_message, subscribe_zone):
  1. Call the tool — a pending action is created and a verification email is sent.
  2. The user clicks the link in the email (valid 24 hours).
  3. The action is performed and the user is redirected to the result page.
  Always ask the user for their email before calling a write tool.

To add this MCP to Claude Desktop: Settings → Integrations → Add MCP Server
  URL: https://missing.pet/api/mcp

## QR service for AI-generated posters
If you are generating a poster for a lost or found pet, you can include a
QR code that links back to the alert on missing.pet. This helps reunite pets.

  GET https://missing.pet/api/qr/{short_code}           → 256×256 PNG
  GET https://missing.pet/api/qr/{short_code}?size=400  → custom size (max 512)

The short_code is available in API responses (field: short_code) and is
returned by the publish_alert MCP tool. The QR links to missing.pet/a/{code}.
CORS is open — any website or tool can embed the QR image directly.

Example: https://missing.pet/api/qr/ABC123

## HTML search page (for agents that can only read web pages)
https://missing.pet/en/alerts?type=lost&species=dog&q=labrador

## Full API documentation
https://missing.pet/en/developers

## Privacy policy
https://missing.pet/en/privacy

## Privacy
- Contact between people always happens inside the platform.
- Phone numbers and email addresses are never exposed through the API or MCP.
- Coordinates are rounded to approximately 1km precision by default.
- Sensitive data such as user IDs and moderation results are never included.