Cursor plugin that connects agents to the X API through X's official hosted Model Context Protocol 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 publish posts you approve, manage your lists, bookmarks, blocks, and mutes, call X Chat endpoints, and schedule X calls.
- Open Cursor Settings → Plugins.
- Search for X.
- Click Install, then complete the OAuth sign-in when prompted.
Or run /add-plugin x in chat.
{
"mcpServers": {
"x": {
"type": "http",
"url": "https://api.x.com/mcp",
"auth": {
"CLIENT_ID": "NGdZYmo4VVp2T1BnRG55NlExOGQ6MTpjaQ",
"scopes": [
"tweet.read",
"tweet.write",
"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",
"calls.read",
"calls.write",
"broadcast.read",
"broadcast.write",
"media.write",
"developer.billing.write",
"developer.write",
"offline.access"
]
}
}
}
}| Category | Capabilities |
|---|---|
| Posts | Publish posts and replies you approve; 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) |
| Follows & likes | Read your follows and likes |
| Spaces | Search Spaces (live or scheduled), look them up by id or host, and read posts shared in a Space |
| Communities | Search communities and read a community's details |
| Lists | Read lists, their posts, members, and followers, and a user's owned, followed, pinned, and member lists; create, edit, follow, pin, and manage members of 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; list, open, and accept message requests |
| Calls | List and open scheduled X calls; schedule, update, or cancel one; RSVP to an invitation |
| Developer account | Read your X developer account settings and credit balance |
Posting uses the tweet.write scope. Agents show you the exact text of each post and publish it only after you approve it; a post is public as soon as it goes out.
No token to paste — the plugin ships with X's OAuth client ID and requests the scopes above. On first use, Cursor opens a browser window where you sign in to X and approve access. The offline.access scope lets Cursor refresh the session automatically, so you only sign in once.
X tools are included in Grok Bot at no cost.
Requests run in your user context, so they count against your account's rate limits. You can revoke access at any time from your X account's connected apps settings.
tweet.read, tweet.write, 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, calls.read, calls.write, broadcast.read, broadcast.write, media.write, developer.billing.write, developer.write, offline.access
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:
{
"mcpServers": {
"x-docs": {
"url": "https://docs.x.com/mcp"
}
}
}- 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, placed on a black tile matching X's own app icon.
MIT