# echojobsio/jdl-mcp-server [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/echojobsio/jdl-mcp-server  
**GitHub Stars:** 2  
**npm Downloads (last month):** 283  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/echojobsio-jdl-mcp-server

## Description
Search 1M+ enriched job listings from 20,000+ companies. Filter by skills, salary, location, seniority, remote type, and more. Free — 500 calls/day, no signup required. Also available as a remote MCP server at https://mcp.jobdatalake.com.

## Tools
Capabilities this server exposes over MCP:

- **search_jobs** — Search 1M+ job listings from 20K+ companies. Supports keyword search, AI semantic search, filters for location, salary, remote type, seniority, skills, and more.
- **get_job** — Get full details for a specific job listing including description, requirements, salary, and apply link. Use the job_handle ID from search_jobs results.
- **get_company** — Get company profile including open job count, industry, size, and career page URL.
- **find_similar_jobs** — Find jobs similar to a given job listing using AI vector similarity. Great for "more like this" discovery.
- **get_filter_options** — Get available filter values (seniority levels, job functions, skills, etc.) with job counts. Useful for discovering what values to use in search filters.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## 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:

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/echojobsio-jdl-mcp-server/readme_