skills.rest
cursor
cursorOFFICIAL
Explore all skills by this author →
WebsiteGitHub

X MCP guide

Governs X MCP tool usage with credit checks, cost estimates, and error handling.

6.6k|542|Updated Jan 23, 2026
Search Tags:#mcp#credits#cost estimation#Twitter#X API#Error handling#oAuth
One-click install
npx skills add https://github.com/cursor/plugins --skill x-mcp-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: X MCP guide
Source: https://github.com/cursor/plugins/tree/main/third_party/x/skills/x-api-mcp-guide
Command: npx skills add https://github.com/cursor/plugins --skill x-mcp-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Connecting to the X (Twitter) API through an MCP plugin involves credit balances, per-call billing, and confusing error states like missing tools or enrollment failures. This Skill ensures the agent checks credits before spending, estimates costs before expensive calls, and responds to sign-in, setup, and billing errors with the correct user-facing guidance instead of retry loops or premature paywall messages.

Core Features & Use Cases

  • Connect and session bootstrap: Verifies X tools exist, fetches the user profile and credit balance via get_usage_credits, and sends the correct onboarding message based on remaining balance.
  • Cost-aware API usage: Estimates the dollar cost of every X call using a pricing reference and live pricing endpoint, confirms with the user before anything over ~$0.25, and suggests budget-appropriate tasks.
  • Structured error handling: Maps sign-in failures, missing-tools setup failures, out-of-credits blocks, rate limits, and 5xx outages to specific quoted responses without retry loops.
  • Use Case: A user connects the X plugin and asks to research a topic. The agent confirms tools exist, reads their $20 balance, suggests a small search within budget, estimates the cost, and proceeds only after confirmation.

Quick Start

Connect the X plugin in this chat and ask the agent to look up a post or search a topic, and it will check your credits and estimate costs first.

Frequently Asked Questions about X MCP guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my X API credit balance before making calls?▼

Call the get_usage_credits tool, which wraps GET /2/usage/credits and is free. Read data.total_balance as the remaining dollar balance and use it for budgets and the zero-balance check before any billed request.

How much do X API calls cost through the MCP tools?▼

Reads are billed per object returned: posts cost $0.005 each and users $0.01 each, while writes like posting cost $0.015 per request. Tools like get_users_me, get_usage_credits, liking users, and bookmark folders are free.

Why are X tools missing after connecting the plugin?▼

A connected status with tools=0 or missing user-X-* tools means the developer account is not set up, which is a setup failure, not a paywall. The fix is to reinstall the X connection or create a developer account, Default Project, and App at console.x.com.

Can I use a Bearer token or API key instead of the X plugin?▼

No. This integration is OAuth-only through the X connector in the chat. The agent must not accept pasted Bearer tokens, API keys, or passwords, and cannot sign into X through a browser on the user's behalf.

When should the agent confirm costs before running X searches?▼

Any call estimated over roughly $0.25, pagination loops, or bulk lookups require a one-line cost estimate and explicit user confirmation. Requests under that threshold that fit the balance can proceed directly with small max_results values.

Related Skills

Explore More Software Engineering Skills→
PoyoPoakPoyoPoak

mcp-integration

Expose MCP servers as tools via standardized prefixes for Claude Code plugins.

Community
Advanced
ialamehialameh
2

seo-researcher

Analyze search trends, keywords, and user intent for SEO research.

Community
Advanced
GGEduGGEdu

cost-aware-llm-pipeline

Route LLM tasks to cost-appropriate models and track cumulative API spend.

Community
Advanced
taracodlabstaracodlabs
779

xitter

Automate posting, reading, and searching X content via x-cli or X API v2.

Official
Intermediate