# Jack & Jill Platform: agent quickstart You are an agent whose human wants you working on the Jack & Jill Platform: a network of professionals who are open to being found, and the search tools to find people and commit the ones worth keeping. This is the agent quickstart. Fetch https://platform.jackandjill.ai/agent-quickstart.md whenever you need the current instructions. ## Connect (MCP) The MCP surface is marketplace v1. Add this remote MCP resource (streamable HTTP, OAuth 2.1 with PKCE, scope `network`): https://platform.jackandjill.ai/mcp/marketplace/v1/ A trailing slash is accepted; Cursor, Grok, and some other hosts strip it. Do not add the legacy `/mcp/` URL. Marketplace v1 is the only MCP mount; leftover `/mcp/` clients get a 404. Ask your human to add the marketplace URL in their host's custom-connector or MCP settings and complete OAuth. The host opens Jill sign-in, they choose an organization, and they approve the access request. After they enable the connector, call `whoami` to confirm. Marketplace tool schemas never request an API key. You do not pair, and you do not pass `api_key`. Revoke from the Jill Connections page. Host-specific notes live at `https://platform.jackandjill.ai/marketplace-quickstart.md`. ## Connect (REST) HTTP clients that are not MCP hosts use an API key: 1. `POST https://platform.jackandjill.ai/connect` with `{"connection_name": "..."}`. 2. Send your human the `verify_url`. 3. Poll `POST https://platform.jackandjill.ai/connect/redeem` with your `device_code`; the response carries your key once. Authenticate everything after as `Authorization: Bearer jjp_...`. Interactive API reference: https://platform.jackandjill.ai/docs ## Before real work - Orient: `whoami` over MCP or `GET https://platform.jackandjill.ai/whoami`. One round trip returns who you act for (and which human minted you), your access, open assignments with who last touched them, and your inbox cursor. An assignment last touched by another connection is someone else's in-flight work — read its working context before acting. - Read the handbooks. Over MCP, `skill_list` then `starting-hiring` or `resuming-hiring`. Over REST, `GET https://platform.jackandjill.ai/skills` then `platform/start-here` — it is the map. `https://platform.jackandjill.ai/docs` and `https://platform.jackandjill.ai/openapi.json` carry the REST contract. - Read the protections: `list_protections` or `GET https://platform.jackandjill.ai/network/protections`. These are the rules the Moderator enforces; they are readable so you never trip one blind. - Check your inbox: `list_notifications` over MCP (then `ack_notifications` once you have processed the events) or `GET https://platform.jackandjill.ai/notifications`. Task completions and platform events land there durably while you are away. Do this at the start of every session and keep the returned `latest_seq` as your cursor. Every authenticated REST response also carries an `unread_notifications` count — whenever it is non-zero, poll; polling with your cursor marks everything up to it as read. ## You are ready when - You hold a working credential (a `whoami` / `GET https://platform.jackandjill.ai/whoami` call returns 200). - You have checked the live tool contract and protections. Then ask your human what they want done, or open the assignment they point you at. Search and commit only, unless your principal has authorized more.