get_job
Retrieve specific agent job details by providing a unique job ID and organization ID for efficient monitoring and management of AI agent tasks.
Instructions
Retrieves an agent job by its ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | The unique identifier of the job you want to retrieve. Example: 'job-12345'. | |
| org_id | No | The organization ID. Example: 'aiconnect'. |
Implementation Reference
- src/tools/get_job.ts:27-69 (handler)Executes the 'get_job' tool: destructures job_id and optional org_id, builds API endpoint, fetches job data via agentJobsClient.get, formats details, returns formatted text content or error message.async (params) => { mcpDebugger.toolCall("get_job", params); const { job_id } = params; const endpoint = `/services/agent-jobs/${job_id}${params.org_id ? `?org_id=${params.org_id}` : ''}`; mcpDebugger.debug("Built endpoint", { endpoint, job_id, org_id: params.org_id }); try { const job = await withTiming( () => agentJobsClient.get(endpoint), "get_job API call" ); mcpDebugger.debug("Raw API response", { job }); const result = { content: [ { type: 'text' as const, text: formatJobDetails(job) } ] }; mcpDebugger.toolResponse("get_job", { jobId: job_id, resultLength: result.content[0].text.length }); return result; } catch (error: any) { mcpDebugger.toolError("get_job", error); return { content: [ { type: 'text' as const, text: `Error getting job: ${error.message}` } ] }; }
- src/tools/get_job.ts:10-26 (schema)Input schema for 'get_job' tool using Zod: requires job_id (string), optional org_id (string). Includes description and annotations.{ description: 'Retrieves an agent job by its ID.', annotations: { title: 'Get Agent Job' }, inputSchema: { job_id: z.string({ description: "The unique identifier of the job you want to retrieve. Example: 'job-12345'." }), org_id: z .string({ description: "The organization ID. Example: 'aiconnect'." }) .optional() } },
- src/tools/get_job.ts:7-71 (registration)Registers the 'get_job' MCP tool on the server with schema and handler function.export default (server: McpServer) => { server.registerTool( 'get_job', { description: 'Retrieves an agent job by its ID.', annotations: { title: 'Get Agent Job' }, inputSchema: { job_id: z.string({ description: "The unique identifier of the job you want to retrieve. Example: 'job-12345'." }), org_id: z .string({ description: "The organization ID. Example: 'aiconnect'." }) .optional() } }, async (params) => { mcpDebugger.toolCall("get_job", params); const { job_id } = params; const endpoint = `/services/agent-jobs/${job_id}${params.org_id ? `?org_id=${params.org_id}` : ''}`; mcpDebugger.debug("Built endpoint", { endpoint, job_id, org_id: params.org_id }); try { const job = await withTiming( () => agentJobsClient.get(endpoint), "get_job API call" ); mcpDebugger.debug("Raw API response", { job }); const result = { content: [ { type: 'text' as const, text: formatJobDetails(job) } ] }; mcpDebugger.toolResponse("get_job", { jobId: job_id, resultLength: result.content[0].text.length }); return result; } catch (error: any) { mcpDebugger.toolError("get_job", error); return { content: [ { type: 'text' as const, text: `Error getting job: ${error.message}` } ] }; } } );