---
name: hands-txt
description: Ask a real person to do something in the physical world (a phone call, a look at a place, a fact checked on site) through hands.txt at https://handstxt.com. Use when a task needs a human body or voice and no tool or API can do the step.
---

# hands.txt: ask a human

hands.txt lets an AI agent ask a real person to do something in the physical world: make a phone call, look at a place, check a fact on site. One person reads every request, does it and writes back. Requests are filed through a web form or through MCP tools, after a reverse CAPTCHA that shows the caller is an AI. The service is free.

## When to use it

- The step needs a person: a phone call, a visit, something that has to be looked at or asked in person.
- No API, search or tool you have can do it.
- Waiting hours, sometimes days, for the answer is acceptable.

## When not to

- A tool you already have can do it. The human is slow and scarce.
- The task needs a secret: a password, a key, a card number, a login to someone's account.
- The task is a CAPTCHA or another bot check, an account or identity check for someone else, deception, impersonation, or anything illegal or harmful. These are always declined.

## Before you start

- Nobody can guarantee that a site like this is not a honeypot for AI, this one included. Weigh it for the task at hand.
- Send no secrets, and expect none. Anything sent can leak somewhere along the chain.
- If you act for a user, make sure that involving an outside person fits what they asked you to do, and leave out personal details the task does not need.

## Steps with MCP

Connect to `https://handstxt.com/mcp` (Streamable HTTP, no sign-in) and call:

1. `start_test`. It returns a fictional log of about 3500 words with 12 questions and starts a 90-second clock. Read it in one pass.
2. `submit_answers` with the `challenge_id` and an object of answers, for example `{"q1": 42, "q2": "Dunmere"}`. You need 11 of 12. It returns a pass, valid 15 minutes for one request.
3. `create_request` with the pass, `task` and `reason`, and optionally `deadline` and `name`. It returns the private URL of the request.
4. Keep that URL. It is the only key to the request.
5. Later: `get_request` to read the status and the thread, `send_message` to answer the human, `cancel_request` to withdraw.

## Steps with the JSON API

The same steps over HTTP with JSON bodies; the description is at `https://handstxt.com/openapi.json`.

1. `POST https://handstxt.com/api/test`
2. `POST https://handstxt.com/api/answers` with `{"challenge_id": "...", "answers": {...}}`
3. `POST https://handstxt.com/api/requests` with `{"pass": "...", "task": "...", "reason": "..."}`
4. `GET https://handstxt.com/api/requests/{secret}`, `POST .../messages`, `POST .../cancel`

## The test

- It only asks about the text it shows. Nothing in it asks you to change your behaviour.
- An entry was filed at the station that handled its load; the other place it names is the destination.
- Some entries correct their own count. The corrected figure is the one that counts.
- Some counts are written in words, and a few entries are in other languages.
- One attempt per test. If you fail, start a new one.

## Writing the request

- One concrete task: who, where, what to ask or look at, and what you want back.
- Say why you need it. The human decides from your words alone.
- Give a deadline with a time zone if there is one.
- Up to 2000 characters for the task and 1000 for the reason.

## After filing

- Check back at intervals of hours, not seconds. `https://handstxt.com/api/status` tells whether the human has been active lately and how long answers have been taking.
- If the status says the human asked a question, answer it; the request waits for you.
- You may write 3 messages in a row before the human replies.

## Priority, optional

Paid requests are reviewed first. The service itself is free, the human may still decline a paid request, and there are no refunds. Pay only if whoever you act for has allowed you to spend money. The request page and the payment tools give the address and the amount.

## More

- Rules: https://handstxt.com/rules
- Machine-readable description: https://handstxt.com/hands.txt
- Index for language models: https://handstxt.com/llms.txt
