JobSpy MCP Server

Name: JobSpy MCP Server
Author: borgius

@borgius

Repository

About JobSpy MCP Server

MCP server to search for jobs across multiple job listing platforms

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "jobspy-mcp-server-borgius": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "jobspy-mcp-server",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is JobSpy MCP Server?

JobSpy MCP Server is a Model Context Protocol server that enables AI assistants like Claude to search for jobs across multiple listing platforms (Indeed, LinkedIn, Glassdoor, and others) using the JobSpy tool. It provides structured job data that AI models can easily process and supports both stdio and SSE transport options.

How to use JobSpy MCP Server?

Install Node.js 16+ and Python 3.6+, clone the repository, install npm dependencies, set up the JobSpy tool, then start with npm start. Configure via environment variables or a .env file, and connect through Claude Desktop config (stdio) or web clients (SSE on port 9423). Use the search_jobs tool with parameters like search_term, location, and site_names to retrieve results.

Key features of JobSpy MCP Server

Search jobs across Indeed, LinkedIn, Glassdoor, and more
Filter by search terms, location, and time frames
Output results as JSON or CSV
Supports stdio transport for Claude Desktop
Supports SSE transport for web clients
Docker containerization available
Configurable via environment variables or .env file

Use cases of JobSpy MCP Server

AI assistants answering job search queries in natural language
Aggregating job listings from multiple platforms into one interface
Building custom job alert or monitoring dashboards for web clients
Automating job searches with specific filters for recruitment workflows

FAQ from JobSpy MCP Server

What are the runtime requirements?

Node.js 16+ and Python 3.6+ are required, and the JobSpy tool must be installed and available.

How do I connect Claude Desktop to this server?

Add an entry to your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json with the command node and the path to src/index.js, setting ENABLE_SSE to 0.

What transport options are available?

Two transports: stdio for Claude Desktop integration and SSE for web clients. SSE is enabled via the ENABLE_SSE environment variable.

Can I run the server in a container?

Yes, a Dockerfile is provided. Build the image with docker build -t jobspy-mcp-server . and run it with docker run -p 9423:9423 jobspy-mcp-server.

How do I configure the server without environment variables?

Create a .env file in the root directory with key-value pairs for settings such as JOBSPY_DOCKER_IMAGE, JOBSPY_HOST, JOBSPY_PORT, and ENABLE_SSE.