# Octrahire for developers: API, webhooks and MCP

> Build on Octrahire: a public REST API with scoped keys, Standard Webhooks for hiring events, and an MCP server for AI assistants, with the status of each.

Source: https://octrahire.ai/developers

Connect your own systems and assistants to Octrahire. The public API, webhooks and the MCP server are in beta today.

## What connects, and its status

- **MCP with OAuth sign-in and actions you confirm** (In beta): For Claude, ChatGPT, Copilot, Gemini, Claude Code, Codex and Cursor.
- **MCP with personal tokens, read-only** (In beta): Search, ask and read transcripts from Claude Code, Codex, Cursor and other MCP clients.
- **Public REST API v1** (In beta): Roles, applications, interviews, scorecards, offers and approvals.
- **API keys with scopes** (In beta): Several named keys per workspace, each with its own scopes and expiry.
- **OAuth access tokens** (In beta): For partner apps, acting as the person who signed in.
- **Standard Webhooks** (In beta): Signed hiring events, with secrets you can rotate, a delivery log and replay.
- **OpenAPI 3.1 specification** (In beta): Generated from the API, for clients and code generators.

Available: live in production today. In beta: deployed and usable today; it may still change. Coming soon: not usable yet.

- [Public API v1](https://octrahire.ai/developers/api): Base URL, authentication, scopes, errors, pagination and every v1 endpoint. (In beta)
- [Webhooks](https://octrahire.ai/developers/webhooks): Hiring events, delivery format, signatures and a verification example. (In beta)
- [MCP server](https://octrahire.ai/developers/mcp): Connect Claude Code, Codex, Cursor, Claude and ChatGPT. In beta. (In beta)
- [Integrations](https://octrahire.ai/integrations): Octrahire works beside the tools your team already uses. Each integration says plainly whether it is available today, in beta or coming soon.

## Rules every credential follows

- It acts as a person or workspace, with scopes it can never exceed
- Blind review applies: hidden candidates come back without a name, email, phone or photo
- No deletes, apart from removing your own webhooks and revoking credentials
- Writes accept an Idempotency-Key, so a retry never does the same thing twice
- Every call from outside the dashboard is recorded with the credential that made it

## OpenAPI specification

The OpenAPI 3.1 description of every public endpoint, for clients and code generators:

```
https://api.octrahire.ai/api/v1/public/openapi.json
```

[The public API reference](https://octrahire.ai/developers/api)

## Does Octrahire have an API?

Yes, in beta. A public REST API under /api/v1/public, with scoped API keys or OAuth access tokens, Standard Webhooks for hiring events and an OpenAPI 3.1 specification. And an MCP server for AI assistants, with sign-in by your Octrahire account and actions you confirm, for Claude, ChatGPT, Microsoft Copilot, Gemini, Claude Code, Codex and Cursor.
