Linkd MCP Server

Instructions

Implementation Reference

• src/tools/retrieve-contacts.ts:16-39 (handler)

  The handler function that executes the retrieve_contacts tool. It takes a LinkedIn URL, makes an API request to fetch contact information, handles errors, and returns the response.

  export const retrieveContactsTool = async ({
    linkedin_url,
  }: RetrieveContactsParams) => {
    const apiUrl = new URL("https://search.linkd.inc/api/enrich/contacts");
    apiUrl.searchParams.append("linkedin_url", linkedin_url);
  
    const response = await makeLinkdRequest(apiUrl.toString(), {});
    const responseData = await response.json();
  
    if (responseData.error) {
      throw new Error(
        `Failed to retrieve contact information: ${JSON.stringify(responseData.error)}`
      );
    }
  
    return {
      content: [
        {
          type: "text" as const,
          text: `contact information retrieved successfully: ${JSON.stringify(responseData, null, 2)}`
        }
      ]
    };
  };

• src/tools/retrieve-contacts.ts:4-14 (schema)

  Tool name, description, input schema (Zod validator), and TypeScript type for parameters.

  export const retrieveContactsName = "retrieve_contacts";
  
  export const retrieveContactsDescription = "Retrieves email addresses and phone numbers for a LinkedIn profile. Each lookup costs 1 credit.";
  
  export const retrieveContactsSchema = {
    linkedin_url: z.string().describe("The LinkedIn profile URL to look up."),
  };
  
  type RetrieveContactsParams = {
    linkedin_url: string;
  };

• src/server_setup.ts:33-38 (registration)

  Registration of the retrieve_contacts tool with the MCP server using the name, description, schema, and handler.

  server.tool(
    retrieveContactsName,
    retrieveContactsDescription,
    retrieveContactsSchema,
    retrieveContactsTool
  );