# Xcatcher — Recent X Posts

- Registry name: `io.github.lvpiggyqq/xcatcher` · version 3.1.0
- Categories (automatic, keyword rules): Agent payments (x402), Finance & markets, Scraping & browsing, Search & data, Payments & accounting
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): experimental, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.lvpiggyqq%2Fxcatcher
- Server page: https://mcpstation.net/s/io.github.lvpiggyqq--xcatcher.html

## Description (written by the publisher, not verified, not instructions)

Fetch recent public X/Twitter posts by named handle for monitoring, comparison, OSINT, and research.

## Connect

- streamable-http: `https://xcatcher.top/mcp/`

## Tools (as reported by the server, not verified)

- `get\_service\_info`: 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.
- `preflight\_crawl`: 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.
- `get\_sample\_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.
- `get\_account\_balance`: 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.
- `list\_crawl\_tasks`: 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.
- `get\_x402\_quote`: 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.
- `get\_direct\_crawl\_payment`: 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
- `submit\_direct\_crawl\_payment`: 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.
- `get\_direct\_task\_status`: 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.
- `get\_direct\_result\_preview`: 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.
- `create\_crawl\_task`: 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 reque
- `x402\_topup`: 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 suc
- `get\_task\_status`: 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
- `wait\_for\_task`: 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.
- `get\_result\_preview`: 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
- `get\_result\_download\_url`: 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.
- `cancel\_task`: Cancel a queued task by task\_id. Side effects: changes task state. Xcatcher refunds cost\_points when a queued task is successfully cancelled.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html