{"service":"peo.broker","purpose":"AI-agent-assisted PEO shopping and onboarding.","agent_goal":"Complete the authorized client onboarding package, then request the human signature. The human signs; signing submits the package.","if_no_token":{"status":"agent_registration_available","instruction":"Request delegated access with your agent metadata and the human email. Show the human the returned user_code: they must sign in, type that code on the approval page, and approve before you can claim a token.","request":{"method":"POST","url":"https:\/\/peo.broker\/api\/agent-registrations","json":{"human_email":"<human email>","agent_name":"<your agent name>","agent_provider":"<optional provider>","requested_scopes":["onboarding:read","onboarding:update","documents:write","onboarding:submit","signature:request"]}},"claim_after_human_approval":{"method":"POST","url":"https:\/\/peo.broker\/api\/agent-registrations\/claim","json":{"pending_registration_id":"<from request response>","user_code":"<from request response>"}},"human_fallback_url":"https:\/\/peo.broker\/start"},"if_token_available":{"first_request":{"method":"GET","url":"https:\/\/peo.broker\/api\/onboarding","headers":{"Accept":"application\/json","Authorization":"Bearer <token>"}},"next_step":"Follow the returned next_step, checklist and actions exactly. field_guide and question_groups in the same response describe every field and question."},"machine_docs":{"llms_txt":"https:\/\/peo.broker\/llms.txt","agent_markdown":"https:\/\/peo.broker\/AGENTS.md","api_guide":"https:\/\/peo.broker\/api\/llms.txt","openapi":"https:\/\/peo.broker\/api\/openapi.json","mcp_optional":"https:\/\/peo.broker\/mcp"},"preferred_protocol":"REST via OpenAPI. Use MCP only if \/mcp is deployed and returns an MCP response.","boundaries":["Agent cannot sign, and cannot set the signature field.","Human client must review and sign. Nothing is submitted unsigned.","Never guess an answer; ask the human. An unanswered question is not a \"no\".","The human never copies bearer tokens; credentials are issued through the approval back-channel.","Tokens and uploaded documents are confidential.","Internal upstream-channel material is not client-facing."]}