{"schema_version":"0.1.0","name":"Corebee","description":"AI-native customer support platform. Agents can ingest a knowledge base, configure the chat widget, and operate support for a connected organization with no UI, via REST or MCP.","contact":"jonathan@corebee.ai","documentation":"https://corebee.ai/docs/api","human_page":"https://corebee.ai/for-ai-agents","openapi":"https://corebee.ai/api/v1/openapi.json","links":{"llms_txt":"https://corebee.ai/llms.txt","openapi":"https://corebee.ai/api/v1/openapi.json","mcp_endpoint":"https://corebee.ai/api/v1/mcp/stream","mcp_server_card":"https://corebee.ai/.well-known/mcp/server-card.json","oauth_protected_resource":"https://corebee.ai/.well-known/oauth-protected-resource","oauth_authorization_server":"https://corebee.ai/.well-known/oauth-authorization-server","dynamic_client_registration":"https://corebee.ai/api/v1/mcp/oauth/register","docs":"https://corebee.ai/docs/api"},"authentication":{"methods":["oauth2.1_authorization_code","api_key_bearer"],"oauth":{"protected_resource_metadata":"https://corebee.ai/.well-known/oauth-protected-resource","authorization_server_metadata":"https://corebee.ai/.well-known/oauth-authorization-server","dynamic_client_registration":"https://corebee.ai/api/v1/mcp/oauth/register","grant_types_supported":["authorization_code","refresh_token"],"code_challenge_methods_supported":["S256"]},"api_key":{"scheme":"bearer","header":"Authorization","note":"Org-scoped API key issued from the Corebee dashboard."}},"flows":[{"id":"signup_from_terminal","title":"Create a brand-new account and org from the terminal (one human email click)","steps":[{"id":"start","rest":"POST /api/auth/agent-signup","description":"Body: { email, company_name?, website_url? (https), attribution? }. Returns { signup_id, poll_token, pairing_phrase, poll_url }. SHOW the pairing phrase to the user and tell them to approve the email ONLY if it matches. Keep poll_token secret — it is required to collect credentials."},{"id":"human_approval","description":"The user opens the emailed link (any device) and presses Approve. This is the single human checkpoint — the agent cannot approve on their behalf."},{"id":"collect","rest":"GET /api/auth/agent-signup/status?sid=…&poll_token=…","description":"Poll every 5s (≤15 min). On approval, delivered EXACTLY ONCE: { api_key (24h, scoped), org_id, website_token, embed_snippet, knowledge_source_id?, mcp_endpoint }. If website_url was provided, the docs crawl is already running. If the email already had an account, status is existing_account with NO api_key — the signed-in user creates a key at Settings → API keys."},{"id":"continue","description":"Use the API key as a Bearer token against the MCP endpoint and REST v1 to finish branding, verify ingestion, and install the widget. For durable access, connect via OAuth or create a key in the dashboard."}]},{"id":"onboard_customer_support","title":"Onboard a connected org: ingest knowledge, configure the widget, operate support","steps":[{"id":"connect","rest":"GET /api/v1/me","description":"Verify the credential and resolve the organization it is scoped to."},{"id":"ingest_knowledge","mcp_tool":"add_knowledge_url","description":"Crawl and index the customer docs URL into the RAG knowledge base."},{"id":"configure_widget","mcp_tool":"configure_widget_appearance","description":"Set widget color, logo, position, and welcome text for the customer brand."},{"id":"operate","rest":"GET /api/v1/conversations","mcp_tool":"list_conversations","description":"Read conversations and metrics, then reply, all programmatically."}]}],"capabilities":{"live":["autonomous_account_provisioning"],"early_access":["autonomous_plan_subscription"],"early_access_contact":"https://corebee.ai/contact?topic=agents"}}