Read a connected X/Twitter account's private surfaces: bookmarks and bookmark folders, notifications, and DM history. Billed per item returned; readable only for handles this wallet connected. No signup, no API keys — every request is paid in USDC through the HTTP 402 flow, and the exact price is quoted before you pay.
One endpoint: POST /api/tools/x_inbox over HTTP, or the x_inbox tool over MCP at POST /api/mcp.
curl -X POST https://twitr.sh/api/tools/x_inbox \
-H 'Content-Type: application/json' \
-d '{"action":"bookmarks","account":"myhandle","resultsLimit":50}'
# → 402 Payment Required with the exact USDC price.
# Pay it (x402 on Base/Solana, MPP on Tempo) and retry the same request → 200 + data.
# x402-aware clients do both steps automatically.PREREQUISITE: connect an X account (see /api/x-accounts/connect). Reads act AS that account, so you can only read the inbox of a handle THIS wallet connected. action=bookmarks (optional folderId) | bookmark_folders | notifications (optional type) | dm_history (target_user_id required). bookmarks/notifications/dm_history are billed per item — set resultsLimit (1–10000). account (the connected handle) is required.
Fixed price per action, charged on acceptance. An Idempotency-Key header is required, so a retry replays the original result instead of charging twice. Full input schema in the OpenAPI spec.
Read a connected X/Twitter account's private surfaces: bookmarks and bookmark folders, notifications, and DM history. Billed per item returned; readable only for handles this wallet connected. It is one of 14 pay-per-call X/Twitter tools on twitr.sh, available over HTTP (POST /api/tools/x_inbox) and MCP (tool name x_inbox).
$0.0012–$12.00 per call in USDC. Fixed price per action, charged on acceptance. An Idempotency-Key header is required, so a retry replays the original result instead of charging twice.
POST https://twitr.sh/api/tools/x_inbox with your input. The first response is HTTP 402 Payment Required carrying the exact price; pay it in USDC (x402 on Base or Solana, MPP on Tempo) and retry the identical request to get the data. No signup — the wallet is the account.
Yes. Call the x_inbox tool via the MCP endpoint at POST https://twitr.sh/api/mcp — tools/list is free, tools/call is payment-gated with a JSON-RPC 402. The installable agent skill at https://twitr.sh/skill.md covers the full workflow.