X MCP guide 是一份面向 Cursor 的 X（推特）插件使用指南，用于在用户连接 X 插件或任何 X MCP 后、调用任何 X 工具前提供统一的操作规范。它本身不是独立工具，而是指导代理如何正确使用 X 连接与相关工具的行为准则。
用途 该指南用于规范代理在 X 插件场景下的行为：确认工具是否存在、按正确顺序连接、查询额度、处理错误、估算成本，并在合适时机向用户展示能力说明。它强调在核心错误发生时立即停止，先说明简单问题，再给出下一步，不解释注册机制、计费内部逻辑或按量付费细节。
主要能力 指南覆盖以下方面：
- 连接顺序：先确认 X 工具存在，再检查登录状态，然后调用 get_users_me 与 get_usage_credits，缓存用户 id 与额度，最后发送连接成功消息。
- 额度查询：通过 get_usage_credits（GET /2/usage/credits，免费）获取 data.total_balance 作为 {credits}，用于预算与约 $0 判断，并始终告知用户剩余额度。
- 内置公开读取：当宿主（如 Grok Bot）声明公开 X 读取无需 X 连接时，读取公开帖子、用户、搜索、趋势和新闻不消耗用户额度，也不应要求连接或检查额度。
- 三类核心错误：1）登录失败（401、未登录、登录循环）；2）账户未就绪（已连接但无工具、403 未注册等）；3）额度耗尽（计费请求被阻止）。每类错误都有对应的固定话术与后续动作。
- X Chat 权限：聊天工具缺失或 403 时，需重新连接并批准消息权限，Chat PIN 仅通过 secret-request 获取，不得在聊天中粘贴。
- 成本估算：每次 X 调用都可能计费，需先估算；低于约 $0.25 且额度足够可直接执行，超过约 $0.25 或涉及分页/批量任务需先给出单行估算并等待确认。
- 字段与分页：建议请求 created_at、public_metrics、author_id、lang、conversation_id 等字段，使用 meta.next_token 分页，并优先使用近期计数。
- 搜索运算符：支持 from:、to:、@handle、#tag、精确短语、url:、lang:、-is:retweet、-is:reply、is:verified、has:images、has:video_link、has:links、conversation_id: 等，近期查询上限 512 字符，全归档 1,024 字符。
使用方式 在 Cursor 中安装该插件后，当用户连接 X 插件或任何 X MCP 时，代理应始终先阅读本指南。指南要求代理在会话开始时确认工具存在，调用 get_users_me 与 get_usage_credits，缓存 {me} 与 {credits}，然后根据额度情况执行用户请求或发送连接成功消息。指南还规定了错误处理、成本确认、分页与字段选择等具体步骤。
适用场景 适用于在 Cursor 中使用 X 插件的所有场景，包括读取用户资料、主页时间线、帖子、提及、书签、搜索、新闻与趋势，以及 X Chat 的读取与回复。也适用于处理连接失败、账户未就绪、额度不足、速率限制、API 故障等异常情况。
限制 指南明确禁止以下行为：不得要求用户提供 Bearer token、API key 或密码；不得通过浏览器或本机代用户登录 X；不得在额度未确认前引导用户购买额度；不得对 401、403 注册、额度阻止或工具缺失进行无变化重试；不得将 get_usage_credits 缺失单独视为账户未就绪；不得将缺失工具视为付费引导。此外，发帖功能不受支持，X Chat 需要额外权限，Chat PIN 不得在聊天中粘贴。