Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
5 changes: 3 additions & 2 deletions third_party/x/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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": "plugins@cursor.com"
Expand All @@ -23,6 +23,7 @@
"news",
"lists",
"bookmarks",
"chat",
"social",
"mcp"
],
Expand Down
5 changes: 5 additions & 0 deletions third_party/x/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.”
Expand Down
7 changes: 5 additions & 2 deletions third_party/x/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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"
Expand All @@ -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.
Expand All @@ -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 search

Expand Down
2 changes: 2 additions & 0 deletions third_party/x/mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@
"block.write",
"bookmark.read",
"bookmark.write",
"dm.read",
"dm.write",
Comment thread
vaulpannx marked this conversation as resolved.
"developer.billing.write",
"developer.write",
"offline.access"
Expand Down
Loading