LinkedIn MCP Server

Instructions

Generates a properly encoded URL that can be used to search for jobs on LinkedIn.
The generated URL is compatible with LinkedIn's job search API.

Args:
    query: The search query string for jobs in LinkedIn.
           
Returns:
    str: A properly encoded URL to search for jobs on LinkedIn.

Implementation Reference

• src/linkedin_mcp_server/main.py:68-88 (handler)

  The handler function for the 'get_url_for_jobs_search' tool. It is registered via the @mcp.tool() decorator. Validates the distance parameter and delegates URL composition to the helper function.

  @mcp.tool()
  def get_url_for_jobs_search(location: str = "San Francisco", distance: int = 25, query: str = "AI Research Engineer") -> str:
      """
      Generates a properly encoded URL that can be used to search for jobs on LinkedIn.
      The generated URL is compatible with LinkedIn's job search API.
      
      Args:
          location: The location to search for jobs in LinkedIn (required)
          distance: The distance from the location to search for jobs in LinkedIn (10, 25, 35, 50, 75, 100)
          query: The search query string for jobs in LinkedIn (required)
                 
      Returns:
          str: A properly encoded URL to search for jobs on LinkedIn.
      """
      if not isinstance(distance, int) or distance not in [10, 25, 35, 50, 75, 100]:
          logger.warning(f"Invalid distance {distance}, using default 25")
          distance = 25
          
      logger.info(f"Generating job search URL for location: {location}, distance: {distance}, query: {query}")
      return compose_job_search_url(location, distance, query)

• src/linkedin_mcp_server/main.py:89-108 (helper)

  Supporting utility function that encodes the parameters and constructs the LinkedIn job search URL. Called by the handler.

  @mcp.resource("linkedinmcpfps://job_search_query/{location}/{distance}/{query}")
  def compose_job_search_url(location: str="San Francisco", distance: int=25, query: str="AI Research Engineer") -> str:
      """
      Composes the URL to search for jobs in LinkedIn with proper URI encoding.
      
      Args:
          location: The location to search for jobs in LinkedIn
          distance: The distance from the location to search for jobs in LinkedIn
          query: The search query string for jobs in LinkedIn
          
      Returns:
          str: Properly encoded URL string with a placeholder for the start index.
      """
      encoded_location = quote_plus(location)
      encoded_distance = quote_plus(str(distance))
      encoded_query = quote_plus(query)
      logger.info(f"Encoded query: {encoded_query}")
      # The double curly braces are escaped to produce a single curly brace for later formatting of the start index
      return f"https://www.linkedin.com/jobs-guest/jobs/api/seeMoreJobPostings/search-results/?location={encoded_location}&distance={encoded_distance}&keywords={encoded_query}"