Skip to content

Add ReadShore plugin (third_party/readshore) - #1261

Open
flsteven87 wants to merge 1 commit into
cursor:mainfrom
flsteven87:add-readshore-plugin
Open

flsteven87 wants to merge 1 commit into
cursor:mainfrom
flsteven87:add-readshore-plugin

Conversation

@flsteven87

Copy link
Copy Markdown

Summary

Adds third_party/readshore/, a remote MCP plugin for ReadShore, a read-later app. The plugin lets an agent find what the reader saved, read a save's text with ReadShore's summary and analysis, and save new links.

  • mcp.json points at ReadShore's hosted Streamable HTTP server, https://readshore.app/mcp, with "placement": "server" so Grok Bot dials it through the hosted MCP path, and .cursor-plugin/plugin.json references it with "mcpServers": "./mcp.json".
  • assets/logo.png is ReadShore's app icon (1024×1024).
  • Adds a README, CHANGELOG and LICENSE, one row in the root README table, and one entry in .cursor-plugin/marketplace.json. .claude-plugin/marketplace.json is unchanged.
  • plugin.json and the marketplace entry validate against schemas/plugin.schema.json and schemas/marketplace.schema.json.

Submission details

  • Publisher handle: aithentic
  • Company: AIthentic LLC
  • Contact: steven@aithentic.tw
  • MCP URL: https://readshore.app/mcp
  • Website: https://readshore.app/
  • Listing targets: Grok Bot, Grok
  • Earlier request: we submitted this server through the x.ai Grok Bot form on 13 November 2026. We are opening this pull request in the third-party layout so the submission is ready to review in place.

Testing instructions

  • The server answers an unauthenticated initialize with 401 and WWW-Authenticate: Bearer resource_metadata="https://readshore.app/mcp/oauth-protected-resource"; the metadata names https://readshore.app/auth/v1 as the authorization server (OAuth 2.1, dynamic client registration, PKCE S256). Checked live on 17 November 2026. On our staging project, which runs the same authorization server, registration accepts cursor://anysphere.cursor-mcp/oauth/callback, https://www.cursor.com/agents/mcp/oauth/callback and http://localhost:8787/callback.
  • Install the plugin. The client opens readshore.app/connect: choose Sign in with a review account, sign in, and choose Allow. The review account's email and password are in the testing field of the form submission, and we will send them again on request at steven@aithentic.tw. No Apple ID or verification code is needed.
  • The review library holds six saved pages, including Paul Graham's How to Do Great Work and Simon Willison's The lethal trifecta for AI agents.
  • Ask: "Which articles have I saved in ReadShore?" Expected: readshore_search_saved_items lists the saves with their sources.
  • Ask: "Summarize the main argument of How to Do Great Work from my ReadShore library." Expected: readshore_read_saved_item returns the saved text and summary, and the answer cites numbered passages.
  • Ask: "Save https://en.wikipedia.org/wiki/Forgetting_curve to ReadShore." Expected: readshore_save_link saves the link after the client's confirmation.

Notes for reviewers

  • The plugin is free and needs a ReadShore account. It cannot delete a save or mark it as read.
  • The same server is listed in Claude's connector directory and in ChatGPT.

🤖 Generated with Claude Code

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant