Linkd MCP Server

Instructions

Implementation Reference

• src/tools/check-deep-research-status.ts:16-37 (handler)

  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)}`
        }
      ]
    };
  };

• src/tools/check-deep-research-status.ts:8-10 (schema)

  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
  );