Linkd MCP Server

Instructions

Implementation Reference

• src/tools/enrich-linkedin.ts:16-39 (handler)

  The async handler function executing the core logic of the 'enrich_linkedin' tool: constructs API URL, calls makeLinkdRequest, processes response, and returns formatted content.

  export const enrichLinkedinTool = async ({
    url,
  }: EnrichLinkedinParams) => {
    const apiUrl = new URL("https://search.linkd.inc/api/enrich/linkedin");
    apiUrl.searchParams.append("url", url);
  
    const response = await makeLinkdRequest(apiUrl.toString(), {});
    const responseData = await response.json();
  
    if (responseData.error) {
      throw new Error(
        `Failed to enrich LinkedIn profile: ${JSON.stringify(responseData.error)}`
      );
    }
  
    return {
      content: [
        {
          type: "text" as const,
          text: `enrichment completed successfully: ${JSON.stringify(responseData, null, 2)}`
        }
      ]
    };
  };

• src/tools/enrich-linkedin.ts:8-14 (schema)

  Zod input schema and TypeScript type definition for the tool's parameters (LinkedIn URL). Includes name and description exports nearby.

  export const enrichLinkedinSchema = {
    url: z.string().describe("The LinkedIn profile URL to look up."),
  };
  
  type EnrichLinkedinParams = {
    url: string;
  };

• src/server_setup.ts:27-31 (registration)

  Registration of the 'enrich_linkedin' tool on the MCP server using the imported name, description, schema, and handler.

    enrichLinkedinName,
    enrichLinkedinDescription,
    enrichLinkedinSchema,
    enrichLinkedinTool
  );

• src/tools/enrich-linkedin.ts:4-7 (schema)

  Tool name and description constants used for registration and documentation.

  export const enrichLinkedinName = "enrich_linkedin";
  
  export const enrichLinkedinDescription = "Retrieves detailed profile information for a specific LinkedIn URL. Each successful lookup costs 1 credit.";