Prompt for your agent
Using Claude Code, Cursor or another coding agent? Paste this in before you start. It points your agent at the right documents and gives it the rules that matter most when the people at the other end are families.
I am integrating the Cherished Book API into our system. Cherished Book holds online memorials for people and pets who have died. Before writing any code, read: - https://www.cherishedbook.com/developers/ai.md: the whole API in Markdown - https://www.cherishedbook.com/openapi/public.yaml: the OpenAPI specification - https://www.cherishedbook.com/developers/links: onboarding links, if all we need is to pre-fill the create-a-memorial form Rules to follow: - The base URL is https://app.cherishedbook.com/api/v1. Authenticate with a business API token sent as "Authorization: Bearer <token>". A Business Admin creates it in Business settings, under API tokens. Read it from an environment variable or secret store. Never hard-code, log or commit it. - A token belongs to one organisation and only sees that organisation's memorials. - The limit is 50 requests a minute. On a 429, wait for Retry-After and try again. - Text is safety-checked after it is written, so a memorial is not live until the API says it is. Never report one as published before then, in code, logs or anything shown to a family. - If the job is only to hand a family a part-completed form, use an onboarding link. It needs no token. - The people at the other end are usually recently bereaved. Any wording we show them should be plain and gentle. Start by summarising what the API can do for our use case, then propose a plan before writing code.
Looking for the version a family pastes into their own assistant? That is on the AI assistants page.
Connect over MCP
Your agent can also work with memorials directly, through our MCP server at
https://app.cherishedbook.com/api/mcp. With a business API token it sees the memorials
of the families you serve. Keep the token in an environment variable, here
CHERISHED_BOOK_TOKEN.
Claude Code
claude mcp add --transport http cherished-book https://app.cherishedbook.com/api/mcp \
--header "Authorization: Bearer $CHERISHED_BOOK_TOKEN"
Cursor
In .cursor/mcp.json:
{
"mcpServers": {
"cherished-book": {
"url": "https://app.cherishedbook.com/api/mcp",
"headers": { "Authorization": "Bearer ${env:CHERISHED_BOOK_TOKEN}" }
}
}
}
Claude Desktop and claude.ai
Open Settings, then Connectors, and add a custom connector with the address above. There is no token to paste: you sign in and approve it in your browser. Approve it while your business is the one selected in Cherished Book to reach the families you serve. Otherwise it connects your personal account. The approval screen says which.
Documents for agents
| Document | What it is |
|---|---|
| /developers/ai.md | The whole API in plain Markdown |
| /openapi/public.yaml | The OpenAPI specification |
| /llms.txt | What an assistant should know first |
| /.well-known/mcp.json | Where the MCP server and its authorisation live |
| /developers/links | Onboarding links, for pre-filling the form without the API |