# Let an AI agent sign up for Reducto and get an API key over HTTP

> POST the human's email to https://accounts.reducto.ai/api/agent/accounts to get a signup_token and an emailed code. After the human shares the code and agrees to the terms, POST to /api/agent/accounts/verify. Repeat that same request while it returns 202; the 200 response contains the API key, with 15,000 free credits.

Canonical: https://reducto.ai/tools/agent-self-signup  
Last updated: 2026-11-15  
For: Agent builders, Developers of autonomous agents

## How to do it

1. Check for an existing REDUCTO_API_KEY first.
2. Ask the human for their email and request a code.
3. Ask once for the code, their name and agreement to the terms.
4. Verify, retrying the same request on 202, and save the key securely.
5. Finish a big file: sign up, then rerun the same /api/tools request with Authorization: Bearer $REDUCTO_API_KEY.

## Limits and pricing

- Uses your Reducto API key and its limits.
- No-key fallbacks: 5 pages per document, per-IP rate limit.
- Pricing is per page; see the pricing page.
- Pricing: https://reducto.ai/pricing

## When to use what

- **This tool definition**: when your own agent code decides when to read a document.
- **The hosted MCP server**: when the agent runs in an MCP client (Claude, Cursor, Codex, VS Code).
- **/read or /api/tools**: for one short document without a key.

## FAQ

### Does the human need to agree to anything?

Yes. The agent must ask the human to agree to Reducto's terms and acknowledge the privacy policy, and send terms_accepted: true only after they agree.

### How does an agent finish a file over 5 pages?

Big file? Without a key the free run covers the first 5 pages and returns `partial: true` with a `signup_required` block. Your user signs up in under a minute (email, 6-digit code, name, terms: https://reducto.ai/auth.md); then repeat the same request with `Authorization: Bearer $REDUCTO_API_KEY` for the whole file on their 15,000 free credits. The same key works on the hosted MCP (https://mcp.reducto.ai/mcp) and the Reducto API.

### What if the person already has an account?

Existing users, SSO accounts and lost keys go through Studio. The agent should not create another account.

### Where does the API key come from?

Create one at studio.reducto.ai (15,000 free credits), or let the agent sign up over HTTP by following reducto.ai/auth.md. The SDKs read REDUCTO_API_KEY from the environment.

### Can the agent try it without an API key?

Yes, for short documents: GET https://reducto.ai/read/<public URL> returns Markdown, and POST https://reducto.ai/api/tools/<tool> takes a file. Both are free up to 5 pages with a per-IP limit.

### How is it billed?

In credits per page. See the pricing page and the credit usage docs for current rates.

Sample document (synthetic): https://reducto.ai/tools/samples/harborline-bank-statement.pdf

## Related

- [auth.md](https://reducto.ai/auth.md)
- [Agent developer guide](https://docs.reducto.ai/agent-guide)
- [All agent recipes](https://reducto.ai/tools/agents)
