# Cobrainer Talent API

> Developer documentation for the Cobrainer Talent API — a skills-based talent management platform. The REST API covers skills, users, jobs, positions, learning opportunities, and the job architecture (job families, clusters, roles, levels, and job profiles). AI agents can additionally connect through Model Context Protocol (MCP) servers.

Authentication: HTTP Bearer JWT or an API key in the `X-API-KEY` header. Production base URL: https://api.be.cobrainer.cloud

## Documentation

- [API reference](https://developers.cobrainer.com/index.html): the full rendered documentation (Redoc) — guides plus every endpoint with request/response schemas
- [OpenAPI specification](https://developers.cobrainer.com/openapi.json): the machine-readable OpenAPI 3 description of all external endpoints; prefer this over the rendered page for endpoint details

## Guides (markdown)

- [Getting started](https://developers.cobrainer.com/content/01_getting_started.md): prerequisites, section overview, REST conventions, data formats, downloadable SAP SuccessFactors integration resources, and [SAP Learning material](https://api.sap.com/partner/CobrainerGmbH/integrations/packages)
- [Authentication](https://developers.cobrainer.com/content/02_authentication.md): JWT and API-key flows with code examples
- [Use cases](https://developers.cobrainer.com/content/03_use_cases.md): skills, users, jobs, learning opportunities, job architecture, and AI agent access via MCP
- [Error handling](https://developers.cobrainer.com/content/04_error_handling.md): error response types and how to handle them
- [Rate limiting](https://developers.cobrainer.com/content/05_rate_limiting.md): request limits per user
- [Support](https://developers.cobrainer.com/content/06_support.md): how to get help
- [API reference overview](https://developers.cobrainer.com/content/07_api_reference.md): what the endpoint reference covers

## MCP (AI agent access)

- [MCP dashboard](https://developers.cobrainer.com/mcp/index.html): the complete tool catalog of all four MCP servers, including each tool's input and output JSON schema
- [Knowledge Base MCP server](https://api.be.cobrainer.cloud/mcp/knowledge-base-read): read access to the knowledge base (stateless HTTP, authenticate with `X-API-KEY`)
- [Job Architecture read MCP server](https://api.be.cobrainer.cloud/mcp/ja-read): read access to the job architecture
- [Architect MCP server](https://api.be.cobrainer.cloud/mcp/ja-architect): write access to the job architecture
- [Reviewer MCP server](https://api.be.cobrainer.cloud/mcp/ja-reviewer): job profile review workflow