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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"job_id": "<job_id>"
},
"name": "check_deep_research_status"
}
}Input 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 );