Skip to content

X guide: Spaces, Communities, and Lists - #740

Merged
vaulpannx merged 3 commits into
cursor:mainfrom
vaulpannx:pvann/x-spaces-communities-lists
Oct 20, 2026
Merged

vaulpannx merged 3 commits into
cursor:mainfrom
vaulpannx:pvann/x-spaces-communities-lists

Conversation

@vaulpannx

@vaulpannx vaulpannx commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Adds the new Spaces, Communities, and Lists tools on the X connection to the X MCP guide. All of them are free.

  • Spaces (reads): search_spaces, get_spaces_by_id, get_spaces_by_ids, get_spaces_by_creator_ids, get_spaces_posts
  • Communities (reads): search_communities, get_communities_by_id
  • Lists (reads): get_lists_by_id, get_lists_posts, get_lists_members, get_lists_followers, get_users_owned_lists, get_users_followed_lists, get_users_pinned_lists, get_users_list_memberships
  • Lists (writes): create_lists, update_lists, add_lists_member, remove_lists_member_by_user_id, follow_list, unfollow_list, pin_list, unpin_list

Changes

  • Connect message: new Spaces & communities and Lists bullets.
  • Reading table: rows for Spaces, communities, a list, and someone's lists, using real tool names.
  • New "Managing lists" section: confirm before writes, resolve handles to ids, and say plainly that there's no list delete (offer private, rename, or removing members).
  • No tool reads a community's posts; the guide offers a topic search instead.
  • Missing scopes: Spaces and Lists route to reconnect (space.read, list.read, list.write are already requested).
  • README capabilities table split into Spaces, Communities, and Lists rows.
  • Version 2.10.0 with a changelog entry.

Test plan

  • Ask for live Spaces on a topic and the posts shared in one
  • Look up a community by keyword
  • Read a list's posts and members; create a list, add a member, pin it
  • Ask to delete a list and confirm the agent explains there's no delete tool

Note

Low Risk
Documentation and plugin metadata only; no runtime, auth, or API implementation changes in this repo.

Overview
X plugin 2.10.0 documents Spaces, Communities, and Lists on the user's X connection so agents know which MCP tools to use and how to handle errors.

The X MCP guide (SKILL.md) is the main change: connect-message bullets for Spaces/communities and Lists; reading-table rows mapping tasks to tools like search_spaces, get_communities_by_id, and list lookups; a new Managing lists section for writes (create_lists, members, follow/pin) with confirm-before-write and explicit “no delete list” guidance; note that community posts aren't readable (suggest search_posts_all instead); missing scopes now includes Spaces/Lists reconnect copy; list writes added to the ground-rules write list.

README, root README / marketplace descriptions, plugin.json (v2.10.0, keywords spaces/communities), and CHANGELOG align marketing and capabilities text with those features—all described as free tools on the hosted X MCP server.

Reviewed by Cursor Bugbot for commit f738765. Bugbot is set up for automated code reviews on this repo. Configure here.

Adds the 23 new reads and list writes to the connect message, reading table, and a Lists section, and notes there's no list delete or community-posts read.

Co-authored-by: Cursor <cursoragent@cursor.com>

@tcaldwell-x tcaldwell-x left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good overall. This is docs plus a version bump (2.9.0 → 2.10.0), CI validate passed, and the mcp.json scopes (space.read, list.read, list.write) are already there. A few small things:

Worth fixing

  • SKILL.md frontmatter: the reconnect hint still only names Chat/call/livestream tools. Since that line is what triggers the skill, it should mention Spaces and Lists too.
  • plugin.json: the description doesn't mention Spaces, Communities or Lists. Could also add spaces / communities to keywords.
  • "Built-in public reads" paragraph: worth saying that Spaces, communities and lists need the user's X connection.

Not verified

  • I didn't check the new tool names (e.g. create_lists, get_spaces_posts) against the live X MCP server, and the test plan boxes are unchecked. If a name is off, the agent will assume scopes are missing and ask the user to reconnect.

Nits

  • "Someone's lists" row: "{me} for theirs" reads better as "{me} for your own".
  • Rewrap the long frontmatter line to match the others.
  • Spell out get_users_by_username and get_users_by_usernames rather than the (s) shorthand.

Frontmatter reconnect hint names Spaces and Lists, the built-in reads paragraph says they need the user's connection, plugin.json describes them, and small wording nits.

Co-authored-by: Cursor <cursoragent@cursor.com>

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix is ON, but it could not run because the branch was deleted or merged before autofix could start.

Reviewed by Cursor Bugbot for commit e96ac89. Configure here.

Comment thread third_party/x/.cursor-plugin/plugin.json
Co-authored-by: Cursor <cursoragent@cursor.com>
@vaulpannx
vaulpannx merged commit 190d287 into cursor:main Oct 20, 2026
2 checks passed
SmailG added a commit to SmailG/claude-cursor-plugins that referenced this pull request Oct 21, 2026
…vaulpannx/pvann/x-spaces-communities-lists

chore: sync with cursor/plugins — Merge pull request cursor#740 from vaulpannx/pvann/x-spaces-communities-lists
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.

2 participants