Jdl MCP Server

What echojobsio/jdl-mcp-server MCP server does

The echojobsio/jdl-mcp-server MCP server provides an MCP interface to JobDataLake’s job dataset. It covers more than 1 million active listings from over 20,000 companies, with records enriched for salary in USD, skills, seniority, remote policy, and job function. Listings are updated hourly and are sourced from more than 40 applicant-tracking systems, including Greenhouse, Lever, Workday, and Ashby.

The service is intended for conversational job search and structured discovery. An agent can find listings by keywords, skills, compensation, location, country, employment type, seniority, company domain, posting date, or remote arrangement. It can then retrieve the full listing, inspect the employer, or find comparable roles.

How it works

The echojobsio/jdl-mcp-server MCP server runs as an MCP process configured in a compatible client. The client sends tool calls to the server, which queries the JobDataLake service and returns structured results. Search supports ordinary keyword matching as well as AI semantic search.

A typical workflow starts with search_jobs. Results provide a job_handle, which can be passed to get_job for the complete description, requirements, compensation information, and application URL. get_company accepts a company domain or handle to return profile information. find_similar_jobs uses AI vector similarity and is available for remote and technology roles. get_filter_options helps identify supported filter values and reports matching job counts.

Setup and configuration

Install the echojobsio/jdl-mcp-server MCP server through the package shown in the project documentation:

{
  "mcpServers": {
    "jobdatalake": {
      "command": "npx",
      "args": ["-y", "@jobdatalake/mcp-server"]
    }
  }
}

The no-signup tier does not require credentials and includes 500 calls per day, with the allowance resetting daily. For higher usage, add the optional JDL_API_KEY environment variable after obtaining a key from JobDataLake. The documented plans use credits, including a free signup allocation and paid larger credit bundles.

A hosted remote MCP endpoint is also listed at https://mcp.jobdatalake.com.

Tools and capabilities

The echojobsio/jdl-mcp-server MCP server exposes these tools:

• search_jobs: Filter listings by query, skills, salary range, remote type, seniority, location, countries, job function, employment type, posting age, company domain, and sort order. Skills can be combined as an AND filter.
• get_job: Retrieve a listing’s description, requirements, salary, and application link using its job handle.
• get_company: Retrieve company industry, size, funding, career-page URL, and open-job information using a domain or handle.
• find_similar_jobs: Discover related listings through AI vector similarity.
• get_filter_options: Inspect available filter values and their job counts.

Limitations and notes

The free allowance is limited to 500 calls per day. Unlimited or higher-volume use requires a JobDataLake API key and an applicable credit plan. Salary values are represented in USD, and semantic similar-job search is documented as available for remote and technology jobs. The server is focused on job listings and related company information rather than general web search.