Skip to content

Rebuild the X MCP guide around free X tools - #738

Merged
vaulpannx merged 4 commits into
cursor:mainfrom
vaulpannx:pvann/x-skill-rebuild
Oct 20, 2026
Merged

vaulpannx merged 4 commits into
cursor:mainfrom
vaulpannx:pvann/x-skill-rebuild

Conversation

@vaulpannx

@vaulpannx vaulpannx commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • X tools are included in Grok Bot through the X connector. The guide no longer estimates costs, checks credits, asks for cost confirmation, or states a balance on connect.
  • Webhooks and X Activity API subscriptions are the only billed endpoints. Before creating or changing one, the agent checks get_usage_credits, gives the balance and per-event delivery prices, and waits for a yes. "Out of credits" applies only there.
  • Rebuilt the guide from scratch (690 → 332 lines): one billing section, one missing-scopes section for Chat, calls, and livestreams, and a tighter X Chat flow. Removed references/pricing.md, the starter-credits table, and the budget tiers.
  • Opening a message request now uses only the paged events, so the preview isn't decrypted twice.
  • Bump to 2.9.0, changelog entry, and a README billing line.

Test plan

  • Connect X: capabilities message with no balance, cost, or credits copy.
  • Large search or multi-page timeline: runs without a cost estimate or confirmation.
  • Ask to set up a webhook or XAA subscription: agent checks get_usage_credits, quotes balance and per-event prices, waits for a yes.
  • Ask "how many credits do I have": balance plus "only used for webhooks and XAA".
  • Chat, calls, livestreams: same behavior as 2.8.1 (unlock and saved key, unread, message requests, scheduling, stream-key handling); missing feature tools give the reconnect line, not error 2.

Made with Cursor


Note

Low Risk
Changes are limited to plugin metadata, README, changelog, and agent skill documentation with no runtime code paths.

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

X tools are included in Grok Bot, so cost estimates, credit checks, and budget tiers only apply to webhooks and X Activity API subscriptions now. The guide is rewritten from scratch at about half the length, and the pricing reference is removed.

Co-authored-by: Cursor <[email protected]>

@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 1ba0bc8. Configure here.

Comment thread third_party/x/skills/x-api-mcp-guide/SKILL.md Outdated
Unlocking as soon as the PIN arrives meant a later Yes never saved the key.

Co-authored-by: Cursor <[email protected]>
vaulpannx and others added 2 commits October 20, 2026 13:06
Every X tool is treated as free, so a credits error is an unexpected X error rather than a prompt to buy credits.

Co-authored-by: Cursor <[email protected]>
Search points at search_posts_all with start_time, the reading table names actual tools and adds trends, missing public-read tools on the user's connection aren't an error, and unlock checks the saved key and stored PIN before asking.

Co-authored-by: Cursor <[email protected]>
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