Onboarding MCP

A public, auth-free MCP server that creates a new Evidal company from an AI agent session. Point Claude Code, Cursor, or any MCP-aware client at the server URL, call onboarding_start, click the verify-email link you receive, then call onboarding_complete to mint your first API key. Once you have a key, switch to the hiring-manager MCP.

Connect

Server URL: https://app.evidal.ai/api/mcp/onboarding

claude mcp add \
  --transport http \
  evidal-onboarding \
  https://app.evidal.ai/api/mcp/onboarding

No Authorization header — this server is intentionally public so an agent with no prior Evidal state can bootstrap a company.

Tools (4)

onboarding_start

Start an agentic company onboarding session. Sends a verification email to owner_email with a magic link. Returns { session_id, status, verification_email_sent_to, expires_at }. No auth required — rate-limited per IP (20/hr), per owner_email (3 concurrent pending), and by a global 100/hr circuit breaker. slug must be lowercase [a-z0-9-], <=64 chars, not reserved, not on the brand blocklist (unless owner_email domain matches). EVI-237: lever_api_key and lever_subdomain are OPTIONAL; pass both to auto-connect Lever at onboarding_complete. If the Lever key fails validation, the company is still created and lever_connect_result=validation_failed is returned.

Parameters

owner_email *: string (email)
company_name *: string
slug ?: string
domain ?: string
invite_emails ?: array<string (email)>
initial_role ?: object
lever_api_key ?: string
lever_subdomain ?: string

* required, ? optional

onboarding_status

Poll the status of an onboarding session. Returns { status, company_slug? }. `company_slug` is only populated once status=completed. Statuses: pending_email_verification | verified | completed | expired | cancelled.

Parameters

session_id *: string (uuid)

* required, ? optional

onboarding_complete

destructive

Completes onboarding after the user clicks the verification email. Only valid when session status='verified'. Creates the company, owner membership, and optional initial role. Returns the API key (shown ONCE — save it immediately), MCP connection details, and a guided setup sequence. After receiving the response, walk the user through the setup steps in order: (1) register the hiring-manager MCP server, (2) upload company logo, (3) set up custom domain via DNS, (4) publish the first role. Each step includes the tool name and fields needed.

Parameters

session_id *: string (uuid)

* required, ? optional

onboarding_cancel

destructive

Cancel a pending onboarding session. Idempotent — no-op if the session is already in a terminal state (cancelled / completed / expired). Frees the proposed slug for other callers.

Parameters

session_id *: string (uuid)

* required, ? optional