x-developer 2.4.12 → 2.4.16

package/skills/x-twitter-scraper/references/api-endpoints.md

@@ -6,7 +6,6 @@ All requests require the `x-api-key` header. All responses are JSON. HTTPS only.
 
 ## Table of Contents
 
-- [Account](#account)
 - [API Keys](#api-keys)
 - [Monitors](#monitors)
 - [Events](#events)
@@ -20,8 +19,6 @@ All requests require the `x-api-key` header. All responses are JSON. HTTPS only.
 - [Compose](#compose)
 - [Drafts](#drafts)
 - [Tweet Style Cache](#tweet-style-cache)
-- [Account Identity](#account-identity)
-- [Subscribe](#subscribe)
 - [X Accounts (Connected)](#x-accounts-connected)
 - [X Write](#x-write)
 - [Credits](#credits)
@@ -29,55 +26,6 @@ All requests require the `x-api-key` header. All responses are JSON. HTTPS only.
 
 ---
 
-## Account
-
-### Get Account
-
-```
-GET /account
-```
-
-Returns account status, monitor billing details, credit balance, and X identity.
-
-**Response:**
-```json
-{
-  "plan": "active",
-  "monitorsAllowed": 9007199254740991,
-  "monitorsUsed": 1,
-  "monitorBilling": {
-    "activeDailyEstimate": "500",
-    "activeHourlyBurn": "21",
-    "creditsPerActiveMonitorDay": "500",
-    "creditsPerActiveMonitorHour": "21",
-    "eventsIncluded": true,
-    "instantCheckIntervalSeconds": 1,
-    "unlimitedSlots": true
-  },
-  "creditInfo": {
-    "balance": "77000",
-    "lifetimePurchased": "140000",
-    "lifetimeUsed": "63000",
-    "autoTopupEnabled": false,
-    "autoTopupAmountDollars": 10,
-    "autoTopupThreshold": "50000"
-  },
-  "xUsername": "elonmusk"
-}
-```
-
-### Update Account
-
-```
-PATCH /account
-```
-
-Update account locale. Session auth only (not API key).
-
-**Body:** `{ "locale": "en" | "tr" | "es" }`
-
----
-
 ## API Keys
 
 Session auth only. These endpoints do not accept API key auth.
@@ -171,6 +119,18 @@ DELETE /monitors/{id}
 
 Stops tracking and deletes all associated data.
 
+### Keyword Monitors
+
+```
+GET /monitors/keywords
+POST /monitors/keywords
+GET /monitors/keywords/{id}
+PATCH /monitors/keywords/{id}
+DELETE /monitors/keywords/{id}
+```
+
+Create and manage ongoing keyword monitors. Treat these as persistent resources: confirm the keyword query, event delivery plan, and ongoing cost before creating or enabling one.
+
 ---
 
 ## Events
@@ -486,10 +446,10 @@ Returns full tweet with engagement metrics (likes, retweets, replies, quotes, vi
 ### Get Article
 
 ```
-GET /x/articles/{id}
+GET /x/articles/{tweetId}
 ```
 
-Retrieve the full content of an X Article (long-form post) by tweet ID. Returns title, body text with block-level formatting, cover image, inline images, and engagement metrics. Metered.
+Retrieve the full content of an X Article (long-form post) by numeric tweet ID. If the user gives an article URL, use the final status ID as `tweetId`. Returns title, body text with block-level formatting, cover image, inline images, and engagement metrics. Metered.
 
 **Response:**
 ```json
@@ -523,10 +483,19 @@ Returns tweet info with optional engagement metrics (likeCount, retweetCount, re
 ### Get User
 
 ```
-GET /x/users/{username}
+GET /x/users/{id}
+```
+
+Returns profile info. `id` accepts either an X username without `@` or a numeric user ID. Fields `id`, `username`, `name` are always present. All other fields (`description`, `followers`, `following`, `verified`, `profilePicture`, `location`, `createdAt`, `statusesCount`) are optional and omitted when unavailable.
+
+### Batch & Search Users
+
+```
+GET /x/users/batch?ids=44196397,783214
+GET /x/users/search?q=founder
 ```
 
-Returns profile info. Fields `id`, `username`, `name` are always present. All other fields (`description`, `followers`, `following`, `verified`, `profilePicture`, `location`, `createdAt`, `statusesCount`) are optional and omitted when unavailable.
+Batch lookup accepts up to 100 comma-separated numeric user IDs. User search returns matching profiles and may include a pagination cursor.
 
 ### Check Follower
 
@@ -544,6 +513,14 @@ GET /x/users/{id}/tweets
 
 Get a user's recent tweets by user ID. Metered (1 credit/tweet).
 
+### Batch Tweets
+
+```
+GET /x/tweets?ids=1893456789012345678,1893456789012345679
+```
+
+Get multiple tweets by comma-separated tweet IDs. Maximum 100 IDs.
+
 ### Get User Likes
 
 ```
@@ -568,6 +545,28 @@ GET /x/tweets/{id}/favoriters
 
 Get users who liked a tweet. Metered (1 credit/result).
 
+### Tweet Conversation & Engagement Lists
+
+```
+GET /x/tweets/{id}/quotes
+GET /x/tweets/{id}/replies
+GET /x/tweets/{id}/retweeters
+GET /x/tweets/{id}/thread
+```
+
+Read quote tweets, replies, retweeters, or the conversation thread for a tweet. These are paginated read operations.
+
+### User Social Graph Reads
+
+```
+GET /x/users/{id}/followers
+GET /x/users/{id}/following
+GET /x/users/{id}/mentions
+GET /x/users/{id}/verified-followers
+```
+
+Read followers, following, mentions, and verified followers for a username or numeric user ID. These are paginated read operations.
+
 ### Get Mutual Followers
 
 ```
@@ -576,6 +575,29 @@ GET /x/users/{id}/followers-you-know
 
 Get mutual followers (followers you know). Metered (1 credit/result).
 
+### X Lists
+
+```
+GET /x/lists/{id}/followers
+GET /x/lists/{id}/members
+GET /x/lists/{id}/tweets
+```
+
+Read list followers, members, or list timeline tweets by list ID.
+
+### X Communities
+
+```
+GET /x/communities/search
+GET /x/communities/tweets
+GET /x/communities/{id}/info
+GET /x/communities/{id}/members
+GET /x/communities/{id}/moderators
+GET /x/communities/{id}/tweets
+```
+
+Search communities and read community metadata, members, moderators, or tweets. Community writes are listed under X Write and require confirmation.
+
 ### Get Bookmarks
 
 ```
@@ -637,7 +659,7 @@ Download images, videos, and GIFs from tweets. Single or bulk (up to 50). Return
 ```json
 {
   "tweetId": "1893456789012345678",
-  "galleryUrl": "https://xquik.com/gallery/abc123",
+  "galleryUrl": "https://xquik.com/g/abc123",
   "cacheHit": false
 }
 ```
@@ -645,13 +667,13 @@ Download images, videos, and GIFs from tweets. Single or bulk (up to 50). Return
 **Response (bulk):**
 ```json
 {
-  "galleryUrl": "https://xquik.com/gallery/def456",
+  "galleryUrl": "https://xquik.com/g/def456",
   "totalTweets": 3,
   "totalMedia": 7
 }
 ```
 
-First download is metered. Subsequent requests for the same tweet return cached URLs at no cost (`cacheHit: true`). All downloads are saved to the gallery at `https://xquik.com/gallery`.
+First download is metered. Subsequent requests for the same tweet return cached URLs at no cost (`cacheHit: true`). All downloads are saved to shareable gallery pages under `https://xquik.com/g/{token}`.
 
 Returns `400 no_media` if the tweet has no downloadable media. Returns `400 too_many_tweets` if bulk array exceeds 50 items.
 
@@ -662,10 +684,11 @@ Returns `400 no_media` if the tweet has no downloadable media. Returns `400 too_
 ### List Trends
 
 ```
+GET /x/trends?woeid=1&count=30
 GET /trends?woeid=1&count=30
 ```
 
-Metered. Subscription required. Cached, refreshes every 15 minutes.
+Metered. Plan access required. `/trends` is an alias of `/x/trends`. Cached, refreshes every 15 minutes.
 
 **WOEIDs:** 1 (Worldwide), 23424977 (US), 23424975 (UK), 23424969 (Turkey), 23424950 (Spain), 23424829 (Germany), 23424819 (France), 23424856 (Japan), 23424848 (India), 23424768 (Brazil), 23424775 (Canada), 23424900 (Mexico).
 
@@ -913,9 +936,9 @@ List all cached tweet style profiles. Max 200 results, ordered by fetch date.
 
 ### Save Custom Style
 
-`PUT /styles/{username}`
+`PUT /styles/{id}`
 
-Save a custom style profile from tweet texts. Free, no usage cost. Replaces existing style if one exists with the same label.
+Save a custom style profile from tweet texts. Free, no usage cost. The body `label` controls the saved style label and replaces any existing style with that label.
 
 **Body:**
 
@@ -932,9 +955,9 @@ Save a custom style profile from tweet texts. Free, no usage cost. Replaces exis
 
 ### Get Cached Style
 
-`GET /styles/{username}`
+`GET /styles/{id}`
 
-Get a cached style profile with full tweet data.
+Get a cached style profile with full tweet data. `id` is the cached style label or username.
 
 **Response (200):** Full style object with `tweets` array.
 
@@ -944,9 +967,9 @@ Get a cached style profile with full tweet data.
 
 ### Delete Cached Style
 
-`DELETE /styles/{username}`
+`DELETE /styles/{id}`
 
-Delete a cached style. Returns `204 No Content`.
+Delete a cached style by label or username. Returns `204 No Content`.
 
 **Errors:** `404 style_not_found`
 
@@ -980,9 +1003,9 @@ Compare two cached tweet style profiles side by side.
 
 ### Analyze Performance
 
-`GET /styles/{username}/performance`
+`GET /styles/{id}/performance`
 
-Get live engagement metrics for cached tweets. **Consumes API usage credits.**
+Get live engagement metrics for cached tweets for a cached style label or username. **Consumes API usage credits.**
 
 **Response (200):**
 
@@ -1009,57 +1032,22 @@ Get live engagement metrics for cached tweets. **Consumes API usage credits.**
 
 ---
 
-## Account Identity
-
-### Set X Identity
-
-`PUT /account/x-identity`
-
-Link your X username to your Xquik account. Required for own-account detection in style analysis.
-
-**Request body:**
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| `username` | string | Yes | Your X username (without @) |
-
-**Response (200):**
-
-```json
-{
-  "success": true,
-  "xUsername": "elonmusk"
-}
-```
-
-**Errors:** `400 invalid_input`
+## X Accounts (Connected)
 
----
+Manage connected X accounts for confirmation-gated write actions. All endpoints are free (no usage cost).
 
-## Subscribe
+**Connecting or re-authenticating an X account is done by the user in the Xquik dashboard**, not via this skill. The skill never handles X login material. The agent should direct the user to the dashboard account page when a new account needs to be connected or an existing session needs to be refreshed.
 
-### Get Subscription Link
+The OpenAPI surface includes dashboard-owned account connection routes:
 
 ```
-POST /subscribe
-```
-
-Returns a checkout URL for subscribing or managing the subscription. If already subscribed, returns the billing portal URL. Use only after the user confirms the plan or billing action.
-
-**Response:**
-```json
-{
-  "url": "https://checkout.xquik.com/..."
-}
+POST /x/accounts
+POST /x/account-connection-challenges/{id}/submit
+POST /x/accounts/{id}/reauth
+POST /x/accounts/bulk-retry
 ```
 
----
-
-## X Accounts (Connected)
-
-Manage connected X accounts for confirmation-gated write actions. All endpoints are free (no usage cost).
-
-**Connecting or re-authenticating an X account is done by the user in the Xquik dashboard** at [xquik.com/dashboard/account](https://xquik.com/dashboard/account), not via this skill. The skill never handles X login material. The agent should direct the user to the dashboard when a new account needs to be connected or an existing session needs to be refreshed.
+Do not call these from this skill. They are listed here only so the skill docs match the public API surface and keep the dashboard-only boundary explicit.
 
 ### List X Accounts
 
@@ -1102,12 +1090,12 @@ POST /x/tweets
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
 | `account` | string | Yes | Connected X username or account ID |
-| `text` | string | Yes | Tweet text (280 chars, or 25,000 if `is_note_tweet` is true) |
+| `text` | string | No | Tweet text (280 chars, or 25,000 if `is_note_tweet` is true). Required unless `media` is provided |
 | `reply_to_tweet_id` | string | No | Tweet ID to reply to |
 | `attachment_url` | string | No | URL to attach as a card |
 | `community_id` | string | No | Community ID to post into |
 | `is_note_tweet` | boolean | No | Long-form note tweet (up to 25,000 chars) |
-| `media_ids` | string[] | No | Media IDs from `POST /x/media` (max 4 images or 1 video) |
+| `media` | string[] | No | Public image URLs to attach (max 4). `POST /x/media` returns `mediaUrl` values for this field |
 
 **Response:** `{ tweetId, success: true }`
 
@@ -1147,6 +1135,14 @@ POST /x/tweets/{id}/retweet
 
 **Body:** `{ "account": "username" }`
 
+### Unretweet
+
+```
+DELETE /x/tweets/{id}/retweet
+```
+
+**Body:** `{ "account": "username" }`
+
 ### Follow User
 
 ```
@@ -1238,7 +1234,7 @@ POST /x/media
 
 **Body:** FormData with `account` (required), `file` (required), and `is_long_video` (optional boolean). Alternatively, JSON body with `account` (required) and `url` (required, direct media URL) for URL-based upload.
 
-**Response:** Returns a media ID to pass in `media_ids` when creating a tweet.
+**Response:** Returns `mediaId`, `mediaUrl`, and `success`. Pass `mediaUrl` in the `media` array when creating a tweet.
 
 ### Create Community
 
@@ -1274,43 +1270,25 @@ DELETE /x/communities/{id}/join
 
 **Body:** `{ "account": "username" }`
 
----
-
-## Credits
-
-### Get Credit Balance
-
-```
-GET /credits
-```
-
-Get credit balance, lifetime purchased/used, and auto top-up status. Free.
-
-### Top Up Credits
+### Get Write Action Status
 
 ```
-POST /credits/topup
+GET /x/write-actions/{id}
 ```
 
-Get a checkout URL to purchase credits ($10 minimum). Use only after the user confirms the exact amount.
-
-### Get Top-Up Status
+Check a pending write action by the ID returned from an earlier write response.
 
-```
-GET /credits/topup/status
-```
+---
 
-Poll a checkout session after starting a credit top-up. Query: `session_id`. Free.
+## Credits
 
-### Quick Top Up
+### Get Credit Balance
 
 ```
-POST /credits/quick-topup
+GET /credits
 ```
 
-Charge a saved payment method for credits after the user confirms the exact amount. Body: `{ "dollars": 10 }` ($10 minimum, $500 maximum). Free endpoint, but it can initiate a confirmed card charge.
-
-Responses include `{ "outcome": "charged", "credits": "...", "balance": "..." }`, `{ "outcome": "no_payment_method" }`, or `{ "outcome": "requires_action", "clientSecret": "..." }`.
+Get credit balance and lifetime usage fields. Free. Plan and credit changes are dashboard-only and intentionally omitted from this installable skill.
 
 ---
 
@@ -1381,8 +1359,8 @@ Add a message to an existing ticket.
 | 400 | `webhook_inactive` | Webhook is disabled (test-webhook only) |
 | 401 | `unauthenticated` | Missing or invalid API key |
 | 403 | `account_needs_reauth` | X account session expired; use dashboard re-auth flow |
-| 402 | `no_subscription` | No active subscription |
-| 402 | `subscription_inactive` | Subscription is not active |
+| 402 | `no_subscription` | No active plan |
+| 402 | `subscription_inactive` | Plan is not active |
 | 402 | `no_credits` | No credit balance record exists |
 | 402 | `insufficient_credits` | Credit balance is too low |
 | 403 | `api_key_limit_reached` | API key limit reached (100 max) |

package/skills/x-twitter-scraper/references/mcp-setup.md

@@ -8,7 +8,9 @@ Connect AI agents and IDEs to Xquik via the Model Context Protocol. The MCP serv
 | Endpoint | `https://xquik.com/mcp` |
 | Auth header | `x-api-key` |
 
-> **Security:** Use a scoped, revocable API key - not your primary account key. Where your platform supports environment variable interpolation (e.g., `${XQUIK_API_KEY}`), prefer that over hardcoding. Rotate keys periodically from the [dashboard](https://dashboard.xquik.com/account). Never commit API keys to version control.
+> **Security:** Use a scoped, revocable API key - not your primary account key. Where your platform supports environment variable interpolation (e.g., `${XQUIK_API_KEY}`), prefer that over hardcoding. Rotate keys periodically from the Xquik dashboard account page. Never commit API keys to version control.
+
+Use native HTTP MCP clients or OAuth connectors only. Do not proxy Xquik API keys through third-party local bridge packages, local proxy commands, or command-line adapters.
 
 ## Claude.ai (Web)
 
@@ -16,36 +18,9 @@ Claude.ai supports MCP connectors natively via OAuth. Add Xquik as a connector f
 
 ## Claude Desktop
 
-Claude Desktop only supports stdio transport, so it needs a local stdio-to-HTTP bridge. The recommended setup avoids runtime package fetches: **install the bridge globally first, then invoke the pinned binary directly.**
-
-> **About `mcp-remote`:** [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) is an open-source stdio-to-HTTP bridge (MIT license, [source on GitHub](https://github.com/geelen/mcp-remote)) maintained by the MCP ecosystem. It translates stdio to StreamableHTTP - it does not run user code, access your filesystem, or modify your system. Always pin the version (`@0.1.38`) and audit the package on npm before installing.
-
-### Step 1: Install the bridge globally (one-time, audited)
-
-```bash
-npm install -g mcp-remote@0.1.38
-```
-
-### Step 2: Add to `claude_desktop_config.json`
-
-```json
-{
-  "mcpServers": {
-    "xquik": {
-      "command": "mcp-remote",
-      "args": [
-        "https://xquik.com/mcp",
-        "--header",
-        "x-api-key:${XQUIK_API_KEY}"
-      ]
-    }
-  }
-}
-```
-
-> Set the `XQUIK_API_KEY` environment variable before launching Claude Desktop, or replace `${XQUIK_API_KEY}` with your actual API key.
+Claude.ai (web) is the recommended Claude client because it supports Xquik via OAuth in the hosted UI. Avoid local bridge setups that pass API keys in command-line arguments; local process listings can expose argv values.
 
-> **Prefer a hosted option?** Claude.ai (web) supports Xquik natively via OAuth - see the section above. No local bridge required.
+For desktop workflows, use Claude Code, Cursor, VS Code, Windsurf, OpenCode, or another HTTP MCP client that stores headers in a config file or secure settings store.
 
 ## Claude Code
 
@@ -182,7 +157,7 @@ The MCP server (v2) at `https://xquik.com/mcp` provides 2 structured API tools:
 | `explore` | Search the API endpoint catalog (read-only, no network calls) | Free |
 | `xquik` | Send confirmed Xquik API requests | Varies by endpoint |
 
-The agent sends structured API requests through the MCP server, which handles authentication and request routing within the same first-party infrastructure as the REST API. All 100+ REST API endpoints across 10 categories are accessible. Private reads, writes, persistent resources, and billing flows require explicit user confirmation before use.
+The agent sends structured API requests through the MCP server, which handles authentication and request routing within the same first-party infrastructure as the REST API. All 100+ REST API endpoints across 10 categories are accessible. Private reads, writes, and persistent resources require explicit user confirmation before use. Plan and credit changes are dashboard-only.
 
 ## After Setup
 
@@ -191,10 +166,9 @@ The agent sends structured API requests through the MCP server, which handles au
 | Workflow | Steps (via `xquik` tool) |
 |----------|--------------------------|
 | Set up real-time alerts | Confirm target, event types, destination, and ongoing cost -> `POST /monitors` -> `POST /webhooks` -> `POST /webhooks/{id}/test` |
-| Run a giveaway | `GET /account` -> `POST /draws` |
+| Run a giveaway | Confirm tweet URL and rules -> `POST /draws` |
 | Bulk extraction | `POST /extractions/estimate` -> `POST /extractions` -> `GET /extractions/{id}` |
 | Compose optimized tweet | `POST /compose` (step=compose -> refine -> score) |
-| Billing checkout | Confirm plan or amount -> `POST /subscribe` or `POST /credits/topup` |
 
 ### Example Prompts
 
@@ -211,4 +185,4 @@ Try these with your AI agent:
 - "What's trending on Hacker News today?"
 - "Help me write a tweet about launching my product"
 - "Set up a webhook at https://my-server.com/events for new tweets after I confirm the destination"
-- "What plan am I on and how much have I used?"
+- "What is my current credit balance?"

package/skills/x-twitter-scraper/references/mcp-tools.md

@@ -54,7 +54,7 @@ Apply these gates before using `xquik`:
 | Direct messages | Show sender, recipient, and message text. Never send bulk or automatic DMs. |
 | Persistent resources | Create monitors and webhooks only when the user explicitly asks for ongoing delivery. Show target, event types, URL, and ongoing cost before creation. |
 | Private reads | Confirm before fetching DMs, bookmarks, notifications, or home timeline. Do not forward returned private data to other tools without consent. |
-| Billing or payments | Do not call checkout, top-up, or MPP payment endpoints unless the user explicitly asks and confirms the exact amount. |
+| Plan and credit changes | Dashboard-only. The agent may read credit balance, but must not start account changes. |
 | X account login | Never ask for or submit X login material. Account connection and re-authentication happen in the dashboard. |
 
 ```typescript
@@ -75,26 +75,27 @@ Use `explore` first to find endpoints, then `xquik` to call them.
 | Goal | Endpoint (via `xquik`) |
 |------|------------------------|
 | Single tweet by ID or URL | `GET /api/v1/x/tweets/{id}` |
-| Full X Article by tweet ID | `GET /api/v1/x/articles/{id}` |
+| Full X Article by tweet ID | `GET /api/v1/x/articles/{tweetId}` |
 | Search tweets by keyword/hashtag | `GET /api/v1/x/tweets/search?q=...` |
-| User profile, bio, follower counts | `GET /api/v1/x/users/{username}` |
+| User profile, bio, follower counts | `GET /api/v1/x/users/{id}` (`id` can be username or numeric ID) |
 | Download media from tweets | `POST /api/v1/x/media/download` |
 | Check follow relationship | `GET /api/v1/x/followers/check?source=A&target=B` |
 | Trending topics by region (X) | `GET /api/v1/trends?woeid=1` |
 | Trending news from 7 sources | `GET /api/v1/radar` (via `xquik` tool) |
 | Activity from monitored accounts | `GET /api/v1/events` |
-| Credit balance, plan, monitor billing | `GET /api/v1/account` |
+| Credit balance | `GET /api/v1/credits` |
 | Monitor an X account | `POST /api/v1/monitors` (persistent; confirmation required) |
 | Set up webhook notifications | `POST /api/v1/webhooks` (persistent; confirmation required) |
 | Run a giveaway draw | `POST /api/v1/draws` |
 | Compose/draft a tweet | `POST /api/v1/compose` (3-step: compose, refine, score) |
-| Link your X username | `PUT /api/v1/account/x-identity` |
+| Link your X username | Use the Xquik dashboard account settings |
 | Analyze tweet style | `POST /api/v1/styles` |
-| Get cached style | `GET /api/v1/styles/{username}` |
+| Get cached style | `GET /api/v1/styles/{id}` |
 | Compare two styles | `GET /api/v1/styles/compare` |
 | Post a tweet | `POST /api/v1/x/tweets` (confirmation required) |
 | Like/unlike a tweet | `POST`/`DELETE /api/v1/x/tweets/{id}/like` (confirmation required) |
 | Retweet | `POST /api/v1/x/tweets/{id}/retweet` (confirmation required) |
+| Unretweet | `DELETE /api/v1/x/tweets/{id}/retweet` (confirmation required) |
 | Follow/unfollow | `POST`/`DELETE /api/v1/x/users/{id}/follow` (confirmation required) |
 | Send a DM | `POST /api/v1/x/dm/{userId}` (confirmation required) |
 | Upload media | `POST /api/v1/x/media` (confirmation required before use in a post or profile change) |
@@ -105,6 +106,10 @@ Use `explore` first to find endpoints, then `xquik` to call them.
 | Get user's media tweets | `GET /api/v1/x/users/{id}/media` |
 | Get tweet favoriters (who liked) | `GET /api/v1/x/tweets/{id}/favoriters` |
 | Get mutual followers | `GET /api/v1/x/users/{id}/followers-you-know` |
+| Get followers/following | `GET /api/v1/x/users/{id}/followers` / `GET /api/v1/x/users/{id}/following` |
+| Get tweet quotes/replies/retweeters/thread | `GET /api/v1/x/tweets/{id}/quotes`, `/replies`, `/retweeters`, `/thread` |
+| Read X Lists | `GET /api/v1/x/lists/{id}/members`, `/followers`, `/tweets` |
+| Read X Communities | `GET /api/v1/x/communities/search`, `/tweets`, `/{id}/info`, `/{id}/members`, `/{id}/moderators`, `/{id}/tweets` |
 | Get bookmarks | `GET /api/v1/x/bookmarks` (private; confirmation required) |
 | Get bookmark folders | `GET /api/v1/x/bookmarks/folders` |
 | Get notifications | `GET /api/v1/x/notifications` (private; confirmation required) |
@@ -119,10 +124,10 @@ Use `POST /api/v1/extractions` ONLY for bulk data that simpler endpoints cannot
 | Workflow | Steps |
 |----------|-------|
 | **Set up real-time alerts** | Confirm target, event types, destination, and cost -> `POST /monitors` -> `POST /webhooks` -> `POST /webhooks/{id}/test` |
-| **Run a giveaway** | `GET /account` -> `POST /draws` |
+| **Run a giveaway** | Confirm tweet URL and rules -> `POST /draws` |
 | **Bulk extraction** | `POST /extractions/estimate` -> `POST /extractions` -> `GET /extractions/{id}` |
 | **Compose optimized tweet** | `POST /compose` (step=compose -> refine -> score) |
-| **Analyze tweet style** | `POST /styles` -> `GET /styles/{username}` -> `POST /compose` with `styleUsername` |
+| **Analyze tweet style** | `POST /styles` -> `GET /styles/{id}` -> `POST /compose` with `styleUsername` |
 | **Post a tweet** | `GET /x/accounts` -> `POST /x/tweets` with `account` + `text` |
 | **Get trending news** | `GET /radar` (free, all 7 sources, via `xquik` tool) -> `POST /compose` with trending topic |
 | **Open support ticket** | `POST /support/tickets` -> `GET /support/tickets/{id}` |
@@ -135,10 +140,10 @@ Use `POST /api/v1/extractions` ONLY for bulk data that simpler endpoints cannot
 | Using `compose` when user wants to send a tweet | `POST /compose` is for drafting. Use `POST /x/tweets` to send |
 | Using `POST /x/tweets` when user wants help writing | Use the 3-step compose flow instead |
 | Falling back to web search when API call fails | Use free data already fetched (radar, styles, compose). Never discard it |
-| Not checking subscription before paid calls | Attempt the requested call. On 402, explain the billing issue and ask before any checkout or top-up action |
+| Not checking account access before paid calls | Attempt the requested call. On 402, explain the account state and direct the user to the dashboard |
 | Passing API keys in code | Auth is injected automatically. Never include keys |
 | Using `explore` for API calls | `explore` is read-only spec search. Use `xquik` for actual API calls |
-| Looking up follow/DM by username | Follow and DM endpoints need numeric user ID. Look up via `GET /x/users/{username}` first |
+| Looking up follow/DM by username | Follow and DM endpoints need numeric user ID. Look up via `GET /x/users/{id}` first; that route accepts usernames and IDs |
 
 ## Unsupported Operations
 
@@ -154,4 +159,4 @@ These are NOT available via the MCP server:
 ## Cost Reference
 
 - **Free**: account info, compose (all steps), styles (cached lookup/save/delete/compare), drafts, radar (via `xquik` tool, all 7 sources), support tickets, credits balance check, webhook management
-- **Credit or subscription required**: tweet search, user lookup, tweet lookup, follow check, media download (first only, cached free), extractions, draws, active monitors, style analysis (X API refresh), performance analysis, trends, and confirmation-gated write actions (tweet, like, retweet, follow, DM, profile, media upload, communities)
+- **Credits or plan required**: tweet search, user lookup, tweet lookup, follow check, media download (first only, cached free), extractions, draws, active monitors, style analysis (X API refresh), performance analysis, trends, and confirmation-gated write actions (tweet, like, retweet, follow, DM, profile, media upload, communities)