# Marvin Recruiter — developer documentation

> Public API of Marvin Recruiter, the all-in-one recruitment platform: read the jobs a customer publishes, send applications and contact requests from their website, and create candidates in their recruitment projects. Each customer generates its own API key, with limited rights.

## Guides (French)

- [Présentation](https://developers.marvins.ai/docs): L'API Marvin Recruiter pour les intégrateurs
- [Authentification](https://developers.marvins.ai/docs/authentication): Clés d'API, scopes et sécurité
- [API partenaire](https://developers.marvins.ai/docs/partner-api): Lister les projets et étapes d'un client, et y créer des candidats
- [Offres et candidatures](https://developers.marvins.ai/docs/offres-et-candidatures): Lire les offres publiées d'un client et y déposer des candidatures avec CV
- [Site web — diffuser vos offres et recevoir les candidatures](https://developers.marvins.ai/docs/site-web): Afficher les offres Marvin sur le site du client via un flux XML, renvoyer les candidatures du site dans Marvin via l'API, et faire remonter les demandes de contact (entreprises, particuliers) dans le CRM

## API reference

- [OpenAPI specification](https://developers.marvins.ai/openapi.json): every operation has an `operationId`
- [Interactive reference](https://developers.marvins.ai/reference)
- Base URL: https://api.marvins.ai. Authentication: an API key in the `X-Marvin-Public-Key` header, with limited rights (see [Authentication](https://developers.marvins.ai/docs/authentication)). Errors of the JSON operations are an `error` object with a machine-readable `code` (and usually a `message`); the XML feeds may answer an error in XML, in plain text or in this JSON envelope, depending on where it occurs: rely on the HTTP status and the `Content-Type`.

## MCP server

- https://mcp.marvins.ai/mcp: drive Marvin from an AI assistant (OAuth 2.1; protected resource metadata: https://mcp.marvins.ai/.well-known/oauth-protected-resource)

## Product

- [Product overview](https://marvins.ai/llms.txt): what Marvin Recruiter does, pricing, every public page