{"openapi":"3.1.0","info":{"title":"Grief Kit API","version":"0.1.0","description":"A fully local, wellbeing-safe reference for coping with the death of someone close to you: a grief-process overview, common feelings, coping ideas, remembrance ideas, a guide to talking to children, anniversary guidance, when-to-seek-support signals with a crisis-line pointer, 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://griefkit.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/griefkit/docs"},"termsOfService":"https://connectorbay.com/griefkit/terms"},"servers":[{"url":"https://griefkit.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/griefkit/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 a death commonly looks like as a process — no fixed timeline,","description":"A normalizing overview of what grief after a death commonly looks like as a process — no fixed timeline,\n    not a straight line, shaped by the circumstances of the loss. General information, not a description of what\n    any one person will feel. Use for \"is it normal to still feel sad months later\", \"what does grief usually\n    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 a death — sadness, guilt, relief, anger, numbness, physical","description":"A range of feelings commonly reported after a death — sadness, guilt, relief, anger, numbness, physical\n    symptoms, anxiety about other losses, feeling isolated — each with a brief normalizing note. Informational,\n    not diagnostic, and never tells an individual what they personally feel. Use for \"is it normal to feel\n    relieved too\", \"why do I feel guilty\".","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 — framed as options to consider,","description":"Gentle, non-prescriptive ideas some people find helpful while grieving — framed as options to consider,\n    never instructions or a checklist to complete. Use for \"what can help me cope with this loss\".","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/remembrance_ideas":{"post":{"operationId":"remembrance_ideas","summary":"Ways some people choose to remember someone who died — a memory box, a photo tribute, planting something","description":"Ways some people choose to remember someone who died — a memory box, a photo tribute, planting something\n    living, a donation in their name, telling stories together, a resting place, a small yearly ritual. Use for\n    \"ideas for remembering my dad\", \"how can I honor her memory\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"remembrance_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 death — honest, direct language over","description":"Practical, age-appropriate guidance for talking to children about a death — honest, direct language over\n    confusing euphemisms, answering at the level of detail a child asks for, and involving them in a small\n    remembrance if they want. Use for \"how do I tell my kids grandpa died\", \"should I say he passed away\".","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, birthdays, and holidays that can bring grief back to the surface even after","description":"Guidance for anniversaries, birthdays, and holidays that can bring grief back to the surface even after\n    things have felt easier. Use for \"the anniversary of her death is coming up, any ideas\", \"why did I suddenly\n    feel sad again on his 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 grief might help — framed as an","description":"General, non-diagnostic signals that talking to a professional about grief might help — framed as an\n    ordinary, reasonable step that doesn't require things to be \"bad enough\" first — plus a crisis-line pointer\n    for anyone having thoughts of suicide or self-harm. Use for \"when should I think about getting support for\n    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 grief support to look for — a grief counselor or therapist, hospice or hospital","description":"Real categories of grief support to look for — a grief counselor or therapist, hospice or hospital\n    bereavement programs, grief support groups, faith or community organizations, employee assistance programs,\n    and people in your life. Categories, not fabricated specific hotline numbers, since those vary and change by\n    country and over time. Use for \"where can I find grief support\", \"is there a support group 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    complicated grief, bereavement, mourning, grief burst. Use for \"what does disenfranchised grief mean\",\n    \"what's a grief burst\".","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}}}}