SimplyHired MCP Server
A Model Context Protocol (MCP) server for searching job listings on SimplyHired.com. This server provides tools and prompts to search for jobs with configurable parameters including query, location, and search radius.
Features
- Job Search: Search SimplyHired.com with customizable parameters
- Configurable Search Radius: Set search radius from 5 to 100 miles or exact location
- Structured Results: Returns job listings with title, company, location, salary, and description
- Smithery Compatible: Designed to work seamlessly with Smithery MCP registry
Installation
Using uv (recommended)
When using uv
no specific installation is needed. We will use uvx
to directly run mcp-server-simplyhired.
Using pip
Alternatively you can install mcp-server-simplyhired
via pip:
After installation, you can run it as a script using:
Configuration
Configure for Claude.app
Add to your Claude settings:
Using uvx
Using pip installation
Smithery Configuration
This server is compatible with Smithery. You can add it to your Smithery configuration:
Available Tools
search_simplyhired
Searches SimplyHired.com for job listings with the following parameters:
- query (string, required): Job title, skills, or company name to search for
- location (string, required): City, state, ZIP code, or "Remote" for location
- search_radius (integer, optional): Search radius in miles (5, 10, 15, 25, 50, 100). Default: 25
- max_results (integer, optional): Maximum number of job listings to return (1-100). Default: 20
Example Usage
Available Prompts
search_jobs
Search for job listings on SimplyHired.com with the following arguments:
- query (required): Job title, skills, or company name to search for
- location (required): City, state, ZIP code, or "Remote" for location
- search_radius (optional): Search radius in miles (5, 10, 15, 25, 50, 100)
URL Structure
The server constructs SimplyHired search URLs using the following pattern:
Where:
q
= URL-encoded query stringl
= URL-encoded location stringsr
= Search radius in miles (optional)
Customization
User-Agent
By default, the server uses the User-Agent:
You can customize this by adding the --user-agent
argument:
Request Timeout
You can customize the request timeout (default: 30 seconds) by adding the --timeout
argument:
Debugging
You can use the MCP inspector to debug the server. For uvx installations:
Or if you've installed the package in a specific directory or are developing on it:
Development
Setup
- Clone the repository
- Install dependencies:
Running Tests
Code Formatting
Type Checking
Contributing
We encourage contributions to help expand and improve mcp-server-simplyhired. Whether you want to add new features, enhance existing functionality, or improve documentation, your input is valuable.
Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements.
License
mcp-server-simplyhired is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Disclaimer
This server is not affiliated with SimplyHired.com. It is an independent tool that searches publicly available job listings. Please respect SimplyHired's terms of service and rate limits when using this server.
This server cannot be installed
Enables searching job listings on SimplyHired.com with customizable parameters including query, location, and search radius.
Related MCP Servers
- AsecurityAlicenseAqualityEnables searching for Airbnb listings and retrieving detailed accommodation information with direct links to Airbnb pages.Last updated -2JavaScriptMIT License
- -securityFlicense-qualityEnables searching for AI agents by keywords or categories, allowing users to discover tools like coding agents, GUI agents, or industry-specific assistants across marketplaces.Last updated -23Python
- AsecurityAlicenseAqualityProvides tools to interact with the HireBase Job API, enabling users to search for jobs using various criteria and retrieve detailed job information through natural language.Last updated -22PythonMIT License
- -securityFlicense-qualityEnables job searching functionality using Careerjet API with features like keyword and location-based searches, advanced filtering, and multi-language support across 50+ countries.Last updated -JavaScript