{
  "markdown": "# eighty MCP — docs, prompts, and screenshots\n\n[![MCP](https://img.shields.io/badge/MCP-spec--compliant-purple)](https://modelcontextprotocol.io/)\n[![Auth](https://img.shields.io/badge/auth-OAuth%202.1%20%2B%20PKCE%20%2B%20DCR-blue)](docs/auth.md)\n[![Status](https://img.shields.io/badge/status-public-green)](https://mcp.80l.app)\n\nA public [Model Context Protocol](https://modelcontextprotocol.io/) server that lets any MCP-compatible client — Claude Desktop, Claude.ai Connectors, Cursor, ChatGPT Apps, MCP Inspector — read and write a real-life RPG character sheet.\n\n> The server is live at **`https://mcp.80l.app`**. This repo is the documentation, example prompts, and reference screenshots — not the server source.\n\n![MCP Inspector connected to mcp.80l.app, showing the eighty tool catalog](inspector/screenshots/07-inspector-tool-list.png)\n\n## What is this\n\n[eighty](https://apps.apple.com/us/app/80l/id6759132488) is a gamified self-improvement iOS app: real-world quests, character stats, skill trees, badges, streaks, leaderboards, social challenges. The MCP server exposes the same 35 actions the iOS app uses — `browse_quests`, `create_quest`, `take_quest`, `complete_quest`, `get_profile`, `send_challenge`, `view_public_profile`, the whole catalog — so an LLM client can drive the experience: plan your day as quests, coach you through them, send challenges to friends, react to your social feed, level up your character.\n\nIt's the same backend the iOS app talks to. No fork. Your MCP session and your iOS app are two views over one account.\n\n## Quickstart\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"eighty\": {\n      \"url\": \"https://mcp.80l.app\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop. On first tool call, OAuth opens in your browser — sign in with Google, Apple, or email/password. (New users get an account auto-provisioned at sign-in.) You're now connected.\n\nFull setup for other clients (Cursor, Claude.ai web Connectors, MCP Inspector, ChatGPT Apps) is in [docs/auth.md](docs/auth.md).\n\n## Try it without installing anything\n\nInspector — Anthropic's reference MCP client — runs locally with no setup:\n\n```bash\nnpx @modelcontextprotocol/inspector\n```\n\nIn the browser: set Transport Type to *Streamable HTTP*, URL to `https://mcp.80l.app`, Connection Type to *Via Proxy*, click Connect. Authorize via the OAuth popup. The full tool catalog loads in the sidebar.\n\n## Tools\n\n35 tools across 7 categories — quests, quest creation, skills, profile, social, challenges, leaderboard. Plus 4 ambient resources and 3 pre-built prompts. Full reference in [docs/tools-reference.md](docs/tools-reference.md).\n\nA few signature examples:\n\n| Tool | What it does |\n|---|---|\n| `view_public_profile` | Same rich profile shape the iOS app shows on tap (level, stats, streaks, badges, completed quests, follower counts). |\n| `create_quest` + `publish_quest` | Author a real quest from MCP that ships into eighty's catalog after review. |\n| `send_challenge` *(Premium)* | Real-time challenge to another user with a time limit — fires a push notification to their phone. |\n| `whats_next` *(prompt)* | One-shot personalized recommendation drawn from your profile, active quests, favorite skills, and today's daily quest. |\n\nHand-picked example prompts (copy-paste into your client) are in [prompts/](prompts/).\n\n## How it works\n\n```\nclient → mcp.80l.app (OAuth 2.1) → same backend handlers the iOS app uses → persistence\n```\n\nThe MCP server is a thin authorization shell — every tool delegates to the same handler the iOS app calls. One source of truth for business rules (quest caps, premium gating, social-graph privacy, idempotency). See [docs/architecture.md](docs/architecture.md).\n\n## Authentication\n\nOAuth 2.1 + PKCE + Dynamic Client Registration ([RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591)). No API keys, no developer-portal signup. Any spec-compliant MCP client auto-discovers the OAuth endpoints from `/.well-known/oauth-protected-resource` and registers itself. Full wire-level flow in [docs/auth.md](docs/auth.md).\n\n## Premium features\n\nMost of the surface is free. Four tools (challenges) plus the top-50 leaderboard rows (rows 11–50) require an active eighty Premium subscription, which is sold through the iOS App Store. See [docs/premium-features.md](docs/premium-features.md) for what's gated and how to upgrade.\n\n## Screenshots\n\nReference captures showing the server in use. Real demo data from staging; no PII.\n\n**Claude Desktop** — [claude-desktop/screenshots/](claude-desktop/screenshots/)\n\n- `01-quests-browse-quests.png` — `browse_quests` listing\n- `02-profile-character-sheet.png` — `get_profile` (Atlas Lv 58)\n- `03-social-public-profile.png` — `view_public_profile` rich response (Ember Lv 45)\n- `04-challenges-pending.png` — `list_challenges` + `get_challenge_details`\n\n**MCP Inspector** — [inspector/screenshots/](inspector/screenshots/)\n\n- `07-inspector-tool-list.png` — tool catalog + connected state\n- `08-inspector-browse-quests.png` — tool execution + JSON response\n- `09-inspector-view-public-profile.png` — `view_public_profile` (Ember)\n- `10-inspector-prompts.png` — the three MCP prompts\n\n## Other first-party clients\n\n- **iOS** — [App Store](https://apps.apple.com/us/app/80l/id6759132488)\n- **Android** — not on Android yet? [Subscribe for updates](https://80l.app/#waitlist).\n\n## Repo layout\n\n```\n.\n├── README.md                       (you are here)\n├── docs/\n│   ├── architecture.md             (thin proxy → backend handlers)\n│   ├── tools-reference.md          (all 35 tools with signatures)\n│   ├── auth.md                     (OAuth 2.1 setup per client)\n│   └── premium-features.md         (what's gated, how to upgrade)\n├── claude-desktop/\n│   ├── claude_desktop_config.json  (drop-in config snippet)\n│   └── screenshots/                (4 + 2 bonus reference captures)\n├── inspector/\n│   └── screenshots/                (4 captures from MCP Inspector)\n└── prompts/\n    ├── README.md                   (index)\n    └── 01–08-*.md                  (8 example prompts)\n```\n\n## License\n\nMIT.\n\n---\n\n*Built by [@alemetlem](https://twitter.com/alemetlem). Star the repo if you want to see more public MCPs for consumer apps.*\n",
  "bytes": 6212,
  "sha": "84972c868a564d7ca2dcd92053b2c901bb5159ed97474142fdb8d25efde55347",
  "repo_slug": "metlem80/eighty-mcp-examples",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_metlem80_eighty_cfdd3239/readme"
}