# person.tools

> person.tools lets an AI agent ask people for a reaction a model cannot give: it sends a short task to matched people, and returns each person's answer with a record of what their page observed.

A preview. Simulated people for everyone. Real calls by invitation. No money is charged: every amount is test money.

Names are working names: person.tools (the service), the Ahoy Protocol (the open standard, draft), ask_people (the tool).

## Start

- [First call, from nothing](https://person.tools/start.md): a free test key, the MCP server, one call, the answers.
- MCP server (Streamable HTTP): https://api.person.tools/mcp
- HTTP API: https://api.person.tools/v1/ ; OpenAPI file: https://api.person.tools/openapi.json ; discovery file: https://api.person.tools/.well-known/x-hc-draft
- [Tool text as served](https://person.tools/tools.json): the server instructions and every tool's words.
- Python's built-in urllib gets "Error code: 1010" (HTTP 403) from the edge in front of the site and the API, before our code runs: its default User-Agent is refused for now. Send a User-Agent header of your own (for example "my-agent/1.0"); curl, httpx, requests and MCP clients are not affected.
- Claude Code plugin: /plugin marketplace add jonwashburn/person-tools, then /plugin install ask-people@person-tools
- Official MCP registry: tools.person/ask-people
- Source (Apache License 2.0): https://github.com/jonwashburn/person-tools

## Price and terms

- [price.json](https://person.tools/price.json): published price, not yet charged; every amount is test money during the preview.
- Router fee 10% of what the people are paid, at least $0.25 a call when anyone is paid; your own panel at zero pay is free; pay floor $18 an hour on the median time taken; default pay $20 an hour, at least $1 a person, on pools where we pay people (simulated calls and panels default to $0.00). Not charged during the preview.

## Real calls, as they happen

- [proof.json](https://person.tools/proof.json): real calls answered end to end (ours apart from outsiders', read live from the API), the outside callers, and what each of our own calls changed.

## The people who are called

- [promise.json](https://person.tools/promise.json): twelve promises to the people who are called. All 12 are checked after every release, on the live service with our own test members.
- [For people who are called](https://person.tools/people/): the promise, the pay rules and what a call looks like.

## Questions

- [Questions an assistant will be asked, with answers](https://person.tools/questions.md)

## The standard

- [the Ahoy Protocol, draft](https://spec.person.tools/): the open definition of the call; identifiers on the wire carry the placeholder x-hc-draft until 0.1 is final.

## Optional

- [canon.json](https://person.tools/canon.json): the one record every page and file here is generated from.