Cursor plugin specification and official plugins
TypeScript
Address review on Spaces, Communities, and Lists.
Paul Vanne96ac89fee4c
diff --git a/third_party/x/.cursor-plugin/plugin.json b/third_party/x/.cursor-plugin/plugin.jsonindex bb000a8a..f644be0c 100644--- a/third_party/x/.cursor-plugin/plugin.json+++ b/third_party/x/.cursor-plugin/plugin.json@@ -5,7 +5,7 @@"minClientVersions": {"cursor": "3.13.0"},- "description": "Search posts, read timelines, pull trends, manage bookmarks, access X Chat, schedule X calls, and manage livestreams.",+ "description": "Search posts, read timelines, pull trends, explore Spaces and communities, manage lists and bookmarks, access X Chat, schedule X calls, and manage livestreams.","author": {"name": "Cursor","email": "[email protected]"@@ -21,6 +21,8 @@"search","trends","news",+ "spaces",+ "communities","lists","bookmarks","calls",diff --git a/third_party/x/CHANGELOG.md b/third_party/x/CHANGELOG.mdindex 5a9023b9..5e0a85a0 100644--- a/third_party/x/CHANGELOG.md+++ b/third_party/x/CHANGELOG.md@@ -4,7 +4,7 @@ All notable changes to this plugin will be documented here.## 2.10.0 — Spaces, Communities, and Lists-- Added Spaces (`search_spaces`, `get_spaces_by_id(s)`, `get_spaces_by_creator_ids`, `get_spaces_posts`), Communities (`search_communities`, `get_communities_by_id`), and Lists: eight reads plus `create_lists`, `update_lists`, member, follow, and pin writes. There's no tool to delete a list or read a community's posts. All are free.+- Added Spaces (`search_spaces`, `get_spaces_by_id`, `get_spaces_by_ids`, `get_spaces_by_creator_ids`, `get_spaces_posts`), Communities (`search_communities`, `get_communities_by_id`), and Lists: eight reads plus `create_lists`, `update_lists`, member, follow, and pin writes. There's no tool to delete a list or read a community's posts. All are free.- The connect message, reading table, and README list these, a new "Managing lists" section covers list writes, and missing Spaces or Lists tools route to the reconnect path.## 2.9.0 — Free X tools, rebuilt guidediff --git a/third_party/x/skills/x-api-mcp-guide/SKILL.md b/third_party/x/skills/x-api-mcp-guide/SKILL.mdindex 4cd37a35..a8625aae 100644--- a/third_party/x/skills/x-api-mcp-guide/SKILL.md+++ b/third_party/x/skills/x-api-mcp-guide/SKILL.md@@ -5,11 +5,12 @@ description: >-Bot's built-in public X reads) and again on any X error. X tools are includedin Grok Bot at no cost: never estimate costs, check credits, or tell the userto buy credits. tools=0 / user-X-* not found is a setup failure, not a- paywall. Covers Spaces, communities, and Lists (reads and list writes), X Chat (XChat, inbox, DMs, unread, message requests,- Chat PIN, juicebox, xchat_lite: clone xchat-grokbot-helper yourself and- decrypt locally), scheduled X calls (schedule_call, list_scheduled_calls and- the other call tools), and livestreams (stream sources, broadcasts, scheduled- broadcasts, broadcast chat, moderators, mutes). Chat, call, or livestream+ paywall. Covers Spaces, communities, and Lists (reads and list writes), X+ Chat (XChat, inbox, DMs, unread, message requests, Chat PIN, juicebox,+ xchat_lite: clone xchat-grokbot-helper yourself and decrypt locally),+ scheduled X calls (schedule_call, list_scheduled_calls and the other call+ tools), and livestreams (stream sources, broadcasts, scheduled broadcasts,+ broadcast chat, moderators, mutes). Chat, call, livestream, Spaces, or Liststools missing while other X tools work: reconnect the X plugin.---# X MCP guide@@ -57,7 +58,7 @@ Before any user-facing X text:### Built-in public reads-Public reads live on Grok Bot's built-in X tools, not on the user's X connection: post lookups (`get_posts_by_id`, `get_posts_by_ids`), search (`search_posts_all`, `get_posts_counts_recent`), user lookups (`get_users_by_username`, `get_users_by_usernames`, `get_users_by_id`, `search_users`), news (`search_news`, `get_news`), and trends (`get_trends_by_woeid`). For those, don't ask the user to connect X. Their absence from the user's X connection is expected: not error 2, not missing scopes, and not an outage. Likewise `get_users_me` exists only on the user's connection, so its absence next to built-in reads is not an error. The user's own account, home timeline, bookmarks, chats, calls, and livestreams need their X connection.+Public reads live on Grok Bot's built-in X tools, not on the user's X connection: post lookups (`get_posts_by_id`, `get_posts_by_ids`), search (`search_posts_all`, `get_posts_counts_recent`), user lookups (`get_users_by_username`, `get_users_by_usernames`, `get_users_by_id`, `search_users`), news (`search_news`, `get_news`), and trends (`get_trends_by_woeid`). For those, don't ask the user to connect X. Their absence from the user's X connection is expected: not error 2, not missing scopes, and not an outage. Likewise `get_users_me` exists only on the user's connection, so its absence next to built-in reads is not an error. The user's own account, home timeline, bookmarks, Spaces, communities, lists, chats, calls, and livestreams need their X connection.## Errors@@ -137,7 +138,7 @@ Then follow error 1 or 2 if that is the real failure.| Someone's Spaces | Resolve the handle, then `get_spaces_by_creator_ids` | Paste the profile. || Communities | `search_communities`, then `get_communities_by_id` for details (members, access) | What topic? || A list | `get_lists_by_id`, `get_lists_posts`, `get_lists_members`, `get_lists_followers` | Paste the list link. |-| Someone's lists | `get_users_owned_lists`, `get_users_followed_lists`, `get_users_pinned_lists`, `get_users_list_memberships` (`{me}` for theirs) | Paste the profile. |+| Someone's lists | `get_users_owned_lists`, `get_users_followed_lists`, `get_users_pinned_lists`, `get_users_list_memberships` (`{me}` for your own) | Paste the profile. |If a tool takes `tweet.fields` or `post.fields`, send `created_at,public_metrics,author_id,lang,conversation_id`. Also send `user.fields=created_at,description,public_metrics,verified,location` and `expansions=author_id,referenced_tweets.id`.@@ -161,7 +162,7 @@ No tool reads a community's posts: give the community's details and offer a `sea| `follow_list` / `unfollow_list` | Follow or unfollow a list on `{me}` || `pin_list` / `unpin_list` | Pin or unpin a list on `{me}` |-Before a write, repeat the list and what will change. Resolve handles to ids with `get_users_by_username(s)`. There's no tool to delete a list: say so and offer to make it private, rename it, or remove its members. A 403 on these with `list.write` means [missing scopes](#missing-scopes).+Before a write, repeat the list and what will change. Resolve handles to ids with `get_users_by_username` or `get_users_by_usernames`. There's no tool to delete a list: say so and offer to make it private, rename it, or remove its members. A 403 on these with `list.write` means [missing scopes](#missing-scopes).## Scheduled calls