Rewrite X MCP guide for auto-credits and connector-only auth

[vaulpannx]

Summary

• Developer accounts are auto-created and auto-credited. On connect, agents confirm X tools exist, fetch get_usage_credits, congratulate without a gift dollar amount, and always state remaining total_balance (including $0.00). Starter amounts by Cursor plan only if the user asks how much they received.
• Connected-but-no-tools (user-X-* not found, tools=0) is account-not-ready: reinstall the X connection, then console.x.com developer account / Default Project / App. 503s are an X outage, not the user's fault. Never buy-credits copy before a successful credits read.
• Edge cases: do not sign the user into X via GrokBot's browser, and do not ask for Bearer tokens — X plugin Connect only.

Test plan

• Connect X with tools present and free_balance > 0: congrats line has no gift amount; remaining balance is stated; 2–3 ideas match the budget row.
• Connect with total_balance ~$0: capabilities + You have $0.00 in credits + free lookups + console.x.com.
• Connected with tools=0 / user-X-* not found: account-not-ready copy (reinstall, then console project/app). Not a paywall.
• get_usage_credits 503 while get_users_me works: outage copy, not $0 and not error 2.
• Failing connector does not open x.com login in a browser or ask for a Bearer token.

Made with Cursor

[tcaldwell-x]

Intent matches the test plan: credits before any connect copy, no purchase CTA until a real $0 / over-budget read, tools=0 is setup not a paywall, 503 is an outage, Connect-only auth. Version bump, changelog, and the get_usage_credits pricing.md line all line up. Field names match the public GET /2/usage/credits docs (total_balance / free_balance / free_grants).

Not stamping. A few spots will produce the wrong user-facing copy — inline on the two that matter, nits below.

Nits

• Starter table: agents usually do not know the Cursor plan. Say only quote a row if you actually know it; do not guess. No Hobby / Business / other row.
• GrokBot-specific browser wording is agent-facing in a public Cursor plugin. The quoted user line is already generic; When/Do not should say this computer / the agent browser so non-GrokBot agents still skip browser login.
• Error 2 quoted copy: "clearing out and re-installing" is awkward.

Confirm hosted MCP actually exposes get_usage_credits under the current billing.write scope. If that tool is missing while other X tools work, today error 2 signatures will tell healthy accounts to create a Project and App.