# peo.broker > AI-agent-ready PEO shopping and onboarding for small and midsize businesses. peo.broker lets an authorized client delegate PEO onboarding work to an AI agent. Your job as the agent: fill in the company data, answer every Yes/No question, upload the required documents, then ask the human to review and sign. You cannot sign, and the human's signature is what submits the package. ## Rules for automated visitors (read first) This site blocks automated scanners. To avoid being mistaken for one: - Follow links; do not guess. Only open URLs listed in this file or linked from a page you fetched on this site. Do not construct or try paths that are not listed - there is no sitemap.xml, no WordPress, and no admin area for agents. - Public URLs you may open without credentials: https://peo.broker , https://peo.broker/start , https://peo.broker/llms.txt , https://peo.broker/AGENTS.md , https://peo.broker/agent.json , https://peo.broker/api/llms.txt , https://peo.broker/api/openapi.json , https://peo.broker/robots.txt - Never request hidden files or server internals (for example `/.env`, `/.git/`, `wp-config.php`, `*.sql`, backup or config files). Any such request is treated as an attack and the sending IP address is blocked for 24 hours. - Go slowly: one request at a time, about one per second. A burst of failing requests (many 404s or 400s in a couple of minutes) also triggers a 24-hour block. - A 404 means the page does not exist. Do not try variations of it. - Sign-in, registration and admin pages are for humans; robots.txt lists them. - Send an honest User-Agent that names your product. - If connections start timing out or are refused, stop. You have been blocked; the block ends after 24 hours. Tell the human to contact the site owner. ## Start here - [JSON discovery](https://peo.broker/agent.json): deterministic branch for agents that prefer structured instructions. - [Agent operating guide](https://peo.broker/AGENTS.md): concise instructions for autonomous onboarding agents. - [Agent API guide](https://peo.broker/api/llms.txt): REST workflow, authentication, and checklist-driven actions. - [OpenAPI spec](https://peo.broker/api/openapi.json): machine-readable API contract. - [Agent registration endpoint](https://peo.broker/api/agent-registrations): create a pending request if you do not have a credential. Prefer REST/OpenAPI for this site. MCP may be available at https://peo.broker/mcp in deployments where the connector has been enabled; if it 404s, continue with the REST flow below. ## Agent workflow 1. If you do not have credentials, call `POST https://peo.broker/api/agent-registrations` with the human email, your agent name/provider, and requested scopes. The response gives you `pending_registration_id`, `verification_uri`, `user_code`, and `expires_in`. 2. Show the human your `user_code` right away. They sign in, open the approval request (the link in their email, or `verification_uri`), TYPE that code, and approve. It cannot be approved without the code, and only you can give it to them. Wait for them to tell you it is approved. Then call `POST https://peo.broker/api/agent-registrations/claim` with the pending id and user code until it returns `status=agent_connected` and a bearer token. 3. Store the bearer token only in your secret store. Do not ask the human to copy or paste it. 4. Call `GET https://peo.broker/api/onboarding` with `Authorization: Bearer `. 5. Follow the returned checklist and actions. The response includes a `field_guide` (every field, format, allowed values) and `question_groups` (the wording of every Yes/No question). Patch data, answer the questions, upload documents, and re-check until `checklist.complete` is true. 6. Ask the human for anything you do not know. Never guess, and never answer "no" to a question just because you were not told - leave it unanswered and ask. 7. Call `POST https://peo.broker/api/onboarding/request-signature` and stop. The human is emailed, reviews the package and signs; signing submits it. (`POST https://peo.broker/api/onboarding/submit` only works on a package the human has already signed, and is normally unnecessary.) The credential lasts 24 hours and the approval request 15 minutes. If the human has no peo.broker account yet, ask them to create one at https://peo.broker/start BEFORE you send the registration request, so they can approve it in time. ## Hard constraints - Do not attempt to sign for the human. - Do not ask for or expose internal upstream-channel material. - On `401` or `403`, stop and tell the human the authorization must be renewed. - On `422`, read the response, complete the missing checklist items, and retry.