Skip to content

Cursor plugin specification and official plugins

TypeScript

Add read-only X MCP plugin

Cursor Agent8b1de4854e8e
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 3e72a3b7..92ee3140 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -117,6 +117,11 @@
"name": "zoom",
"source": "third_party/zoom",
"description": "Zoom MCP integration — search meetings and recordings, pull summaries and transcripts, and work with Zoom Docs."
+ },
+ {
+ "name": "x",
+ "source": "third_party/x",
+ "description": "Read-only access to the X API — search posts and users, read timelines and mentions, and pull trends and news — via X's official hosted MCP server."
}
]
}
diff --git a/README.md b/README.md
index 02404618..411c8145 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `gong` | [Gong](third_party/gong/) | Cursor | Integrations | Gong MCP integration for revenue intelligence — account summaries, deal insights, and call briefs. |
| `salesforce` | [Salesforce](third_party/salesforce/) | Cursor | Integrations | Connect Cursor to Salesforce via Salesforce Hosted MCP — query, search, create, update, and traverse records in your org. |
| `apollo-io` | [Apollo.io](third_party/apollo-io/) | Cursor | Integrations | Connect Cursor to Apollo.io — prospect search, contact and company enrichment, lists, sequences, and one-off emails — via Apollo's official remote MCP server. |
+| `x` | [X](third_party/x/) | Cursor | Integrations | Read-only access to the X API — search posts and users, read timelines and mentions, and pull trends and news — via X's official hosted MCP server. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).
## Repository structure
diff --git a/third_party/x/.cursor-plugin/plugin.json b/third_party/x/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..fa570367
--- /dev/null
+++ b/third_party/x/.cursor-plugin/plugin.json
@@ -0,0 +1,48 @@
+{
+ "name": "x",
+ "displayName": "X",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Read-only access to the X API — search posts and users, read timelines and mentions, and pull trends and news — via X's official hosted MCP server.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://docs.x.com/tools/mcp",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.svg",
+ "keywords": [
+ "x",
+ "twitter",
+ "posts",
+ "search",
+ "trends",
+ "news",
+ "social",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "x",
+ "social",
+ "search",
+ "mcp"
+ ],
+ "variables": {
+ "type": "object",
+ "properties": {
+ "X_BEARER_TOKEN": {
+ "type": "string",
+ "title": "X app-only Bearer token",
+ "description": "App-only Bearer token from your app's Keys and tokens page in the X Developer Portal (https://developer.x.com). Grants read-only access to the X API with no user context."
+ }
+ },
+ "required": [
+ "X_BEARER_TOKEN"
+ ]
+ },
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/x/CHANGELOG.md b/third_party/x/CHANGELOG.md
new file mode 100644
index 00000000..08af2f4e
--- /dev/null
+++ b/third_party/x/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Logo: X's official mark from the X brand toolkit, on a black tile matching X's own app icon.
+- Added the `x` MCP server pointing at `https://api.x.com/mcp`.
+- Declared the `X_BEARER_TOKEN` plugin variable and forwarded it through the Authorization header, using X's app-only Bearer route so the server stays read-only and needs no local bridge.
diff --git a/third_party/x/LICENSE b/third_party/x/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/x/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/third_party/x/README.md b/third_party/x/README.md
new file mode 100644
index 00000000..8d7b76db
--- /dev/null
+++ b/third_party/x/README.md
@@ -0,0 +1,97 @@
+# X
+
+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 uses X's **app-only Bearer** route, which is read-only: agents can search and read public X data, but cannot post, bookmark, publish Articles, or act as any user.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **X**.
+3. Click **Install**, then set your app-only Bearer token (below).
+
+Or run `/add-plugin x` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "x": {
+ "type": "http",
+ "url": "https://api.x.com/mcp",
+ "headers": {
+ "Authorization": "Bearer ${X_BEARER_TOKEN}"
+ }
+ }
+ }
+}
+```
+
+## What agents can do
+
+| Category | Read-only capabilities |
+| --- | --- |
+| Posts | Fetch posts, see likers / reposters / quoters, recent counts |
+| Search | Full-archive post search, user search, news search |
+| Users | Look up users by id or handle; read a user's posts, timeline, and mentions |
+| News & trends | Get news stories, get trends for a location (WOEID) |
+
+Write tools and user-context tools (bookmarks, Articles, resolving the current user) are not reachable with an app-only token. See [Full user-context access](#full-user-context-access) if you need them.
+
+## Setup
+
+1. Create an app in the [X Developer Portal](https://developer.x.com).
+2. Open the app's **Keys and tokens** page and copy the **Bearer Token** (the app-only token).
+3. In **Dashboard → Plugins → Configure**, set **X app-only Bearer token** to that value.
+
+The token carries your app's own quota and rate limits rather than a user's. Rotate or regenerate it from the developer portal if it is ever exposed.
+
+On a team marketplace an admin sets the token once for everyone, so every member's tool calls share that app's rate limits.
+
+## Full user-context access
+
+X's other route runs the open-source [`xurl`](https://github.com/xdevplatform/xurl) bridge locally over stdio. It performs an OAuth 2.0 PKCE browser login, refreshes tokens automatically, and unlocks writes and user-context tools:
+
+```json
+{
+ "mcpServers": {
+ "x": {
+ "command": "npx",
+ "args": ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"],
+ "env": {
+ "CLIENT_ID": "YOUR_X_APP_CLIENT_ID",
+ "CLIENT_SECRET": "YOUR_X_APP_CLIENT_SECRET"
+ }
+ }
+ }
+}
+```
+
+That route needs OAuth 2.0 enabled on the app, `http://localhost:8080/callback` registered as a redirect URI, Node.js for `npx`, and a reachable browser for the first login — so it is deliberately not what this plugin ships.
+
+## X documentation search
+
+X also hosts an unauthenticated MCP server for its developer docs. Add it alongside this plugin if you want agents to look up endpoint details while they work:
+
+```json
+{
+ "mcpServers": {
+ "x-docs": {
+ "url": "https://docs.x.com/mcp"
+ }
+ }
+}
+```
+
+## Docs
+
+- MCP servers for the X API: https://docs.x.com/tools/mcp
+- Authentication overview: https://docs.x.com/fundamentals/authentication/overview
+- X API v2 OpenAPI spec: https://api.x.com/2/openapi.json
+
+Logo is X's official mark from the [X brand toolkit](https://about.x.com/en/who-we-are/brand-toolkit), placed on a black tile matching X's own app icon.
+
+## License
+
+MIT
diff --git a/third_party/x/assets/logo.svg b/third_party/x/assets/logo.svg
new file mode 100644
index 00000000..c63bbbd6
--- /dev/null
+++ b/third_party/x/assets/logo.svg
@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" fill="none" viewBox="0 0 192 192">
+ <title>X</title>
+ <rect width="192" height="192" fill="#000"/>
+ <path transform="translate(25.50 23.91) scale(0.1175)" fill="#fff" d="M714.163 519.284L1160.89 0H1055.03L667.137 450.887L357.328 0H0L468.492 681.821L0 1226.37H105.866L515.491 750.218L842.672 1226.37H1200L714.137 519.284H714.163ZM569.165 687.828L521.697 619.934L144.011 79.6944H306.615L611.412 515.685L658.88 583.579L1055.08 1150.3H892.476L569.165 687.854V687.828Z"/>
+</svg>
diff --git a/third_party/x/mcp.json b/third_party/x/mcp.json
new file mode 100644
index 00000000..6865c808
--- /dev/null
+++ b/third_party/x/mcp.json
@@ -0,0 +1,11 @@
+{
+ "mcpServers": {
+ "x": {
+ "type": "http",
+ "url": "https://api.x.com/mcp",
+ "headers": {
+ "Authorization": "Bearer ${X_BEARER_TOKEN}"
+ }
+ }
+ }
+}