Jobs
Create a complete reusable Job or append an exact-base immutable patch revision.
The public production MCP endpoint is live at https://mcp.everyn.ai/mcp. Configure a host with that Streamable HTTP URL and complete WorkOS OAuth.
A Job is a reusable definition: name, goal, instructions, output contract, exact model, optional capabilities, and display fields. start_run pins an immutable Job version. There is no inline Job definition on start_run.
Use search_jobs and get_job to rediscover work. get_job reads the current version or an explicitly selected version, including compact Run history.
Create
Call save_job with name, goal, instructions, output, model, and an idempotency key.
Output mode is add_columns or create_rows. Column names use ^[a-z][a-z0-9_]*$. Supported column types are string, number, integer, boolean, enum, object, and array.
The model value must be an exact currently runnable model id from get_context (include: ["models"]). Do not guess a model name.
A successful receipt returns the stable job_id, exact job_version_id, and the complete effective definition.
Patch
To revise a Job, send base_version_id, an idempotency key, and at least one changed field.
| Rule | Meaning |
|---|---|
| Omitted fields inherit | Unspecified fields keep the base version. |
null never means inherit | Do not send null to mean "leave this alone". |
| Empty arrays clear | An empty array is an explicit clear. |
output is atomic | When supplied, the entire output contract is replaced. |
If the base is stale, save_job returns conflict with conflict_current_version_id. Re-read get_job, then patch from the current version.
Identical patches are safe: no_op is true and the version does not move.
Next step
Prefer a sample start_run against the new job_version_id before an unverified full Run. See Runs.