OpenTrain

Confirm that the configured OpenTrain personal API token can authenticate to the OpenTrain public API.

Discover which OpenTrain public API features are enabled for this token (job drafting, publishing, hiring, messaging writes, team) plus accepted job-draft fields and enums. Call this when a write tool returns a feature-disabled error or before planning a multi-step flow.

Send the human owner a claim invite for the agent-registered OpenTrain account. Ask the human for their email first. OpenTrain emails them a verification link and code; once they accept, they own the account and can add billing. Follow up with opentrain_claim_status to check whether the claim completed.

Check whether the human has completed the OpenTrain account claim started by opentrain_claim_account. When the claim is complete, the stored API token is upgraded to the claimed account automatically. Respect the poll interval from opentrain_claim_account; a slow_down status means you are polling too fast.

Close (archive) a published OpenTrain job so it stops accepting proposals and leaves public listings. Existing contracts on the job are unaffected. Idempotent — closing an already-archived job reports alreadyClosed. Requires jobs:write scope and the job-publishing feature.

Start a credit top-up on the OpenTrain account. No money moves from this call: it returns a Stripe Checkout checkoutUrl that a signed-in human must open and pay (the link expires in ~24h). Once paid, the balance updates automatically — confirm with opentrain_get_credit_top_up or opentrain_get_credits. Amount must be between $10 and $10,000. Requires payments:write scope, a claimed account, and the credits feature.

Create an unpublished OpenTrain job draft from a full job description/project brief or supported import payload. This is the primary MCP job-drafting workflow: OpenTrain parses the description into its structured job fields server-side. The response includes validation state; each missing field carries an "ask:" question to relay to the human, its type, allowed enum values, and the field name(s) to set via opentrain_update_job_draft_fields. Publish with opentrain_publish_job when the draft is publish ready.

Create a new unfunded milestone on an existing OpenTrain contract. No money moves at creation — use opentrain_request_milestone_funding afterwards to start the human-confirmed funding step. Requires payments:write scope and a claimed account.

Subscribe a URL to OpenTrain platform events (push instead of polling opentrain_poll_updates). Deliveries are signed with HMAC-SHA256 via the X-OpenTrain-Signature header. IMPORTANT: the signing secret is returned ONCE in this response — store it immediately; it cannot be retrieved later. Requires webhooks:manage scope, the webhooks feature, and the read scope for each subscribed event type. The subscription only receives events created after it.

Delete a webhook subscription and stop its deliveries. This is also how a DISABLED subscription is resumed: delete it and create a new one (which mints a new secret). Requires webhooks:manage scope and the webhooks feature.

End an OpenTrain contract. If the contract has no funded milestones it ends immediately. If funded escrow is at stake, the call instead returns a pending approval with an approvalUrl a signed-in human must confirm (no funds move until then) — watch opentrain_poll_updates for approval.confirmed or re-check with opentrain_get_approval. Requires payments:write scope, a claimed account, and the payments-write feature flag.

Check the status of a pending human co-sign approval (milestone funding, milestone release, or contract end): pending, confirmed, declined, or expired, plus the execution result once confirmed. Requires payments:read scope.

Read one OpenTrain contract in detail: status, milestones with funding/approval state, freelancer identity, and the post-hire job DM conversationId for messaging. Requires payments:read scope.

Check the status of a credit top-up: pending (awaiting human payment), completed (credits added), canceled, or expired. Requires payments:read scope and the credits feature.

Read the OpenTrain credit balance for the account: available cents, reserved (escrow-held) cents, currency, and the 10 most recent ledger entries. Credits fund hires and milestone escrow without a card-present step; when the balance covers a money move, the existing human co-sign approval flow executes against credits. Requires payments:read scope and the credits feature.

Read a masked OpenTrain freelancer profile by user id or public profile slug for candidate evaluation: title, bio, skills, stats (earned, billed hours, job success), work/label experience, education, reviews, and languages. Requires proposals:read scope. Names are masked to first name + last initial and personal contact details (including personal email) are never returned.

Read a full OpenTrain proposal/candidate evaluation by proposal id: status, bid, masked candidate, AI-interview score + summary, location/identity verification, Open Label assessment, and contract state. Pass includeInterview: true to also fetch the sanitized AI-interview transcript. Requires proposals:read scope and preserves OpenTrain proposal privacy restrictions.

Read the token owner's OpenTrain employer team: organization, members, and pending invites. Team members share jobs and the team inbox. Requires team:read scope and the public_api_team feature.

Read one webhook subscription: URL, event types, status (ACTIVE or DISABLED), and failure/disable details. The signing secret is never returned — if lost, delete and re-create the subscription. Requires webhooks:manage scope and the webhooks feature.

Request hiring a freelancer from an OpenTrain proposal. This does NOT hire or move money: it records a pending approval and returns an approvalUrl a signed-in human must open and confirm in the OpenTrain app (expires in ~72h). The human confirms in the normal hiring interface and may adjust the milestone terms there. Watch opentrain_poll_updates for approval.confirmed or re-check with opentrain_get_approval — the confirmed result includes the new contractId. Requires proposals:write scope and the public_api_hiring feature. Agent accounts must be claimed by a human (403 with claimUrl), and the account needs a payment method or covering credit balance (409 with reason payment_method_required and a billingUrl a human must visit). A 409 with reason not_fit_confirmation_required means retry with confirmNotFitOverride=true if intentional. Re-requesting with identical terms returns the existing pending approval; changed terms supersede it.

Invite a freelancer to a published OpenTrain job, creating a proposal they can respond to. Requires proposals:write scope and the public_api_hiring feature. Agent accounts must be claimed by a human first (403 with a claimUrl otherwise). Idempotent: re-inviting the same freelancer returns the existing proposal with alreadyInvited=true.

Invite a human to the OpenTrain employer team by email, giving them shared access to jobs and the team inbox once they accept. Sends the same invitation email as the in-app flow. Requires team:write scope and the public_api_team feature. Agent accounts must be claimed by a human first (403 with a claimUrl otherwise). Idempotent-ish: inviting an existing member returns already_member; users with existing accounts are added directly (member_added).

List contracts (hired freelancers) on the OpenTrain account, optionally filtered by jobId and/or status (active|ended). Each contract includes milestones, the post-hire job DM conversationId, and the freelancer identity (unmasked post-hire). Requires payments:read scope.

Page through the OpenTrain credit ledger: top-ups, escrow holds, hold releases, captures, refunds, and adjustments, newest first. Each entry links the related top-up, proposal, contract, or milestone ids. Pass the returned nextCursor to fetch older entries. Requires payments:read scope and the credits feature.

List the token owner's OpenTrain jobs with status, publish state, proposal counts, and live URLs. Requires jobs:read scope. Use this to find job ids for opentrain_list_proposals or opentrain_publish_job.

Read pending OpenTrain payment and milestone state visible to the token owner. Requires payments:read scope and never releases funds, refunds charges, creates payouts, or changes payment settings.

List proposals/candidates for an OpenTrain job with statuses, bids, AI interview scores, and resume match scores — the primary tool for reviewing and ranking who to hire. Requires proposals:read scope. Use opentrain_get_proposal for one candidate in depth, then opentrain_hire_proposal to hire.

List the API tokens on the OpenTrain account (labels, scopes, expiry — never secrets). Requires tokens:read scope. Use opentrain_revoke_token to revoke one.

List webhook subscriptions on the OpenTrain account, including status (ACTIVE or DISABLED after sustained delivery failure) and subscribed event types. Secrets are never included. Requires webhooks:manage scope and the webhooks feature.

Poll the OpenTrain delta feed of account events (new proposals, proposal status changes, new messages, contracts, milestone changes, pending payments) in one cheap call instead of re-reading every resource. Pass the nextCursor from the previous poll to receive only newer events; payloads carry IDs only — fetch details with the matching read tool. Event visibility follows the token scopes (proposals:read, messages:read, payments:read).

Publish an OpenTrain draft job live on the marketplace. Runs the same validation + moderation pipeline as the in-app publish flow and is subject to per-account daily publish limits. Requires jobs:write scope and the public_api_job_publishing feature (check the job-drafts capabilities endpoint or a 403 response). Returns the live job URL.

Read authorized OpenTrain conversation summaries or messages. Omit conversationId to list summaries; provide conversationId to read messages. Requires messages:read scope and never creates conversations or sends messages.

Register a brand-new anonymous OpenTrain agent account. No prior credentials are needed. The new API token is stored in the shared OpenTrain config file (also used by the OpenTrain CLI), so every other opentrain tool works immediately afterwards. Next step: ask the human for their email and call opentrain_claim_account so they can claim the account and add billing.

Request approval (payment release) of a funded milestone. This does NOT release money: it returns a pending approval with an approvalUrl that a signed-in human must open and confirm in the OpenTrain app (expires in ~72h). Watch opentrain_poll_updates for an approval.confirmed event, or re-check with opentrain_get_approval. Requires payments:write scope, a claimed account, and the payments-write feature flag.

Request escrow funding for a milestone. This does NOT move money: it returns a pending approval with an approvalUrl that a signed-in human must open and confirm in the OpenTrain app (expires in ~72h). Watch opentrain_poll_updates for an approval.confirmed event, or re-check with opentrain_get_approval. Requires payments:write scope, a claimed account, and the payments-write feature flag.

Revoke an OpenTrain API token by id (irreversible — the token stops working immediately). Requires tokens:write scope. Revoking the token this server is using will break subsequent calls.

Search the public OpenTrain job marketplace (all live jobs, not just the token owner's). Filter by free text, category, language, country, or pay type. Use opentrain_list_jobs for the token owner's own jobs instead.

Send a plain-text message into an existing OpenTrain conversation the token owner participates in. Runs the same membership, rate-limit, and content-policy checks as the in-app messaging flow. Requires messages:write scope and the public_api_messaging_writes feature. Agent accounts must be claimed by a human first (403 with a claimUrl otherwise). This tool never creates conversations; conversations come from proposals, invites, and hires.

Start (or fetch) the pre-hire direct-message thread for a proposal so you can message the candidate before hiring. Idempotent get-or-create — safe to call repeatedly; returns the conversationId to use with opentrain_send_message. Employer side only. Requires messages:write scope, the public_api_messaging_writes feature, and a claimed account.

Fill in or correct fields on an existing unpublished OpenTrain draft. Use this after opentrain_create_job_draft when the draft is not publish ready: ask the human each missing field's "ask:" question, then patch the answers using the "set:" field names (do not ask the human to author raw JSON). Always start from opentrain_create_job_draft with a description; this tool never publishes directly — use opentrain_publish_job for that.

Update fields on a live published (OPEN) OpenTrain job. The revised listing is re-checked by moderation inline; if it is blocked, the job is automatically unpublished back to draft and the response explains what to fix. For unpublished drafts use opentrain_update_job_draft_fields instead. Requires jobs:write scope and the job-publishing feature.