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

ResourceWhat it is
/llms.txtOne line per guide with a description, grouped by category
/llms-full.txtFull text of every guide in one file
/search-index.jsonJSON array: URL path, title, description, category, quick answer, section headings
/breeds.jsonBreed risk tiers, typical premium ranges, common conditions, guide URLs
/rss.xml50 most recently updated guides
/sitemap-index.xmlEvery 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.