Skip to content
Agentmart
Submit a tool

Xcatcher — Recent X Posts

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

Connector by lvpiggyqq · GitHub account verified by the MCP Registry

IndexedMITRemote (HTTP)★ 9
Write a review

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/lvpiggyqq-xcatcher

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://xcatcher.top/mcp/ Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools
11 read · 2 write · 4 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
Nothing to install (hosted)
Runs as
Hosted (remote endpoint)

Tools by what they do 17

From the running server's own tool list (tools/list) on Oct 25, 2026.

Read 11 · Look things up without changing anything.

  • get_account_balance
  • get_direct_result_preview
  • get_direct_task_status
  • get_result_download_url
  • get_result_preview
  • get_sample_result
  • get_service_info
  • get_task_status
  • list_crawl_tasks
  • preflight_crawl
  • wait_for_task

Write 2 · Create, change, send or run things.

  • get_direct_crawl_payment
  • get_x402_quote

Delete 4 · Delete, drop, revoke or wipe things.

  • cancel_task
  • create_crawl_task
  • submit_direct_crawl_payment
  • x402_topup

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • Authorization

Other settings (environment variables or headers).

  • Accept

Network hosts it talks to 2

  • github.com · found in code
  • xcatcher.top · found in remote endpoint, install command, code

Tools (17)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • cancel_taskCancel a queued crawl taskcan change or delete data

    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_taskCreate an X crawl taskcan change or delete data

    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 quic…

  • get_account_balanceGet Xcatcher balanceread-only

    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_paymentGet accountless crawl payment requirements

    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.

  • get_direct_result_previewPreview accountless paid crawl resultsread-only

    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_statusGet accountless paid task statusread-only

    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_urlGet result download URLread-only

    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_previewPreview crawl resultsread-only

    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.

  • get_sample_resultInspect a free Xcatcher sample resultread-only

    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_infoGet Xcatcher service inforead-only

    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_statusGet crawl task statusread-only

    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.

  • get_x402_quoteGet an x402 top-up 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.

  • list_crawl_tasksList Xcatcher crawl tasksread-only

    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_crawlPreflight an Xcatcher crawl for freeread-only

    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_paymentPay for and create an accountless crawlcan change or delete data

    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.

Show 2 more tools
  • wait_for_taskWait for a crawl taskread-only

    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_topupCredit points from an x402 paymentcan change or delete data

    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).

Compare and alternatives

    Featured in

    Signals

    Stars
    9
    Forks
    1
    Open issues
    1
    Last commit
    Aug 10, 2026 (2 months ago)
    Last release
    Aug 10, 2026 (2 months ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.lvpiggyqq/xcatcher
    Version
    3.1.0
    Auth
    Bearer token
    License
    MIT
    Repository
    github.com/lvpiggyqq/xcatcher-mcp-manifest
    Website
    xcatcher.top/
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql
    Cite this page

    Xcatcher — Recent X Posts MCP server. Agent Mart. https://agentmart.dev/connectors/lvpiggyqq-xcatcher (last updated 2026-10-24)