LinkedIn Enrichment

Instructions

Implementation Reference

• src/index.ts:109-172 (registration)

  MCP server registration of the 'enrich_by_linkedin' tool, including input schema, annotations, and execution handler that delegates to LeadFuzeClient

  server.registerTool(
    "enrich_by_linkedin",
    {
      title: "LinkedIn Enrichment",
      description:
        "Look up detailed person and company information using a LinkedIn profile URL. Returns verified business data including email, job title, company details, and phone numbers.",
      inputSchema: {
        linkedin: z
          .string()
          .describe(
            "The LinkedIn profile URL (e.g., linkedin.com/in/johndoe or https://www.linkedin.com/in/johndoe)"
          ),
        include_company: z
          .boolean()
          .default(true)
          .describe("Include company data in response"),
        include_social: z
          .boolean()
          .default(true)
          .describe("Include social profile data in response"),
      },
      annotations: {
        title: "LinkedIn Enrichment",
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: true,
      },
    },
    async ({ linkedin, include_company, include_social }) => {
      try {
        const client = getClient();
        const response = await client.enrichByLinkedIn({
          linkedin,
          include_company,
          include_social,
        });
  
        const formattedResponse = formatEnrichmentResponse(response);
  
        return {
          content: [
            {
              type: "text" as const,
              text: formattedResponse,
            },
          ],
        };
      } catch (error) {
        const errorMessage =
          error instanceof Error ? error.message : "An unknown error occurred";
  
        return {
          content: [
            {
              type: "text" as const,
              text: `Error enriching LinkedIn profile: ${errorMessage}`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/api/leadfuze-client.ts:74-86 (handler)

  Core handler function in LeadFuzeClient that normalizes the LinkedIn URL and makes the POST request to LeadFuze /enrichment/linkedin API endpoint

  async enrichByLinkedIn(params: LinkedInEnrichmentParams): Promise<EnrichmentResponse> {
    // Normalize LinkedIn URL - strip protocol and www
    const normalizedLinkedIn = normalizeLinkedInUrl(params.linkedin);
  
    return this.request<EnrichmentResponse>("/enrichment/linkedin", {
      linkedin_url: normalizedLinkedIn,
      include_company: params.include_company ?? true,
      include_social: params.include_social ?? true,
      limit: 100,
      page: 1,
      cache_ttl: 600,
    });
  }

• src/index.ts:115-129 (schema)

  Zod input schema validation for the enrich_by_linkedin tool parameters

  inputSchema: {
    linkedin: z
      .string()
      .describe(
        "The LinkedIn profile URL (e.g., linkedin.com/in/johndoe or https://www.linkedin.com/in/johndoe)"
      ),
    include_company: z
      .boolean()
      .default(true)
      .describe("Include company data in response"),
    include_social: z
      .boolean()
      .default(true)
      .describe("Include social profile data in response"),
  },

• src/types/enrichment.ts:108-112 (schema)

  TypeScript interface defining parameters for LinkedIn enrichment

  export interface LinkedInEnrichmentParams {
    linkedin: string;
    include_company?: boolean;
    include_social?: boolean;
  }

• src/api/leadfuze-client.ts:104-117 (helper)

  Helper function to normalize LinkedIn URLs by stripping protocol, www prefix, and trailing slash for API compatibility

  function normalizeLinkedInUrl(url: string): string {
    let normalized = url.trim();
  
    // Remove protocol
    normalized = normalized.replace(/^https?:\/\//, "");
  
    // Remove www.
    normalized = normalized.replace(/^www\./, "");
  
    // Remove trailing slash
    normalized = normalized.replace(/\/$/, "");
  
    return normalized;
  }