Fetch recent public X/Twitter posts by named handle for monitoring, comparison, OSINT, and research.
Scored across 17 tools
The API-key path and the accountless x402 path are split into parallel tool families (get_task_status vs get_direct_task_status, get_result_preview vs get_direct_result_preview). Descriptions explicitly redirect between them, which mitigates the risk, but the near-duplicate naming makes misselection plausible in practice.
Most tools follow a consistent snake_case verb_noun pattern (create_crawl_task, get_task_status, list_crawl_tasks, cancel_task). A few deviations exist—get_direct_crawl_payment reads more like an action than a getter, and get_direct_result_preview is action-y—but the overall convention is predictable.
17 tools is borderline heavy. Much of the count comes from the parallel API-key vs accountless x402 variants (status, preview, payment) rather than distinct capabilities, so the surface feels inflated relative to the core workflow of create → poll → fetch results.
The lifecycle is well covered: service info, balance, preflight, quote, task creation, payment submission, polling (including a server-side wait), cancellation, listing, preview, sample result, and download URL. Both accountless x402 and API-key paths are handled, with no obvious dead ends.
Cancel a queued task by task_id. Side effects: changes task state. Xcatcher refunds cost_points when a queued task is successfully cancelled.
Inputs: task_id (required). Returns: result
Create a crawl task for one or more X (Twitter) usernames. Side effects: creates a new task AND consumes points.
If points are insufficient, upstream returns HTTP 402 with PAYMENT-REQUIRED (quote). This tool surfaces it as error.code=PAYMENT_REQUIRED with payment_required payload so agents can request spending approval, top up, then retry safely.
Modes:
normal: Fast latest-post snapshot at scale (fresh-feed monitoring). Optimized for high-throughput batch retrieval.
deep: Deeper per-user collection/enrichment (typically slower; higher resource usage). Use when you need more than a quick latest-post snapshot.
Performance note: Normal mode is optimized for a small latest-post snapshot per handle. Actual completeness and latency depend on X availability, upstream limits, and network conditions. Batching: For very large sets, split users into batches. Suggested upper bound per task: 500 users (configurable via MAX_USERS_PER_TASK).
Reliability:
Use idempotency_key to make retries safe (avoid duplicate charges).
After creation, poll get_task_status every 5–10s until has_result=true.
Then call get_result_download_url (download still requires the same Bearer token).
Inputs: users (required), mode, idempotency_key. Returns: result
Return the account attached to the current Bearer API key and its points balance. Use before creating a task to estimate whether an x402 top-up will be needed. Read-only.
Inputs: no named parameters. Returns: result
Create a request-bound x402 v2 payment requirement for an accountless crawl. Use this only for the accountless x402 path after preflight_crawl; API-key accounts use create_crawl_task instead. Normal requests use progressive batch pricing, so quote the complete deduplicated handle list together. This does not move funds. Return payment_required_b64 unchanged to an x402-compatible wallet/client; the live amount, asset, network, destination, and quoteId are authoritative.
Inputs: users (required), mode. Returns: result
Return structured JSON rows for a completed accountless paid crawl. Use this instead of get_result_preview for an accountless x402 task; API-key accounts use get_result_preview. Use offset for pagination; the task token is required and should be treated as a secret.
Inputs: task_id (required), task_token (required), limit, offset. Returns: result
Read an accountless paid crawl using its task_id and task-scoped token. Use this instead of get_task_status for an accountless x402 task. Poll every 5-10 seconds until task.has_result is true or it reaches failed/cancelled.
Inputs: task_id (required), task_token (required). Returns: result
Get an absolute download URL for a task result (read-only). If the task is not finished, returns ok=false with code=RESULT_NOT_READY (HTTP 409). Downloading the URL requires the same Authorization: Bearer token.
Inputs: task_id (required). Returns: result
Return up to 100 result rows from an API-key account task as native structured JSON for direct agent analysis; accountless x402 tasks use get_direct_result_preview instead. Use offset/next_offset for pagination; this does not download or parse XLSX. Use after has_result=true; use get_result_download_url when the complete XLSX is required. Read-only.
Inputs: task_id (required), limit, offset. Returns: result
Return a stable synthetic example of Xcatcher's paginated result and coverage metadata. No live X data is fetched, no account is needed, no task or quote is created, and no funds move.
Inputs: no named parameters. Returns: result
Read Xcatcher's live capabilities, prices, limits, endpoints, and recommended agent workflow. Call this first when planning a crawl or when cached documentation may be stale. No points are consumed.
Inputs: no named parameters. Returns: result
Get API-key account task status by task_id (read-only); accountless x402 tasks use get_direct_task_status instead. Recommended polling interval: every 5–10 seconds until has_result=true.
Returns safe structured state, result metadata, and authenticated result URLs; server filesystem paths are never exposed.
Inputs: task_id (required). Returns: result
Create a short-lived USDC quote for a requested number of Xcatcher points. Returns the exact live amount and supported Base/Solana payment requirements; it does not move funds. Ask the user before signing or sending any payment.
Inputs: points (required). Returns: result
List recent tasks owned by the current Bearer API key, newest first. Use next_before_id for cursor pagination. Read-only and does not consume points.
Inputs: limit, before_id. Returns: result
Normalize and deduplicate X handles, validate the mode, and preview the current modeled points/USDC cost. This free read-only check requires no account, creates no quote or task, and moves no funds. Use it before requesting a live x402 payment challenge.
Inputs: users (required), mode. Returns: result
Submit an x402 v2 PAYMENT-SIGNATURE for the exact users/mode used by get_direct_crawl_payment. This may settle USDC and create a crawl task. Call only after explicit spending approval. On success, securely save task_token: it grants task-scoped result access for seven days.
Inputs: users (required), payment_signature_b64 (required), mode. Returns: result
Poll a crawl task server-side until it has a result, reaches a terminal failure/cancelled state, or the bounded timeout expires. Read-only and cheaper for agent context than repeated manual polling.
Inputs: task_id (required), timeout_seconds, poll_interval_seconds. Returns: result
Top up points for the CURRENT Bearer key using x402 proof.
Inputs:
quote_id: returned by PAYMENT-REQUIRED (or /api/v1/x402/quote)
payment_signature_b64: base64(JSON) that will be passed as HTTP header PAYMENT-SIGNATURE
Side effects: credits points to the same Bearer key (no key rotation). On success returns credited_points and balance_after (shape depends on upstream).
Inputs: quote_id (required), payment_signature_b64 (required). Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
X/Twitter search, posts, comments, user profiles, user posts/replies and video transcripts.
Read public Twitter/X data: tweets, profiles, followers, search. No X developer account.
Read-only public X (Twitter) data: profiles, tweets, threads, followers, search. Pay per result.
X (Twitter) profiles and single tweets without login; full timelines with your own cookies.
Add one secure layer between your agents and this server.
