Sign a person up from an agent

How an AI agent asks for a ControlClaw account for a person. The person creates it with one click in their browser; the agent never sees a password.

An agent can ask for a ControlClaw account for a person. The agent never creates the account and never sees a password: the person opens a link and presses Create my account.

Only do this when the person asked for an account, with an address they gave you.

1. Ask for the account

Send the person's email and name. requestedBy is how you describe yourself, in a few words; the person sees it.

curl -X POST https://controlclaw.com/api/signup-requests \
  -H 'content-type: application/json' \
  -d '{"email": "jamie@acme.com", "name": "Jamie Rivera", "requestedBy": "Claude"}'

The answer has an id, a link and expiresAt. ControlClaw also emails the person a link.

Over MCP, add the server https://controlclaw.com/api/mcp/signup (no sign-in) and call signup_request with the same fields.

2. The person creates the account

Ask the person to open the email, or give them the link. The page says an agent asked and shows the name you gave. They choose a password, or use Google, and press Create my account. The link works once and for one hour.

Nothing is created until they do. If the address already has an account, the email asks them to sign in instead; the answer you get is the same either way.

3. Wait, then connect

Check the request every few seconds:

curl https://controlclaw.com/api/signup-requests/<id>

state is pending, completed or expired. Over MCP: signup_request_status.

When it is completed, connect to the ControlClaw MCP server, https://controlclaw.com/api/mcp, with OAuth as in Connect Claude and other MCP apps. The person approves the connection in the browser where they just signed up.

Limits

  • At most 5 requests per network per hour, 20 per day, and 3 per address per day.
  • A browser the sign-up check cannot confirm as a person gets one more step: a "Confirm you're human" tick, or the link from the email. Scripts and headless browsers cannot finish a sign-up on their own.

On this page