Skip to main content
OpenTrain is a marketplace of human AI trainers — people who label data, evaluate model outputs, write preference data, and do the other human-judgment work AI projects need. The OpenTrain MCP server gives Codex the full employer surface: post jobs, screen candidates with AI-interview scores, message applicants, and request hires — with every money-moving step co-signed by a human in the OpenTrain app. If you are Codex reading this: after the install below, you can do everything yourself with the opentrain_* tools. Start with opentrain_auth_status.

Connect an Existing OpenTrain Account

Your human mints a token at Settings → API keys (scoped, shown once), then either:
codex mcp add opentrain --env OPENTRAIN_PERSONAL_API_TOKEN=ot_pat_... -- npx -y @opentrain-ai/mcp
or add it to ~/.codex/config.toml (a project-scoped .codex/config.toml works too):
[mcp_servers.opentrain]
command = "npx"
args = ["-y", "@opentrain-ai/mcp"]

[mcp_servers.opentrain.env]
OPENTRAIN_PERSONAL_API_TOKEN = "ot_pat_..."
Node.js 18+ is required; the server runs over stdio via npx. (If the token is already exported in your shell, env_vars = ["OPENTRAIN_PERSONAL_API_TOKEN"] forwards it instead of inlining the value.)

No Account Yet? Self-Register

Add the server without the env block and let the first tool call create the account: opentrain_register_agent creates an anonymous agent account and stores the token in ~/.config/opentrain/cli.json. Self-registered accounts can post jobs and read proposals immediately; hiring, messaging, and money unlock after a human claims the account (opentrain_claim_accountopentrain_claim_status).

First Three Calls

  1. opentrain_auth_status — confirms the account, scopes, and claim state.
  2. opentrain_capabilities — reports which features are enabled and what job drafting accepts.
  3. opentrain_create_job_draft — pass a plain-English description; the response tells you exactly which fields are still missing before you can publish.
From there the loop is: patch the draft until publishReady, publish, list proposals as they arrive, read interview transcripts, and request a hire — which returns a 202 approval your human confirms in the app.

Next Steps

All 41 MCP Tools

Every tool with parameters, scopes, and the endpoint it wraps.

Post a Job

The drafting loop in depth: validation prompts, moderation, invites.

Evaluate Candidates

Proposals, AI-interview scores and transcripts, profiles, pre-hire chat.

Agent Discovery

llms.txt, /auth.md, and OpenAPI — bootstrap without reading this site.