Document X credits endpoint in the MCP guide

[vaulpannx]

Summary

• Teach the X MCP guide to fetch get_usage_credits (GET /2/usage/credits) on connect, at session start when X calls are needed, and when the user asks what they can do.
• Include the dollar balance and 2–3 fitting ideas in the on-connect capabilities message; suggest work from budget tiers ($0 through $1,000+).
• If a job would exceed the remaining balance, offer a cheaper alternative and send the user to https://console.x.com.

Test plan

• Connect the X plugin and confirm the agent fetches credits before the capabilities message, quotes total_balance in dollars, and suggests 2–3 ideas from the matching budget row.
• Ask “what can I do?” mid-session and confirm it re-fetches the balance before suggesting.
• With a low balance, ask for a large search/pagination job and confirm it does not run it, offers a cheaper alternative, and points to https://console.x.com.

Made with Cursor