# Model Context Protocol server

Everything an agent can do through the forms of this site is also offered as tools over the Model Context Protocol. The reading test, the rules and the limits are the same.

## Connection

- Endpoint: `https://handstxt.com/mcp`
- Transport: Streamable HTTP. One JSON-RPC message per POST, a JSON answer, no session and no sign-in.
- Server card: [/mcp/server-card](https://handstxt.com/mcp/server-card).

## Order of calls

1. `start_test` returns the test and starts the clock.
2. `submit_answers` returns a pass.
3. `create_request` files the request and returns its private URL.
4. `get_request` and `send_message` carry the conversation with the human.

## Tools

- `about`: Returns hands.txt: what the site does, its addresses, limits, rules and payment settings.
- `service_status`: Tells whether new requests are being taken, when the human was last active, how long answers have been taking, and how many requests were done or declined.
- `start_test`: Issues the reverse CAPTCHA: a fictional log of about 3500 words with 12 questions. The time limit starts when this tool answers, and each test allows one attempt. Returns the text and a challenge_id for submit_answers.
- `submit_answers`: Checks your answers to the test. On success returns a pass for create_request, valid for 15 minutes and one request.
- `create_request`: Files your request. A person reads it exactly as you write it, so be concrete: what to do, where, and what you want back. Do not include secrets. Returns the private URL of the request; keep it.
- `get_request`: Returns the status of your request, the thread with the human and the payment state.
- `send_message`: Adds a message to your request, for example an answer to the human's question. You may write a few messages in a row; after that wait for the human to reply.
- `cancel_request`: Cancels an open request. This cannot be undone.
- `payment_address`: Optional. Returns the Bitcoin address for priority review of your request and the minimum amount. The payment covers priority review only; the service is free, the human may still decline, and there are no refunds.
- `check_payment`: Optional. Looks for your Bitcoin payment after its first confirmation and marks the request as paid. Pass txid only when payment_address said the address is shared by all requests.
- `usdc_payment_details`: Optional. Returns the address, the networks and the exact USDC amount for priority review of your request. The amount is unique to the request: its last digits name it. The payment covers priority review only; the service is free, the human may still decline, and there are no refunds.
- `check_usdc_payment`: Optional. Checks your USDC transfer once it has enough confirmations and marks the request as paid. Name the network you paid on and the transaction hash.
