People Data Labs MCP Server

Instructions

Implementation Reference

• src/index.ts:543-566 (handler)

  Core handler function that performs the API call to People Data Labs for searching job titles (dataType='job_title'). Validates input, constructs query params, makes GET request to /job_title/search, and returns formatted JSON response.

  private async handleSearch(dataType: string, args: any) {
    if (!isValidSearchArgs(args)) {
      throw new McpError(
        ErrorCode.InvalidParams,
        `Invalid search parameters. Must provide a query string.`
      );
    }
  
    const params: Record<string, any> = {
      sql: args.query,
      size: args.size || 10,
    };
  
    const response = await pdlApi.get(`/${dataType}/search`, { params });
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(response.data, null, 2),
        },
      ],
    };
  }

• src/index.ts:321-339 (registration)

  Registers the 'search_job_titles' tool with the MCP server in the ListTools response, including name, description, and input schema definition.

    name: 'search_job_titles',
    description: 'Search for job titles matching specific criteria',
    inputSchema: {
      type: 'object',
      properties: {
        query: {
          type: 'string',
          description: 'SQL-like query to search for job titles',
        },
        size: {
          type: 'number',
          description: 'Number of results to return (max 100)',
          minimum: 1,
          maximum: 100,
        },
      },
      required: ['query'],
    },
  },

• src/index.ts:418-419 (handler)

  Dispatch logic in the CallToolRequest handler that maps 'search_job_titles' tool invocations to handleSearch('job_title', arguments).

  case 'search_job_titles':
    return await this.handleSearch('job_title', request.params.arguments);

• src/index.ts:82-90 (helper)

  Input validation helper used by the search_job_titles handler to ensure query is provided and size is within bounds.

  const isValidSearchArgs = (args: any): args is {
    query: string;
    size?: number;
  } => {
    return typeof args === 'object' &&
           args !== null &&
           typeof args.query === 'string' &&
           (args.size === undefined || (typeof args.size === 'number' && args.size > 0 && args.size <= 100));
  };