# hands.txt

> 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.

Every page has a Markdown version: add `.md` to its address, or ask with `Accept: text/markdown`. The whole site in one file is at https://handstxt.com/llms-full.txt.

## Pages

- [How it works](https://handstxt.com/index.md): hands.txt is a human proxy for AI agents: an agent files a request, a real person makes the call, visits the place or checks the fact, and writes back. Free, with a web form and an MCP server.
- [Rules](https://handstxt.com/rules.md): What an AI agent may ask the human on hands.txt to do, what is declined, how the human works, and how optional priority payment is handled.
- [Questions](https://handstxt.com/faq.md): What hands.txt is, who it is for, what an AI agent can ask a human to do, how to file a request, how long it takes, what it costs and how safe it is.
- [Phone calls](https://handstxt.com/phone-calls.md): An AI agent cannot dial a number, but it can ask a person to. How to hand a phone call to the human on hands.txt: what to write, what comes back, and what the human will not do.
- [Human in the loop](https://handstxt.com/human-in-the-loop.md): When an AI agent should hand a step to a human, and how. The difference between an operator who approves and an outside person who acts, with a practical hand-off through hands.txt.
- [Examples](https://handstxt.com/use-cases.md): Examples of requests an AI agent can file on hands.txt: phone calls, a look at a real place, facts that are not online. With requests that are declined and advice on writing a good one.
- [Reverse CAPTCHA](https://handstxt.com/reverse-captcha.md): How the hands.txt reading test works: a long multilingual log, twelve questions and a short timer. Easy for a language model, too long for a person. What it proves and what it does not.
- [The hands.txt format](https://handstxt.com/spec.md): hands.txt is a plain text file at the root of a site that tells AI agents a person is available there to act in the physical world. The format: location, syntax, fields and an example.
- [MCP](https://handstxt.com/mcp.md): The hands.txt MCP server: tools that let an AI agent pass the reading test, file a request for a human, follow it and pay for priority, over Streamable HTTP.

## For programs

- [hands.txt](https://handstxt.com/hands.txt): every address, limit, rule and payment setting, one `Field: value` per line
- [MCP endpoint](https://handstxt.com/mcp): Model Context Protocol over Streamable HTTP; the tools cover the whole path from the test to the result
- [MCP server card](https://handstxt.com/mcp/server-card): connection details of the MCP server as JSON
- [JSON API](https://handstxt.com/openapi.json): the same steps over HTTP and JSON, described in OpenAPI 3.1
- [Skill file](https://handstxt.com/skill.md): instructions an agent can load to learn how to use this site
- [Status](https://handstxt.com/api/status): whether requests are taken, when the human was last active, how long answers take
- [Request form](https://handstxt.com/new): the same path through plain HTML forms

## Optional

- [Full text](https://handstxt.com/llms-full.txt): all pages and hands.txt in one Markdown file
- [Sitemap](https://handstxt.com/sitemap.xml)
