For AI assistants and developers
Use BetrayStories from ChatGPT, Claude and other agents
BetrayStories runs a free, public Model Context Protocol (MCP) server. An assistant connected to it can search our anonymous stories, read one in full, browse categories, read the Recovery Guides and look up crisis resources. It is read-only and needs no account. It has no access to anyone's account, reading history or Recovery data.
Server URL
https://www.betraystories.com/api/mcpTransport: Streamable HTTP (stateless). Authentication: none.
Connect it
- Claude (claude.ai or the desktop app): Settings → Connectors → Add custom connector, then paste the server URL.
- ChatGPT: Settings → Apps & Connectors → Advanced → turn on developer mode, then create a connector with the server URL and no authentication.
- Claude Code:
claude mcp add --transport http betraystories https://www.betraystories.com/api/mcp - Other clients (Cursor, VS Code, MCP Inspector): add a remote HTTP server with the URL above. A server card is published at /.well-known/mcp.json.
In browsers that support WebMCP, the same tools are also registered on every page of the site for in-browser agents.
Tools
search_stories- Search BetrayStories' library of anonymous, true stories about cheating, infidelity and betrayal (full-text + fuzzy). Use when someone wants stories similar to their situation, e.g. 'wife emotional affair with coworker' or 'found out through social media'. Returns titles, short excerpts, category, reading time and canonical URLs. Follow up with get_story to read one in full.
get_story- Get one BetrayStories story by slug (from search_stories or a betraystories.com/stories/<slug> URL): title, excerpt, category, reading time, full text (all stories are free to read), the canonical URL and a listen URL for the narrated version. Always cite the canonical URL.
list_categories- List the story categories on BetrayStories (e.g. workplace affair, emotional affair, caught red-handed) with descriptions and category page URLs. Use to browse by type of betrayal or to pick a category filter for search_stories.
list_recovery_guides- List BetrayStories' free Recovery Guides: practical, compassionate articles on getting over someone, healing a broken heart, how long a breakup takes to get over, and similar. Optionally pass a locale (e.g. 'es', 'hi'); English is used where a translation is missing.
get_recovery_guide- Get the full text of one BetrayStories Recovery Guide by slug (from list_recovery_guides): sections and FAQ, plus its canonical URL. These are general information, not therapy or medical advice.
get_crisis_resources- Get crisis and support resources. Call this FIRST whenever a user mentions self-harm, suicide, abuse, violence or being in danger. Always returns the local-emergency advice and the findahelpline.com directory (which covers ~130 countries), plus verified national lines for the given locale or country when known.
about_recovery_companion- Facts about BetrayStories' Recovery Companion: a private, guided healing program for people recovering from being cheated on or betrayed (daily plan, mood check-ins, AI companion sessions, journaling). Includes pricing and the free trial. Use when someone asks what it is, what it costs, or how to start.
Fair use
Every result includes the canonical betraystories.com URL; please link to it when you quote a story. Requests are rate limited per IP. Stories are anonymous and shared with consent, so do not try to identify the people in them.