Cursor plugin specification and official plugins
TypeScript
Request dm.read and dm.write on the X plugin.
Paul Vann256a21aa364c
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex a3d15f20..98137ca8 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -141,7 +141,7 @@{"name": "x","source": "third_party/x",- "description": "Search posts, read timelines, pull trends, and manage bookmarks."+ "description": "Search posts, read timelines, pull trends, manage bookmarks, and access X Chat."},{"name": "clay",diff --git a/third_party/x/.cursor-plugin/plugin.json b/third_party/x/.cursor-plugin/plugin.jsonindex 5ca54ee8..79d0e0be 100644--- a/third_party/x/.cursor-plugin/plugin.json+++ b/third_party/x/.cursor-plugin/plugin.json@@ -1,11 +1,11 @@{"name": "x","displayName": "X",- "version": "2.2.0",+ "version": "2.4.0","minClientVersions": {"cursor": "3.13.0"},- "description": "Search posts, read timelines, pull trends, and manage bookmarks.",+ "description": "Search posts, read timelines, pull trends, manage bookmarks, and access X Chat.","author": {"name": "Cursor","email": "[email protected]"@@ -23,6 +23,7 @@"news","lists","bookmarks",+ "chat","social","mcp"],diff --git a/third_party/x/CHANGELOG.md b/third_party/x/CHANGELOG.mdindex ccbd00cf..46478d3c 100644--- a/third_party/x/CHANGELOG.md+++ b/third_party/x/CHANGELOG.md@@ -2,6 +2,11 @@All notable changes to this plugin will be documented here.+## 2.4.0 — X Chat scopes++- Requested `dm.read` and `dm.write` so agents can call X Chat endpoints on `https://api.x.com/mcp`.+- Existing installs need to sign in to X again to pick up the new scopes.+## 2.3.0 — Auto credits, missing-tools failure, never pay first- Developer accounts are auto-created and auto-credited. On connect, agents confirm X tools exist, fetch `get_usage_credits`, then congratulate with “you've received free X API credits to get started” (no dollar amount). Starter amounts by plan (Ultra $100, SuperGrok Plus $50, Pro+ $30, Pro $10) only if the user asks how much they received. Remaining balance (`total_balance`) is for budgets and “what's left.”diff --git a/third_party/x/README.md b/third_party/x/README.mdindex cd55178e..aa1d7649 100644--- a/third_party/x/README.md+++ b/third_party/x/README.md@@ -2,7 +2,7 @@Cursor plugin that connects agents to the [X API](https://docs.x.com) through X's official hosted [Model Context Protocol](https://modelcontextprotocol.io/) server at `https://api.x.com/mcp`.-This plugin signs you in with OAuth as your own X account. It is no longer read-only: alongside searching and reading public X data, agents can manage your lists, bookmarks, blocks, and mutes.+This plugin signs you in with OAuth as your own X account. It is no longer read-only: alongside searching and reading public X data, agents can manage your lists, bookmarks, blocks, and mutes, and call X Chat endpoints.## Install@@ -35,6 +35,8 @@ Or run `/add-plugin x` in chat."block.write","bookmark.read","bookmark.write",+ "dm.read",+ "dm.write","developer.billing.write","developer.write","offline.access"@@ -57,6 +59,7 @@ Or run `/add-plugin x` in chat.| Lists | Read and manage your lists || Bookmarks | Read and manage your bookmarks || Blocks & mutes | Read your blocks and mutes; add or remove blocks |+| Chat | List conversations, fetch events, send messages, typing, and read receipts || Developer account | Read your X developer account settings and credit balance |Posting is not included: the plugin does not request the `tweet.write` scope, so agents cannot publish posts as you.@@ -69,7 +72,7 @@ Requests run in your user context, so they count against your account's rate lim## Scopes requested-`tweet.read`, `users.read`, `follows.read`, `space.read`, `mute.read`, `like.read`, `list.read`, `list.write`, `block.read`, `block.write`, `bookmark.read`, `bookmark.write`, `developer.billing.write`, `developer.write`, `offline.access`+`tweet.read`, `users.read`, `follows.read`, `space.read`, `mute.read`, `like.read`, `list.read`, `list.write`, `block.read`, `block.write`, `bookmark.read`, `bookmark.write`, `dm.read`, `dm.write`, `developer.billing.write`, `developer.write`, `offline.access`## X documentation searchdiff --git a/third_party/x/mcp.json b/third_party/x/mcp.jsonindex 38819723..bb459cd2 100644--- a/third_party/x/mcp.json+++ b/third_party/x/mcp.json@@ -18,6 +18,8 @@"block.write","bookmark.read","bookmark.write",+ "dm.read",+ "dm.write","developer.billing.write","developer.write","offline.access"