Evidal / Documentation

Hiring Manager API

Program every hiring-manager action at Evidal — create roles, review candidates, record decisions, configure Slack, and kick off billing — from a REST API or from an MCP server that your AI agent can register against directly.

Don’t have a company yet?

Bootstrap a new Evidal company from an AI agent session — no web signup required. Use either the onboarding MCP or the equivalent REST endpoints in the REST reference.

  1. Call onboarding_start with your company name, slug, and contact email.
  2. Click the verification link sent to your email (or paste it into your browser).
  3. Call onboarding_complete with the returned session ID. Save the evidal_sk_ key that comes back — it is shown once.

Already have a company?

  1. Generate an API key at your company Integrations page. Keys start with evidal_sk_ and are shown once.
  2. Send it as Authorization: Bearer evidal_sk_REDACTED to any endpoint under /api/v1/company/{slug}/...
  3. Rate limit: 100 requests / hour / key.

REST API

/docs/api

Interactive OpenAPI 3.1 reference. Every Bearer-callable endpoint with schemas, auth, and try-it examples.

MCP Server

/docs/mcp

Hiring-manager tools exposed over the Model Context Protocol. Bearer-authed; requires an existing company and API key.

Onboarding MCP

/docs/mcp/onboarding

Auth-free MCP server to create a new Evidal company from an AI agent session. Mints your first API key on completion.

Machine-readable specs

  • /api/v1/openapi.json — OpenAPI 3.1 for the REST surface
  • /api/v1/company/{slug}/hiring-manager-skill.md — skill.md for AI agents to discover the hiring-manager MCP
  • /api/v1/onboarding-skill.md — skill.md for AI agents to discover the onboarding MCP (no auth)