Build with Paw Multiverse: API, MCP and open data

Published by Paw Multiverse (A.I.T. Multiverse Consulting Ltd) · Last updated 22 September 2026

Paw Multiverse holds two things that an AI model cannot make up and should not guess: a dated record of pet food recalls read from five official registers, and a directory of animal poison services checked against each operator's own website. This page lists every way to use them from your own app, website, AI assistant or agent. Everything here is free, needs no key, and is licensed CC BY 4.0. We ask only that you name where it came from.

On this page (8 sections)

1. At a glance
2. AI assistants and agents (MCP)
3. Ask in plain language
4. REST API
5. Open data and feeds
6. Widgets for websites
7. Rules that come with the data
8. Licence, attribution and contact

At a glance

• Two MCP servers over Streamable HTTP: https://pawmultiverse.com/mcp-recalls (six recall tools) and https://pawmultiverse.com/mcp-server (the animal poison service directory).
• An OpenAPI description at /openapi.json and an MCP discovery file at /.well-known/mcp.json.
• A question endpoint, /ask.json, that answers from the recall record with numbered sources.
• A Markdown copy of every page: add index.md to any page URL (the homepage and record pages also answer Accept: text/markdown). The site map for language models is /llms.txt, and the full text is /llms-full.txt.
• Open data downloads (CSV and JSON), dated archives and a citation file at /open-data/.
• Two widgets any clinic, shelter or shop can paste into its own site: see Put the recall check on your site.

AI assistants and agents (MCP)

Add either server to any client that speaks the Model Context Protocol. No sign-up and no key.

{
  "mcpServers": {
    "paw-recall-record":   { "type": "http", "url": "https://pawmultiverse.com/mcp-recalls" },
    "paw-poison-services": { "type": "http", "url": "https://pawmultiverse.com/mcp-server" }
  }
}

paw-recall-record tools: check_pet_food_bag (a barcode or lot code against four countries at once), get_recall_record, list_recall_registers, ask_recall_record, search_recalls and cross_border_recalls (the same product recalled in one country and sold in another).

paw-poison-services tools: find_pet_poison_service and list_pet_poison_countries. Each service comes with its phone number, hours, fee, who it serves and the page it was read from.

Agent discovery files are published at /.well-known/agent-card.json, /.well-known/api-catalog and /.well-known/mcp/server-card.json. Pages in a browser also expose their tools to in-browser agents through WebMCP.

Ask in plain language

GET https://pawmultiverse.com/ask.json?q=has+purina+been+recalled+in+the+uk

Returns {question, answer, sources[], disclaimer, generated_by, licence}. Every source carries the record URL and its Markdown URL, so your assistant can quote the authority's own notice instead of paraphrasing a paraphrase. The answer is machine-written and labelled as such; the sources are the record.

REST API

GET /wp-json/mv/v1/status                 totals, and when each register was last read without error
GET /wp-json/mv/v1/records?jurisdiction=GB every record, filterable by country, register, status, text
GET /wp-json/mv/v1/records/{source}/{key}  one record with every dated version
GET /wp-json/mv/v1/bag?code=00087535400604 barcode or lot code, four countries at once
GET /wp-json/mv/v1/bag/cross-border        products recalled in one country, sold in another
GET /wp-json/mv/v1/changes                 what the authorities changed, and when
GET /api/local-help.json?cc=GB             animal poison services for one country

The full description, with every parameter, is at /openapi.json. Responses are JSON with open CORS. Please cache what you can: most of it changes a few times a day at most.

Open data and feeds

• pet-food-recalls.csv and pet-food-recalls.json: the whole record.
• versions.json, changes.json, sources.json and cross-border.json.
• Dated snapshots in the archive, and CITATION.cff for papers and datasets.
• Feeds: RSS and JSON Feed for all countries, or one country at /recalls-feed/country-us.xml (also gb, ca, fr, and .json).

Widgets for websites

One line of HTML puts the barcode recall check, or the latest recalls for one country, on any website. It is meant for veterinary practices, shelters, breeders, groomers and pet shops. The code and the rules are on Put the recall check on your site.

Rules that come with the data

These are not legal terms; they are what keeps the data useful to the animals it is about. If you pass the data on, please pass these on too.

• No match is not "safe". A barcode with no match means no listed authority has published a recall carrying that barcode in what has been read so far. Many recalls are announced by lot code or best-before date only.
• A recall is not a verdict on a business. It is what an authority published on a date.
• Not veterinary advice. Nothing here holds dosing or treatment information. In an emergency, the right answer is a vet or a poison service, and the directory tells you which one.
• Nothing is for sale inside the record. Nobody can pay to appear in it, be removed from it, or change what it says. See Partner with Paw Multiverse.

Licence, attribution and contact

The recall record and the poison service directory are licensed CC BY 4.0. A credit line such as "Source: Paw Multiverse recall record (pawmultiverse.com), from the official notices it cites" with a link is enough. AI crawlers are welcome for search, retrieval and training; see robots.txt.

Building something with it, need a field we do not expose yet, or want your product list watched across four countries? Write to paw@aitmultiverse.com. A person reads it.