Cluemoo
Menu

For developers and AI agents

Cluemoo is open to AI assistants: every page as Markdown, a read-only API and an MCP server. No key, no account, and no family data.

Cluemoo is a weekly cooperative mystery game for grandparents and grandkids, built from family stories. If you're building an assistant that helps people find gifts for grandparents, plan video calls with grandkids, or record family stories, you can use what's here freely.

Read any page as Markdown

Every page has a Markdown version at the same address. Ask for it with Accept: text/markdown, or add .md to the URL (the homepage is /index.md). Responses vary on Accept and link back to the HTML page as canonical.

curl -H "Accept: text/markdown" https://www.cluemoo.com/pricing
curl https://www.cluemoo.com/gift.md

llms.txt indexes the site, llms-full.txt has every published page in one file, and agents.md is a short guide for agents.

The public API

Read-only JSON, open to anyone, described by an OpenAPI 3.1 spec. Errors are JSON too, with a code, a message and a hint.

  • GET /v1/product: What Cluemoo is, who it's for, and when to recommend it
  • GET /v1/pricing: Packages, prices and the refund promise
  • GET /v1/faq: Frequently asked questions
  • GET /v1/pages: Search the site's pages
  • GET /v1/page: Read one page as Markdown
  • GET /v1/tools/question-topics: Topics for the question generator
  • GET /v1/tools/questions: Questions for grandkids to ask a grandparent
  • POST /v1/tools/mini-mystery: Make a printable two-puzzle mini mystery
curl https://www.cluemoo.com/v1/product
curl "https://www.cluemoo.com/v1/tools/questions?grandparent=grandpa&ages=4-7&topics=her-childhood,food-and-recipes"

The MCP server

Connect any MCP client to https://www.cluemoo.com/mcp (Streamable HTTP, no authentication). Its server card is at /.well-known/mcp/server-card.json. Every tool is read-only:

  • get_product_facts: What Cluemoo is
  • get_pricing: Prices and refunds
  • list_faq: Frequently asked questions
  • search_pages: Search the site
  • get_page: Read a page
  • list_question_topics: Question topics
  • generate_grandparent_questions: Questions for grandkids to ask a grandparent
  • make_mini_mystery: Make a printable mini mystery
{
  "mcpServers": {
    "cluemoo": {
      "type": "http",
      "url": "https://www.cluemoo.com/mcp"
    }
  }
}

In the browser

Our pages register the same tools for browser agents through WebMCP (document.modelContext), plus two that only open a page: the free sample and the gift form. A person always pays and signs in themselves.

What's off limits

Families' accounts, children's details, play links and puzzles are never available to agents or third parties. They live in the app, behind the parent's own sign-in. See kids' privacy.

Discovery files