Jobspy
MCP server to search for jobs across multiple job listing platforms
What is Jobspy?
Jobspy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server to search for jobs across multiple job listing platforms
MCP server to search for jobs across multiple job listing platforms
This server falls under the Search & Data Extraction and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server to search for jobs across multiple job listing pl
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx jobspyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Jobspy
The JobSpy MCP server wraps the Python JobSpy library to expose multi-platform job searching as a single `search_jobs` MCP tool. It aggregates listings from Indeed, LinkedIn, ZipRecruiter, Glassdoor, Google Jobs, Bayt, and Naukri simultaneously, returning structured results in JSON or CSV. AI assistants connected to this server can help users find job opportunities, compare roles across platforms, and filter results by location and recency — all through natural language.
Prerequisites
- Node.js 16 or later
- Python 3.6 or later with pip, for the underlying JobSpy library
- An MCP-compatible client such as Claude Desktop
- Optional: a `JOBSPY_ACCESS_TOKEN` if the server is deployed with authentication enabled
Clone the repository
Download the JobSpy MCP server source code from GitHub.
git clone https://github.com/borgius/jobspy-mcp-server.git
cd jobspy-mcp-serverInstall Node.js dependencies
Install the npm packages required by the MCP server layer.
npm installConfigure environment variables
Create a `.env` file in the project root to set optional configuration. At minimum you can leave this empty; the server will use default values.
# .env
PORT=9423
HOST=0.0.0.0
# JOBSPY_ACCESS_TOKEN=your-token-here
# JOBSPY_DOCKER_IMAGE=jobspyStart the MCP server
Launch the server. It listens on port 9423 by default and exposes the `search_jobs` tool over the MCP protocol.
npm startConfigure your MCP client
Add the server to your MCP client configuration so your AI assistant can discover and call the `search_jobs` tool.
Jobspy Examples
Client configuration
Add this block to your Claude Desktop MCP configuration. Adjust the working directory to the path where you cloned the repository.
{
"mcpServers": {
"jobspy": {
"command": "node",
"args": ["./index.js"],
"cwd": "/absolute/path/to/jobspy-mcp-server",
"env": {
"PORT": "9423",
"JOBSPY_ACCESS_TOKEN": ""
}
}
}
}Prompts to try
These prompts use the `search_jobs` tool to find and compare job listings across multiple platforms.
- "Search for senior software engineer roles in Austin, TX posted in the last 7 days"
- "Find remote Python developer jobs across Indeed, LinkedIn, and Glassdoor"
- "Look for data science positions in London and return the top 20 results as JSON"
- "Search for product manager jobs at startups in San Francisco"Troubleshooting Jobspy
Server starts but returns no results for job searches
JobSpy depends on the Python `jobspy` package being installed and accessible. Run `pip install python-jobspy` and ensure `python` or `python3` resolves correctly in the environment where the Node server runs.
Port 9423 is already in use
Set `PORT=<other-port>` in your `.env` file or as an environment variable before starting the server, then update any client configurations to match.
LinkedIn results are missing or incomplete
LinkedIn scraping is subject to rate limiting. Try reducing the result count parameter or adding a delay between searches. The `--fetch-description` option for LinkedIn can also trigger blocks more quickly.
Frequently Asked Questions about Jobspy
What is Jobspy?
Jobspy is a Model Context Protocol (MCP) server that mcp server to search for jobs across multiple job listing platforms It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Jobspy?
Follow the installation instructions on the Jobspy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Jobspy?
Jobspy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Jobspy free to use?
Yes, Jobspy is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Jobspy Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Jobspy? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Jobspy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Jobspy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.