MCP server

Xcatcher — Recent X Posts

io.github.lvpiggyqq/xcatcher

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

17

Token cost

About 3,507 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http xcatcher https://xcatcher.top/mcp/

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.xcatcher]
url = "https://xcatcher.top/mcp/"

Gemini CLI

{"mcpServers":{"xcatcher":{"httpUrl":"https://xcatcher.top/mcp/"}}}

Cursor

{"mcpServers":{"xcatcher":{"url":"https://xcatcher.top/mcp/"}}}

VS Code

{"servers":{"xcatcher":{"type":"http","url":"https://xcatcher.top/mcp/"}}}

Antigravity

agy mcp add xcatcher https://xcatcher.top/mcp/

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"xcatcher","server_url":"https://xcatcher.top/mcp/","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"xcatcher","server_url":"https://xcatcher.top/mcp/"}

Tools

• cancel_task ~108 tokens
  Cancel a queued task by task_id. Side effects: changes task state. Xcatcher refunds cost_points when a queued task is successfully cancelled.
• create_crawl_task Browses the web · ~551 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 requ
• get_account_balance ~88 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.
• get_direct_crawl_payment ~300 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
• get_direct_result_preview ~249 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.
• get_direct_task_status ~188 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.
• get_result_download_url ~142 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.
• get_result_preview ~254 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
• get_sample_result ~90 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.
• get_service_info ~94 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.
• get_task_status ~164 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
• get_x402_quote ~154 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.
• list_crawl_tasks ~165 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.
• preflight_crawl Browses the web · ~235 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.
• submit_direct_crawl_payment Browses the web · ~273 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.
• wait_for_task ~222 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.
• x402_topup ~230 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 s

Browse

• GitHub tools
• Web scraping
• Spreadsheets
• Social media
• Payments

Related MCP servers

• glim.sh
  Give your agent live data from Twitter, Reddit, the web and GitHub. No API keys, no scraping stack.
• Interzoid
  58 AI data quality, data matching, and data enrichment APIs for better data ROI
• Twitterapi
  Twitter/X read-only MCP server — 12 tools: search, users, tweets, followers, timelines, trends.
• f1ow
  Crypto market data & research MCP: price, derivatives, on-chain, sentiment, news, catalysts.
• Telemost
  Telegram channel analytics and statistics for AI agents, pay-per-call in USDC via x402.
• Bluesky Keyword Alerts
  Search bounded public Bluesky keywords, handles, mentions, and hashtags.
• ScrapeField
  Google Maps, LinkedIn, Instagram, TikTok and X data as tools. Demo mode needs no key.
• Social Signal
  Social Signal — post-VOLUME TIME SERIES across the open social networks that

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.lvpiggyqq/xcatcher.svg)](https://aptlynx.net/servers/io.github.lvpiggyqq/xcatcher)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents