Skip to content

Cursor plugin specification and official plugins

TypeScript

Say "X Chat is free for this plugin."

Santiago Medina Rolong3cd61d495353
diff --git a/third_party/x/CHANGELOG.md b/third_party/x/CHANGELOG.md
index 1e80297f..40a01dbe 100644
--- a/third_party/x/CHANGELOG.md
+++ b/third_party/x/CHANGELOG.md
@@ -11,7 +11,7 @@ All notable changes to this plugin will be documented here.
- Threads can include older unencrypted messages. The helper's `decrypt` accepts every event and marks each message `verified`, `unencrypted`, or `unverified`. An unverified message still includes its text when it could be decrypted; only a message that cannot be decrypted comes back without text. Existing helper clones are pulled so they pick this up. Replies are still always encrypted.
- Fetch signing keys for every sender and group member with `get_users_public_keys` (up to 100 ids per call, all key versions). The helper takes the entries as returned and skips incomplete ones.
- A page with `result_count: 0` that still has a `next_token` is not an empty thread: keep paging, at least 20 events per page. Dropped the encrypted-only framing, the hint that empty `data` can mean an empty thread, and the advice to keep `max_results` small. Agents must not claim they checked all chats unless they read every thread to the end.
-- X Chat is free in Grok Bot. Do not estimate cost, ask for confirmation, or check credits for conversation and event reads, public key lookups, `add_conversation_keys`, `send_chat_message`, typing indicators, or marking a conversation read. Page the inbox and each relevant thread at `max_results` 100 until `next_token` is absent.
+- X Chat is free for this plugin. Do not estimate cost, ask for confirmation, or check credits for conversation and event reads, public key lookups, `add_conversation_keys`, `send_chat_message`, typing indicators, or marking a conversation read. Page the inbox and each relevant thread at `max_results` 100 until `next_token` is absent.
## 2.5.1 — X Chat in the always-read MCP guide
diff --git a/third_party/x/skills/x-api-mcp-guide/SKILL.md b/third_party/x/skills/x-api-mcp-guide/SKILL.md
index 5cef84f0..70510a22 100644
--- a/third_party/x/skills/x-api-mcp-guide/SKILL.md
+++ b/third_party/x/skills/x-api-mcp-guide/SKILL.md
@@ -262,7 +262,7 @@ When X calls are required this session: confirm tools exist, then `get_users_me`
Every X call can charge the user. Estimate the cost **before** calling. Read [references/pricing.md](references/pricing.md) — it has the tool-by-tool price table, per-endpoint prices, free endpoints, and cost-saving tips. Once per session, fetch live pricing from https://console.x.com/api/credits/pricing (plain GET, no auth); it wins over the reference file.
-X Chat is free in Grok Bot. Do not estimate a cost, ask for confirmation, or check or require credits for `get_chat_conversations`, `get_chat_conversation`, `get_chat_conversation_events`, public key lookups, `add_conversation_keys`, `send_chat_message`, typing indicators, or marking a conversation read.
+X Chat is free for this plugin. Do not estimate a cost, ask for confirmation, or check or require credits for `get_chat_conversations`, `get_chat_conversation`, `get_chat_conversation_events`, public key lookups, `add_conversation_keys`, `send_chat_message`, typing indicators, or marking a conversation read.
The live payload:
@@ -347,7 +347,7 @@ When they ask what they can do, re-fetch `{credits}`, say how many they have lef
## X Chat
-X Chat is free in Grok Bot. Do not estimate a cost, ask for confirmation, or check or require credits.
+X Chat is free for this plugin. Do not estimate a cost, ask for confirmation, or check or require credits.
MCP holds OAuth and raw events. Local `xchat_lite.py` unlocks Juicebox, decrypts, and encrypts. Never decrypt on the server. Never paste PIN, juicebox tokens, private keys, or raw key blobs into chat.
diff --git a/third_party/x/skills/x-api-mcp-guide/references/pricing.md b/third_party/x/skills/x-api-mcp-guide/references/pricing.md
index 9f979754..e28341f0 100644
--- a/third_party/x/skills/x-api-mcp-guide/references/pricing.md
+++ b/third_party/x/skills/x-api-mcp-guide/references/pricing.md
@@ -124,7 +124,7 @@ Reference prices for cost estimates. May drift; the live endpoint https://consol
- Stream connection & management: stream rules, webhook & Account Activity configuration, replay
- Compliance jobs, connections, usage endpoints
- Chat/DM sends, communities create, notes
-- X Chat reads, free in Grok Bot: `GET /2/chat/conversations` · `/2/chat/conversations/:id` · `/2/chat/conversations/:id/events`
+- X Chat is free for this plugin. Reads: `GET /2/chat/conversations` · `/2/chat/conversations/:id` · `/2/chat/conversations/:id/events`
## Cost-saving tips