Draft tweets with AI: generate variants from a topic and goal, refine an existing draft, or score a draft for likely engagement — with tone, call-to-action, and style-matching options. Flat sub-cent price per step. 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/compose over HTTP, or the x_compose tool over MCP at POST /api/mcp.
curl -X POST https://twitr.sh/api/tools/compose \
-H 'Content-Type: application/json' \
-d '{"step":"generate","topic":"pay-per-call APIs for AI agents","goal":"announce launch","tone":"punchy"}'
# → 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.step=generate (topic + goal required; optional tone/styleUsername/additionalContext/callToAction/mediaType/hasLink/hasMedia), refine (draft required), or score (draft required). Returns text variants with scores and suggestions. Flat floor price per call.
The exact quote is returned in the 402 challenge before you pay — an agent always knows the cost first. Failed calls are never charged. Full input schema in the OpenAPI spec.
Draft tweets with AI: generate variants from a topic and goal, refine an existing draft, or score a draft for likely engagement — with tone, call-to-action, and style-matching options. Flat sub-cent price per step. It is one of 14 pay-per-call X/Twitter tools on twitr.sh, available over HTTP (POST /api/tools/compose) and MCP (tool name x_compose).
$0.001 per call in USDC. The exact quote is returned in the 402 challenge before you pay — an agent always knows the cost first. Failed calls are never charged.
POST https://twitr.sh/api/tools/compose 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_compose 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.