Fetch recent public X/Twitter posts by named handle for monitoring, comparison, OSINT, and research.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional Xcatcher API key for account tools. Discovery and direct x402 tools work without it.
Request JSON responses from the stateless Remote MCP server.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancel a queued task by task_id. Side effects: changes task state. Xcatcher refunds cost_points when a queued task is successfully cancelled.
Task ID to cancel.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Cancel a queued task by task_id. Side effects: changes task state. Xcatcher refunds cost_points when a queued task is successfully cancelled.
| Argument | Type | Description |
|---|---|---|
| task_id* | integer | Task ID to cancel. |
{
"type": "object",
"title": "cancel_taskArguments",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"title": "Task Id",
"minimum": 1,
"description": "Task ID to cancel."
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| mode | string | normal = fast latest-post snapshot at scale; deep = deeper per-user collection (slower). |
| users* | array | Array of X usernames (handles). You may include a leading '@'. |
| idempotency_key | any | Optional idempotency key for safe retries (recommended for agents). |
{
"type": "object",
"title": "create_crawl_taskArguments",
"required": [
"users"
],
"properties": {
"mode": {
"enum": [
"normal",
"deep"
],
"type": "string",
"title": "Mode",
"default": "normal",
"description": "normal = fast latest-post snapshot at scale; deep = deeper per-user collection (slower)."
},
"users": {
"type": "array",
"items": {
"type": "string"
},
"title": "Users",
"maxItems": 500,
"minItems": 1,
"description": "Array of X usernames (handles). You may include a leading '@'."
},
"idempotency_key": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Idempotency Key",
"default": null,
"description": "Optional idempotency key for safe retries (recommended for agents)."
}
}
}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.
No arguments.
{
"type": "object",
"title": "get_account_balanceArguments",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| mode | string | Direct x402 normal requests use progressive batch pricing; deep is $0.10 per normalized requested handle. Always preflight the complete list. |
| users* | array | X handles, @handles, or x.com/twitter.com profile URLs. |
{
"type": "object",
"title": "get_direct_crawl_paymentArguments",
"required": [
"users"
],
"properties": {
"mode": {
"enum": [
"normal",
"deep"
],
"type": "string",
"title": "Mode",
"default": "normal",
"description": "Direct x402 normal requests use progressive batch pricing; deep is $0.10 per normalized requested handle. Always preflight the complete list."
},
"users": {
"type": "array",
"items": {
"type": "string"
},
"title": "Users",
"maxItems": 500,
"minItems": 1,
"description": "X handles, @handles, or x.com/twitter.com profile URLs."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows to return (1-100). |
| offset | integer | Zero-based row offset. |
| task_id* | integer | Completed paid task ID. |
| task_token* | string | Task-scoped xtask_ token. |
{
"type": "object",
"title": "get_direct_result_previewArguments",
"required": [
"task_id",
"task_token"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Rows to return (1-100)."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0,
"description": "Zero-based row offset."
},
"task_id": {
"type": "integer",
"title": "Task Id",
"minimum": 1,
"description": "Completed paid task ID."
},
"task_token": {
"type": "string",
"title": "Task Token",
"description": "Task-scoped xtask_ token."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| task_id* | integer | Task ID returned after x402 settlement. |
| task_token* | string | Task-scoped xtask_ token returned after settlement or idempotent recovery. |
{
"type": "object",
"title": "get_direct_task_statusArguments",
"required": [
"task_id",
"task_token"
],
"properties": {
"task_id": {
"type": "integer",
"title": "Task Id",
"minimum": 1,
"description": "Task ID returned after x402 settlement."
},
"task_token": {
"type": "string",
"title": "Task Token",
"description": "Task-scoped xtask_ token returned after settlement or idempotent recovery."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| task_id* | integer | Task ID. Must be completed (has_result=true). |
{
"type": "object",
"title": "get_result_download_urlArguments",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"title": "Task Id",
"minimum": 1,
"description": "Task ID. Must be completed (has_result=true)."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum result rows to return (1-100). |
| offset | integer | Zero-based row offset for pagination. |
| task_id* | integer | Completed task ID owned by the current API key. |
{
"type": "object",
"title": "get_result_previewArguments",
"required": [
"task_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Maximum result rows to return (1-100)."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0,
"description": "Zero-based row offset for pagination."
},
"task_id": {
"type": "integer",
"title": "Task Id",
"minimum": 1,
"description": "Completed task ID owned by the current API key."
}
}
}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.
No arguments.
{
"type": "object",
"title": "get_sample_resultArguments",
"properties": {}
}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.
No arguments.
{
"type": "object",
"title": "get_service_infoArguments",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| task_id* | integer | Task ID returned by create_crawl_task. |
{
"type": "object",
"title": "get_task_statusArguments",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"title": "Task Id",
"minimum": 1,
"description": "Task ID returned by create_crawl_task."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| points* | integer | Number of points to buy (1-200000). Live quote amount is authoritative. |
{
"type": "object",
"title": "get_x402_quoteArguments",
"required": [
"points"
],
"properties": {
"points": {
"type": "integer",
"title": "Points",
"maximum": 200000,
"minimum": 1,
"description": "Number of points to buy (1-200000). Live quote amount is authoritative."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Tasks to return (1-100). |
| before_id | any | Cursor from next_before_id; omit for the newest tasks. |
{
"type": "object",
"title": "list_crawl_tasksArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Tasks to return (1-100)."
},
"before_id": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"title": "Before Id",
"default": null,
"description": "Cursor from next_before_id; omit for the newest tasks."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| mode | string | 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 | X handles, @handles, or x.com/twitter.com profile URLs. |
{
"type": "object",
"title": "preflight_crawlArguments",
"required": [
"users"
],
"properties": {
"mode": {
"enum": [
"normal",
"deep"
],
"type": "string",
"title": "Mode",
"default": "normal",
"description": "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": {
"type": "array",
"items": {
"type": "string"
},
"title": "Users",
"maxItems": 500,
"minItems": 1,
"description": "X handles, @handles, or x.com/twitter.com profile URLs."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| mode | string | Must exactly match the quoted mode. |
| users* | array | The exact handles/profile URLs used for the payment requirement. |
| payment_signature_b64* | string | The base64(JSON) PAYMENT-SIGNATURE produced for the accepted x402 v2 requirement. |
{
"type": "object",
"title": "submit_direct_crawl_paymentArguments",
"required": [
"users",
"payment_signature_b64"
],
"properties": {
"mode": {
"enum": [
"normal",
"deep"
],
"type": "string",
"title": "Mode",
"default": "normal",
"description": "Must exactly match the quoted mode."
},
"users": {
"type": "array",
"items": {
"type": "string"
},
"title": "Users",
"maxItems": 500,
"minItems": 1,
"description": "The exact handles/profile URLs used for the payment requirement."
},
"payment_signature_b64": {
"type": "string",
"title": "Payment Signature B64",
"description": "The base64(JSON) PAYMENT-SIGNATURE produced for the accepted x402 v2 requirement."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| task_id* | integer | Task ID returned by create_crawl_task. |
| timeout_seconds | integer | Maximum wait in seconds (5-120). |
| poll_interval_seconds | integer | Seconds between status checks (2-15). |
{
"type": "object",
"title": "wait_for_taskArguments",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"title": "Task Id",
"minimum": 1,
"description": "Task ID returned by create_crawl_task."
},
"timeout_seconds": {
"type": "integer",
"title": "Timeout Seconds",
"default": 60,
"maximum": 120,
"minimum": 5,
"description": "Maximum wait in seconds (5-120)."
},
"poll_interval_seconds": {
"type": "integer",
"title": "Poll Interval Seconds",
"default": 5,
"maximum": 15,
"minimum": 2,
"description": "Seconds between status checks (2-15)."
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| quote_id* | string | Quote ID returned by PAYMENT-REQUIRED (or /x402/quote). |
| payment_signature_b64* | string | Base64(JSON) for header PAYMENT-SIGNATURE. |
{
"type": "object",
"title": "x402_topupArguments",
"required": [
"quote_id",
"payment_signature_b64"
],
"properties": {
"quote_id": {
"type": "string",
"title": "Quote Id",
"description": "Quote ID returned by PAYMENT-REQUIRED (or /x402/quote)."
},
"payment_signature_b64": {
"type": "string",
"title": "Payment Signature B64",
"description": "Base64(JSON) for header PAYMENT-SIGNATURE."
}
}
}