{"openapi":"3.1.0","info":{"title":"Pet Loss API","version":"0.1.0","description":"A fully local, wellbeing-safe reference for coping with the loss of a pet: a grief-process overview, common feelings, coping ideas, memorial ideas, a guide to talking to children, anniversary guidance, when-to-seek-support signals, real support-resource categories and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://petloss.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/petloss/docs"},"termsOfService":"https://connectorbay.com/petloss/terms"},"servers":[{"url":"https://petloss.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/petloss/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/grief_process_overview":{"post":{"operationId":"grief_process_overview","summary":"A normalizing overview of what grief after losing a pet commonly looks like as a process — no fixed","description":"A normalizing overview of what grief after losing a pet commonly looks like as a process — no fixed\n    timeline, not a straight line, shaped by the circumstances of the loss. General information, not a\n    description of what any one person will feel. Use for \"is it normal to still feel sad months later\", \"what\n    does grief over a pet usually look like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"grief_process_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/common_feelings_reference":{"post":{"operationId":"common_feelings_reference","summary":"A range of feelings commonly reported after losing a pet — sadness, guilt, relief, anger, numbness,","description":"A range of feelings commonly reported after losing a pet — sadness, guilt, relief, anger, numbness,\n    physical symptoms, feeling isolated in the grief — each with a brief normalizing note. Informational, not\n    diagnostic, and never tells an individual what they personally feel. Use for \"is it normal to feel relieved\n    too\", \"why do I feel guilty about the decision\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"common_feelings_referenceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/coping_ideas":{"post":{"operationId":"coping_ideas","summary":"Gentle, non-prescriptive ideas some people find helpful while grieving a pet — framed as options to","description":"Gentle, non-prescriptive ideas some people find helpful while grieving a pet — framed as options to\n    consider, never instructions or a checklist to complete. Use for \"what can help me cope with losing my\n    pet\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"coping_ideasArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/memorial_ideas":{"post":{"operationId":"memorial_ideas","summary":"Ways some people choose to memorialize a pet — a memory box, a photo tribute, planting something living,","description":"Ways some people choose to memorialize a pet — a memory box, a photo tribute, planting something living,\n    a donation in their name, commissioned art, a resting place, a small yearly ritual. Use for \"ideas for\n    memorializing my dog\", \"how can I remember my cat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"memorial_ideasArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/talking_to_children_guide":{"post":{"operationId":"talking_to_children_guide","summary":"Practical, age-appropriate guidance for talking to children about a pet's death — honest, direct","description":"Practical, age-appropriate guidance for talking to children about a pet's death — honest, direct\n    language over confusing euphemisms, answering at the level of detail a child asks for, and involving them\n    in a small memorial if they want. Use for \"how do I tell my kids the dog died\", \"should I say the cat went\n    to sleep\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"talking_to_children_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/anniversaries_and_hard_days_guide":{"post":{"operationId":"anniversaries_and_hard_days_guide","summary":"Guidance for anniversaries, adoption dates, and holidays that can bring grief back to the surface even","description":"Guidance for anniversaries, adoption dates, and holidays that can bring grief back to the surface even\n    after things have felt easier. Use for \"the anniversary of my dog's death is coming up, any ideas\", \"why did\n    I suddenly feel sad again on their birthday\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"anniversaries_and_hard_days_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/when_to_seek_support_guide":{"post":{"operationId":"when_to_seek_support_guide","summary":"General, non-diagnostic signals that talking to a professional about pet-loss grief might help — framed","description":"General, non-diagnostic signals that talking to a professional about pet-loss grief might help — framed\n    as an ordinary, reasonable step that doesn't require things to be \"bad enough\" first. Use for \"when should I\n    think about getting support for this\", \"is it time to talk to someone about my grief\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"when_to_seek_support_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_support_resources_guide":{"post":{"operationId":"find_support_resources_guide","summary":"Real categories of pet-loss support to look for — your veterinarian, veterinary-school pet-loss support","description":"Real categories of pet-loss support to look for — your veterinarian, veterinary-school pet-loss support\n    programs, pet loss support groups, a grief counselor experienced with pet loss, and people in your life.\n    Categories, not fabricated specific hotline numbers, since those vary and change by country and over time.\n    Use for \"where can I find pet loss support\", \"is there a hotline for this\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"find_support_resources_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/glossary":{"post":{"operationId":"glossary","summary":"Definitions of terms used elsewhere in this connector — disenfranchised grief, anticipatory grief,","description":"Definitions of terms used elsewhere in this connector — disenfranchised grief, anticipatory grief,\n    companion animal, euthanasia, Rainbow Bridge, pet loss support hotline. Use for \"what does disenfranchised\n    grief mean\", \"what's the Rainbow Bridge\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}