check_deep_research_status
Monitor the progress of a LinkedIn deep research job by providing its ID to track completion status and results.
Instructions
Check the status of an ongoing deep research job.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | The job ID to check status for |
Implementation Reference
- The main handler function that executes the tool logic: constructs a URL for the deep research status API, makes a request using makeLinkdRequest, handles errors, and returns the status as text content.
export const checkDeepResearchStatusTool = async ({ job_id, }: CheckDeepResearchStatusParams) => { const statusUrl = new URL(`https://search.linkd.inc/api/search/deep_research/${job_id}`); const response = await makeLinkdRequest(statusUrl.toString(), {}); const responseData = await response.json(); if (responseData.error) { throw new Error( `Failed to check deep research status: ${JSON.stringify(responseData.error)}` ); } return { content: [ { type: "text" as const, text: `deep research status: ${JSON.stringify(responseData, null, 2)}` } ] }; }; - Zod schema defining the input parameters: job_id as string with description.
export const checkDeepResearchStatusSchema = { job_id: z.string().describe("The job ID to check status for"), }; - src/server_setup.ts:54-59 (registration)Registration of the tool in the MCP server using server.tool() with name, description, schema, and handler.
server.tool( checkDeepResearchStatusName, checkDeepResearchStatusDescription, checkDeepResearchStatusSchema, checkDeepResearchStatusTool );