Skip to main content
Glama
Job Search MCP Server

Job Search MCP Server

by jaytuduri

Job Search MCP Server

An MCP server that lets an MCP-compatible assistant search public job listings. It currently uses EURES and does not require an API key.

Setup

Requires Python 3.11+ and uv.

uv sync
uv run pytest

Related MCP server: MCP Job Search Server

Run

Run the server directly over stdio:

uv run job-search-mcp

Docker

Build and run the public Streamable HTTP server. It listens on port 8000 and allows 60 requests per IP per 60 seconds by default.

docker build -t job-search-mcp .
docker run --rm -p 8000:8000 job-search-mcp

The MCP endpoint is http://localhost:8000/mcp. Adjust the limiter with RATE_LIMIT_REQUESTS and RATE_LIMIT_WINDOW. This limiter is in-memory and is intended for one container instance; use a proxy or shared store when scaling.

For Claude Desktop, add this entry to its MCP configuration:

{
  "mcpServers": {
    "job-search": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/jobfinder", "run", "job-search-mcp"]
    }
  }
}

Tools

  • search_jobs: filter by keywords, location, remote-only status, and result limit.

  • job_search_sources: see provider and credential information.

Search results include title, company, location, remote status, description, tags, and a direct listing URL. Listings come from a third-party provider and should be checked before applying.

Available Tools

2 tools
job_search_sourcesA

Return information about the job boards used by this server.

Inputs: no named parameters. Returns: result

search_jobsB

Search current job listings.

Use query for skills, titles, or companies (for example, "Python"), and location for a city, country, or region. Results include direct apply URLs.

Inputs: limit, query, location, remote_only. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools are completely distinct: one searches job listings, the other provides information about the job boards used. There is no overlap or confusion between their purposes.

    Naming Consistency4/5

    Both names are clear and descriptive, but they follow slightly different patterns: search_jobs is verb-first, while job_search_sources is noun-first. This minor inconsistency does not impede understanding.

    Tool Count3/5

    With only two tools, the server feels thin and borderline. However, for a narrow scope like job search, this minimal set can be acceptable, though it is on the low end of the ideal range.

    Completeness4/5

    The server covers the core functionality of searching jobs and provides context about data sources. Minor gaps exist, such as lack of pagination or detailed job retrieval, but the basic workflow is complete and usable.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables users to search LinkedIn's public job listings with advanced filters like location, salary, and experience level. It allows MCP-compatible clients to retrieve real-time job opportunities without requiring LinkedIn authentication or API keys.
      1
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to scrape job offers and filter them based on user-defined criteria, using MCP resources, prompts, and tools.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Unified job search MCP server that aggregates live listings from multiple job boards with deduplication, enabling AI agents to find and filter jobs by keyword and location.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables job search on LinkedIn through MCP tools, including keyword and location search, filtering by remote, easy apply, experience level, job type, and date, and retrieving job details.
      -