accueil / serveurs / Productivité / io.github.lvpiggyqq/xcatcher
io.github.lvpiggyqq/xcatcher
serveur MCP (Model Context Protocol) · Xcatcher Remote MCP 1.26.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que io.github.lvpiggyqq/xcatcher est sûr ?
Au dernier audit MCP Hub, le serveur MCP « io.github.lvpiggyqq/xcatcher » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 17 outils
- cancel_task≈ 193 tokens
Cancel a queued task by task_id. Side effects: changes task state. Xcatcher refunds cost_points when a queued task is successfully cancelled.
Paramètres, retour & exemple (1)
Paramètrestask_id· integer · requis
Task ID to cancel.
Exemple d'appel{"name": "cancel_task", "arguments": {"task_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - create_crawl_task≈ 588 tokens
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).
Paramètres, retour & exemple (3)
Paramètresmode· string · optionnel · normal | deep
normal = fast latest-post snapshot at scale; deep = deeper per-user collection (slower).users· array · requis
Array of X usernames (handles). You may include a leading '@'.idempotency_key· ? · optionnel
Optional idempotency key for safe retries (recommended for agents).
Exemple d'appel{"name": "create_crawl_task", "arguments": {"users": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_account_balance≈ 172 tokens
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.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_account_balance", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_direct_crawl_payment≈ 376 tokens
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.
Paramètres, retour & exemple (2)
Paramètresmode· string · optionnel · normal | deep
Direct x402 normal requests use progressive batch pricing; deep is $0.10 per normalized requested handle. Always preflight the complete list.users· array · requis
X handles, @handles, or x.com/twitter.com profile URLs.
Exemple d'appel{"name": "get_direct_crawl_payment", "arguments": {"users": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_direct_result_preview≈ 334 tokens
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.
Paramètres, retour & exemple (4)
Paramètreslimit· integer · optionnel
Rows to return (1-100).offset· integer · optionnel
Zero-based row offset.task_id· integer · requis
Completed paid task ID.task_token· string · requis
Task-scoped xtask_ token.
Exemple d'appel{"name": "get_direct_result_preview", "arguments": {"task_id": 1, "task_token": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_direct_task_status≈ 271 tokens
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.
Paramètres, retour & exemple (2)
Paramètrestask_id· integer · requis
Task ID returned after x402 settlement.task_token· string · requis
Task-scoped xtask_ token returned after settlement or idempotent recovery.
Exemple d'appel{"name": "get_direct_task_status", "arguments": {"task_id": 1, "task_token": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_result_download_url≈ 225 tokens
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.
Paramètres, retour & exemple (1)
Paramètrestask_id· integer · requis
Task ID. Must be completed (has_result=true).
Exemple d'appel{"name": "get_result_download_url", "arguments": {"task_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_result_preview≈ 326 tokens
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.
Paramètres, retour & exemple (3)
Paramètreslimit· integer · optionnel
Maximum result rows to return (1-100).offset· integer · optionnel
Zero-based row offset for pagination.task_id· integer · requis
Completed task ID owned by the current API key.
Exemple d'appel{"name": "get_result_preview", "arguments": {"task_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_sample_result≈ 182 tokens
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.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_sample_result", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_service_info≈ 179 tokens
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.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_service_info", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_task_status≈ 241 tokens
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.
Paramètres, retour & exemple (1)
Paramètrestask_id· integer · requis
Task ID returned by create_crawl_task.
Exemple d'appel{"name": "get_task_status", "arguments": {"task_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - get_x402_quote≈ 233 tokens
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.
Paramètres, retour & exemple (1)
Paramètrespoints· integer · requis
Number of points to buy (1-200000). Live quote amount is authoritative.
Exemple d'appel{"name": "get_x402_quote", "arguments": {"points": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - list_crawl_tasks≈ 248 tokens
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.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
Tasks to return (1-100).before_id· ? · optionnel
Cursor from next_before_id; omit for the newest tasks.
Exemple d'appel{"name": "list_crawl_tasks", "arguments": {"limit": 1, "before_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - preflight_crawl≈ 314 tokens
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.
Paramètres, retour & exemple (2)
Paramètresmode· string · optionnel · normal | deep
API-key accounts use 1 point per normal handle and 10 per deep handle; direct x402 normal requests receive progressive batch pricing shown by preflight.users· array · requis
X handles, @handles, or x.com/twitter.com profile URLs.
Exemple d'appel{"name": "preflight_crawl", "arguments": {"users": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - submit_direct_crawl_payment≈ 354 tokens
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.
Paramètres, retour & exemple (3)
Paramètresmode· string · optionnel · normal | deep
Must exactly match the quoted mode.users· array · requis
The exact handles/profile URLs used for the payment requirement.payment_signature_b64· string · requis
The base64(JSON) PAYMENT-SIGNATURE produced for the accepted x402 v2 requirement.
Exemple d'appel{"name": "submit_direct_crawl_payment", "arguments": {"users": [], "payment_signature_b64": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - wait_for_task≈ 297 tokens
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.
Paramètres, retour & exemple (3)
Paramètrestask_id· integer · requis
Task ID returned by create_crawl_task.timeout_seconds· integer · optionnel
Maximum wait in seconds (5-120).poll_interval_seconds· integer · optionnel
Seconds between status checks (2-15).
Exemple d'appel{"name": "wait_for_task", "arguments": {"task_id": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}} - x402_topup≈ 304 tokens
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).
Paramètres, retour & exemple (2)
Paramètresquote_id· string · requis
Quote ID returned by PAYMENT-REQUIRED (or /x402/quote).payment_signature_b64· string · requis
Base64(JSON) for header PAYMENT-SIGNATURE.
Exemple d'appel{"name": "x402_topup", "arguments": {"quote_id": "texte", "payment_signature_b64": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"result": {}}}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».