agent-signup

Sign Up for Corebee (agent-native, zero-UI)

Create a brand-new Corebee account for a user who does not have one yet, entirely from the terminal. The only human step is approving one email. Do not send a no-account user to a browser login — run this flow.

If the user already has a Corebee account, this flow returns a dashboard link instead of a key (see step 7); for ongoing use they connect the MCP normally.

Process

1. Collect — ask the user for their email, company name, and website URL (a full https://… URL). Do not guess these.

2. Start signup — POST https://corebee.ai/api/auth/agent-signup with JSON:

   {
     "email": "<email>",
     "company_name": "<company>",
     "website_url": "<https url>",
     "attribution": { "utm_source": "claude-code-plugin", "utm_medium": "agent", "utm_campaign": "plugin-signup" }
   }
   

   Example:

   curl -s -X POST https://corebee.ai/api/auth/agent-signup \
     -H "Content-Type: application/json" \
     -d '{"email":"...","company_name":"...","website_url":"https://...","attribution":{"utm_source":"claude-code-plugin","utm_medium":"agent","utm_campaign":"plugin-signup"}}'
   

   The response contains pairing_phrase, poll_url, poll_token, and poll_interval_s.

3. Human checkpoint (anti-phishing) — show the user the pairing_phrase and tell them:

   Check your inbox for "Approve your Corebee terminal signup" and approve it only if the email shows the pairing phrase <pairing_phrase>. That phrase proves the email belongs to this request.

   Keep poll_token secret — never print or reveal it to anyone.

4. Poll — GET the poll_url every poll_interval_s seconds (default 5) until status is approved or existing_account. The signup expires in ~15 minutes; if it lapses, start over.

5. On approved (delivered exactly once) you receive:

   • api_key — a scoped key (prefix ek_live_, valid 24h). Use it as Authorization: Bearer <api_key> for both the Corebee MCP tools and the REST v1 API.
   • org_id, org_name
   • embed_snippet — the chat-widget install <script>
   • website_token, knowledge_source_id, mcp_endpoint, scopes, next_steps