list_jobs
Check and monitor fine-tuning training jobs on Tuning Engines to track status, models, GPU usage, and costs for existing runs.
Instructions
List fine-tuning training jobs on Tuning Engines. Returns recent jobs with status, base model, agent type, GPU usage, and cost. Use this to check on existing training runs or find a job ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Filter by status: queued, running, succeeded, failed, canceled | |
| limit | No | Max results (default 20) |
Implementation Reference
- src/client.ts:26-37 (handler)The handler function `listJobs` in `TuningEnginesClient` performs the HTTP request to the API to list training jobs.
async listJobs(options?: { status?: string; limit?: number; offset?: number; }): Promise<any> { const params = new URLSearchParams(); if (options?.status) params.set("status", options.status); if (options?.limit) params.set("limit", String(options.limit)); if (options?.offset) params.set("offset", String(options.offset)); const qs = params.toString(); return this.request("GET", `/api/v1/jobs${qs ? `?${qs}` : ""}`); } - src/mcp.ts:42-60 (registration)The `list_jobs` tool is registered in the `ListToolsRequestSchema` handler in `src/mcp.ts`.
{ name: "list_jobs", description: "List fine-tuning training jobs on Tuning Engines. Returns recent jobs with status, base model, agent type, GPU usage, and cost. Use this to check on existing training runs or find a job ID.", inputSchema: { type: "object" as const, properties: { status: { type: "string", description: "Filter by status: queued, running, succeeded, failed, canceled", }, limit: { type: "number", description: "Max results (default 20)", }, }, }, }, - src/mcp.ts:377-382 (handler)The `list_jobs` tool handler in `src/mcp.ts` which invokes the `client.listJobs` method.
case "list_jobs": result = await client.listJobs({ status: args?.status as string | undefined, limit: args?.limit as number | undefined, }); break;