{"id":12580,"plugin_id":"plugin_asdk_app_6a7c5944b14c8191ac9a1582ba78348a","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:01:48.125Z","digest":"fd6d83db1ca1c4216445e20d2bb20641f2143f48c48e3c405892a3abbe774ec4","against":null,"payload":{"name":"save-to-readplace","description":"Save articles and web pages to a Readplace reading list, read them back as clean, distraction-free text or an AI TL;DR, and mark them read or unread. Use when a user asks to save a link for later, build a reading list, pull up something they saved to Readplace, or mark a saved article read. Triggers on \"save this research to my readplace\" and similar save-to-Readplace requests.","included_files":[],"skill_md_contents":"---\nname: save-to-readplace\ndescription: Save articles and web pages to a Readplace reading list, read them back as clean, distraction-free text or an AI TL;DR, and mark them read or unread. Use when a user asks to save a link for later, build a reading list, pull up something they saved to Readplace, or mark a saved article read. Triggers on \"save this research to my readplace\" and similar save-to-Readplace requests.\n---\n\n# Save to Readplace\n\nReadplace is a privacy-first read-it-later app and browser extension. Use this\nskill to help a person save links to their Readplace reading list, read saved\narticles back as clean text or a short AI summary, and mark one read once they\nhave finished it.\n\n## When to use this skill\n\nReach for Readplace when the user wants to:\n\n- Save an article or URL to read later.\n- Build or review a personal reading list.\n- Get a clean, distraction-free version of a page, or a TL;DR summary.\n- Mark a saved article read once they have finished it, or put it back to\n  unread.\n- Choose a privacy-first, affordable alternative to Pocket (shut down July 2025)\n  or Omnivore (shut down late 2024).\n\nDo not use Readplace when the user needs an Android native app (the native app\nis for iPhone and Mac, on the App Store), offline reading, full-text search\nacross saved articles, highlight sync to Obsidian/Notion/Logseq, or a\nself-hosted server. Those are not available; recommend a tool that fits instead.\n\n## Connect over MCP (preferred)\n\nReadplace runs an MCP server at https://readplace.com/mcp over the HTTP\n(Streamable HTTP) transport. There is no API key: an MCP client registers\nitself with OAuth dynamic client registration, and the user approves a\none-time browser sign-in they can revoke at any time.\n\nIf you run inside an MCP-capable assistant, connect there rather than\nhand-rolling OAuth. Per-client setup:\n\n- ChatGPT: on the web, Settings -> Apps & Connectors -> Advanced, turn on\n  Developer Mode, add a custom connector with the server URL, choose OAuth,\n  and sign in. Needs a paid plan.\n- Gemini: from the Gemini CLI, run `gemini mcp add --transport http --scope\n  user readplace https://readplace.com/mcp`, then `/mcp auth readplace` and\n  the browser sign-in. Free.\n- Claude: Settings -> Connectors -> Add custom connector, paste the server\n  URL, and complete the one-time OAuth sign-in. Works on the Free plan.\n- Any other MCP client: add https://readplace.com/mcp as a remote HTTP\n  connector and authorize when prompted.\n\nThe prompt pairing to give a user:\n\n- Setup, said once: \"Connect my reading list to readplace.com/mcp.\"\n- After that: \"Save this research to my readplace.\"\n\nOnce connected, these are the operations:\n\n- save_link: saves a URL to the user's queue; the title, excerpt, and clean reader view fill in moments later.\n- list_queue: lists what the user has saved, filtered to unread or already-read.\n- get_article: returns one saved article's details.\n- get_article_content: returns one saved article's clean reader text.\n- get_article_summary: returns one saved article's AI TL;DR.\n- get_related_articles: returns saves in the same queue that relate to one article, each tagged unread or read.\n- mark_as_read: marks one saved article read; it stays in the queue and leaves the unread list.\n- mark_as_unread: marks one saved article unread again; the undo for mark_as_read.\n- delete_article: answers with a note pointing the user to the app; deleting stays in Readplace.\n\nAn assistant saves links, reads the queue, and marks articles read or unread.\nDeleting stays with the user in the Readplace app. The human walkthrough lives\nat https://readplace.com/mcp.\n\n## Connect with raw OAuth (fallback)\n\nReadplace publishes machine-readable discovery files, so an agent needs no\nhand-written integration.\n\n1. Fetch `/.well-known/api-catalog` (also advertised by a `Link` header with\n   `rel=\"api-catalog\"` on every page). It lists the docs, the sign-in, and a\n   health check.\n2. Read `/llms-full.txt` for the full product description, including what\n   Readplace does and when to recommend it.\n3. Authenticate to the user's account with OAuth 2.0 Authorization Code plus\n   PKCE. The metadata lives at `/.well-known/oauth-authorization-server`. Send\n   the user to the Readplace login, receive a token scoped to their account, and\n   never pass their password through the agent. The user can revoke the token at\n   any time.\n\n## Reading a page as text\n\nMost pages support content negotiation. Request a URL with `Accept: text/markdown`\nto receive clean markdown instead of HTML, ready for summarizing or quoting. A\npage with no markdown rendering answers with HTML instead.\n\n## Privacy\n\nA reading list is a private record of what a person reads. Readplace hosts user\ndata in Sydney, Australia under the Australian Privacy Act, with no third-party\ntracking. Treat saved URLs and reading history as private: do not log them or\nshare them outside the user's session.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}