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:

pip install mcp-server-simplyhired

After installation, you can run it as a script using:

python -m mcp_server_simplyhired

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx

{
  "mcpServers": {
    "simplyhired": {
      "command": "uvx",
      "args": ["mcp-server-simplyhired"]
    }
  }
}

Using pip installation

{
  "mcpServers": {
    "simplyhired": {
      "command": "python",
      "args": ["-m", "mcp_server_simplyhired"]
    }
  }
}

Smithery Configuration

This server is compatible with Smithery. You can add it to your Smithery configuration:

name: simplyhired-search
description: Search job listings on SimplyHired.com
command: uvx mcp-server-simplyhired
variables:
  - name: query
    description: Job title, skills, or company name
    type: string
    required: true
  - name: location
    description: City, state, ZIP code, or 'Remote'
    type: string
    required: true
  - name: search_radius
    description: Search radius in miles (5, 10, 15, 25, 50, 100)
    type: integer
    default: 25

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

{
  "query": "software engineer",
  "location": "San Francisco, CA",
  "search_radius": 15,
  "max_results": 10
}

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:

https://www.simplyhired.com/search?q={query}&l={location}&sr={search_radius}

Where:

q = URL-encoded query string
l = URL-encoded location string
sr = Search radius in miles (optional)

Customization

User-Agent

By default, the server uses the User-Agent:

ModelContextProtocol/1.0 (SimplyHired Search; +https://github.com/modelcontextprotocol/servers)

You can customize this by adding the --user-agent argument:

{
  "mcpServers": {
    "simplyhired": {
      "command": "uvx",
      "args": ["mcp-server-simplyhired", "--user-agent", "YourCustomUserAgent"]
    }
  }
}

Request Timeout

You can customize the request timeout (default: 30 seconds) by adding the --timeout argument:

{
  "mcpServers": {
    "simplyhired": {
      "command": "uvx",
      "args": ["mcp-server-simplyhired", "--timeout", "60"]
    }
  }
}

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx mcp-server-simplyhired

Or if you've installed the package in a specific directory or are developing on it:

cd path/to/simplyhired-mcp-server
npx @modelcontextprotocol/inspector uv run mcp-server-simplyhired

Development

Setup

Clone the repository
Install dependencies:
uv sync

Running Tests

uv run pytest

Code Formatting

uv run black src/
uv run isort src/

Type Checking

uv run mypy src/

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

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Enables searching job listings on SimplyHired.com with customizable parameters including query, location, and search radius.

Related MCP Servers

Airbnb MCP Server
Domoteek
A
security
A
license
A
quality
Enables searching for Airbnb listings and retrieving detailed accommodation information with direct links to Airbnb pages.
Last updated -
2
JavaScript
MIT License
AI Agent Marketplace Index Search
AI-Agent-Hub
-
security
F
license
-
quality
Enables 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 -
34
Python
HireBase MCP Server
jhgaylor
A
security
A
license
A
quality
Provides 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 -
2
7
Python
MIT License
Careerjet Job Search MCP Server
TesterEnes
-
security
F
license
-
quality
Enables 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

View all related MCP servers

SimplyHired MCP Server