Developers and AI agents
Everything on Pawsured is available in machine-readable form, free and without a key. Numbers from the estimate endpoints are illustrations anchored on NAPHIA's industry averages, never quotes. If you use the content, cite the guide URL; every guide carries its own sources and date.
Plain-text and JSON indexes
| Resource | What it is |
|---|---|
| /llms.txt | One line per guide with a description, grouped by category |
| /llms-full.txt | Full text of every guide in one file |
| /search-index.json | JSON array: URL path, title, description, category, quick answer, section headings |
| /breeds.json | Breed risk tiers, typical premium ranges, common conditions, guide URLs |
| /rss.xml | 50 most recently updated guides |
| /sitemap-index.xml | Every page |
JSON API
Spec: /openapi.json (OpenAPI 3.1). Catalog: /.well-known/api-catalog (RFC 9727). CORS is open. Fair use; no key.
Search the guides
GET /api/search?q=trupanion+waiting+period&limit=5 Returns ranked results with title, URL, category, summary and the guide's quick answer. Optional category: Coverage, How it works, Costs, By breed, By state, By insurer, Tools.
Estimate a premium
GET /api/cost-estimate?species=dog&age=3&breed=Labrador%20Retriever&deductible=250&reimbursement=80&annual_limit=10000&area=average
Returns a low, mid and high monthly figure. The model multiplies NAPHIA's 2025 US average (about $70 a month for
dogs, $36 for cats) by factors for age, breed risk, deductible, reimbursement rate, annual limit and local vet
costs, the same model as the on-site calculator. POST with a JSON
body works too. Unknown breeds fall back to breed_risk (low, medium, high, very_high) or medium.
Calculate a reimbursement
GET /api/reimbursement?bill=6000&deductible=500&rate=80&deductible_met=false&annual_limit=10000 Deductible first, then the percentage, then the cap. Some insurers (Figo, Lemonade) apply the percentage first; the reimbursement guide explains the difference.
Health
GET /api/status MCP server
Endpoint: https://pawsured.com/mcp (Streamable HTTP, stateless, no auth). Server card:
/.well-known/mcp/server-card.json. Tools: search_guides,
estimate_pet_insurance_cost, calculate_reimbursement. Resources: the four indexes above.
POST /mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_guides","arguments":{"query":"french bulldog","limit":3}}} A2A agent
Agent card: /.well-known/agent-card.json. Endpoint
https://pawsured.com/a2a accepts message/send with a text part and returns a completed task
whose message lists matching guides with URLs and, for cost questions, an estimate.
POST /a2a
{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"How much is pet insurance for a 3 year old Labrador?"}],"messageId":"m1"}}} Agent skill and content signals
Skill index: /.well-known/agent-skills/index.json, with the skill
itself at SKILL.md. Crawl preferences are in
robots.txt (Content-Signal: search, ai-input and ai-train all allowed). Search description:
/opensearch.xml. In-browser agents get a search_pawsured_guides tool via
WebMCP where the browser supports it.
Terms
The API and indexes are provided as-is for information purposes. Estimates are not quotes or offers of insurance. Guides are copyrighted; quoting with attribution and a link is welcome, wholesale republishing is not. Questions: contact.