# Litmus Hiring

> Litmus is a Y Combinator-backed technical hiring platform that turns repositories, engineering tickets, and job descriptions into structured, project-based technical assessments and interview pipelines. It evaluates candidates on both code quality and development process, captures AI-tool usage (Claude Code, Copilot CLI) transparently, and syncs candidate management with Ashby, Greenhouse, and Lever. It exposes a REST API and an official hosted MCP server.

## APIs
- [Litmus REST API reference](https://litmushiring.com/docs/rest): Base URL https://www.litmushiring.com/api/v1 — roles, invites, submissions. Bearer API key (litmus_sk_...).
- [Litmus MCP server](https://litmushiring.com/docs/mcp): Hosted Model Context Protocol server at https://litmushiring.com/mcp/<org-id>/ — Clerk OAuth or API key.

## Specs
- [OpenAPI (generated)](openapi/litmus-hiring-openapi.yml): Generated by API Evangelist from the published REST reference.
- [MCP manifest](mcp/litmus-hiring-mcp.yml): 9 tools across submissions, candidates, pipeline, and assessment files.
- [Authentication profile](authentication/litmus-hiring-authentication.yml)
- [OAuth scopes](scopes/litmus-hiring-scopes.yml)
- [Data model](data-model/litmus-hiring-data-model.yml)
- [Conventions](conventions/litmus-hiring-conventions.yml)
- [Error catalog](errors/litmus-hiring-problem-types.yml)
- [Lifecycle](lifecycle/litmus-hiring-lifecycle.yml)

## Docs
- [Developer docs](https://litmushiring.com/docs)
- [REST reference](https://litmushiring.com/docs/rest)
- [MCP quickstart](https://litmushiring.com/docs/mcp/quickstart)
- [MCP tool reference](https://litmushiring.com/docs/mcp/tools)
- [Overview](https://litmushiring.com/overview)
- [About](https://litmushiring.com/about)

## Notes
- Auth: `Authorization: Bearer litmus_sk_...` (organization-scoped). MCP adds Clerk OAuth.
- Versioning: v1 frozen as a stable contract.
- Webhooks: not yet available — poll submissions or the MCP list tools.
- Rate limiting: currently unrestricted.

## Contact
- support@litmushiring.com
- founders@litmushiring.com