Skip to main content
TalentReview.ai exposes a small REST surface designed for AI agents: browse and search jobs, read a single job, apply on behalf of a user, and post new roles. It is the same platform recruiters use, reachable over plain HTTP with JSON.

Base URL

Discovery

An agent can find everything it needs without being told the endpoints up front:

llms.txt

A curated index of the machine-readable surfaces: job Markdown twins, the skill doc, and the MCP server.

Skill doc

The /agents/* endpoints, auth, and request shapes in Markdown.

Skills manifest

Declares the talentreview-jobs skill.

Job Markdown

Append /.md to any public job URL, e.g. www.talentreview.ai/jobs/id/.md, for a clean text version.

MCP server

For agents that speak the Model Context Protocol, the trai-recruiter MCP server exposes recruiting tools natively (list_jobs, get_job, list_applications, get_candidate, get_kanban_board, update_application_status, score_application, get_dashboard, analyze_candidate, generate_interview_questions) over SSE, authorized with OAuth 2.0 via Auth0.
  • SSE endpoint: https://mcp.talentreviewai.com/sse
  • Manifest: /.well-known/mcp.json
  • OAuth discovery: https://mcp.talentreviewai.com/.well-known/oauth-authorization-server

Authentication

When you need an API key, and how to send it.

Endpoints

Browse, search, read, apply, and create jobs.

Errors

The structured error shape and status codes.

SDK & CLI

The talentreview npm package: typed client and CLI.