Reed Jobs MCP Server

What does “Reed Jobs” MCP Server do?

The Reed Jobs MCP Server is a Model Context Protocol (MCP) server that connects AI assistants and development tools with the Reed Jobs API, enabling seamless job search and retrieval capabilities. By acting as a bridge between AI agents and the Reed.co.uk job platform, this server allows users to query job listings using a variety of filters—including keywords, location, salary, contract type, and remote work options—and fetch detailed information about specific job postings. The Reed Jobs MCP Server empowers AI-driven workflows with up-to-date employment data, making it an asset for job recommendation systems, recruitment automation, or any developer workflow that benefits from real-time job market insights.

List of Prompts

No prompt templates were found in the repository or documentation.

List of Resources

No explicit MCP resources are described in the repository or documentation.

List of Tools

• mcp_reed_jobs_search_jobs
  Allows searching for jobs with multiple filters including keywords, location, contract type, permanent/full-time/part-time options, salary range, and distance from location.

• mcp_reed_jobs_get_job_details
  Retrieves detailed information for a specific job based on its job ID.

Use Cases of this MCP Server

• Job Search Automation
  Developers can automate job searches for specific roles, locations, or salary ranges, helping users or clients find relevant listings efficiently.

• AI-Powered Job Recommendation
  AI assistants can suggest job openings based on user preferences by integrating the search functionality into chatbots or personal agents.

• Recruitment Workflow Enhancement
  Recruitment agencies or HR tools can use the server to filter and fetch job details, streamlining candidate sourcing and matching.

• Data Analysis and Market Insights
  Developers can query jobs in bulk and analyze trends like salary ranges, contract types, or remote opportunities within specific regions.

How to set it up

Windsurf

No documented setup instructions for Windsurf were found.

Claude

1. Ensure Node.js (v16+) and npm/yarn are installed.
2. Obtain a Reed API key from the Reed Developer Portal.
3. Install via Smithery:

   npx -y @smithery/cli install @kld3v/reed_jobs_mcp --client claude
   

4. Add your API key to a .env file in the project root:

   REED_API_KEY=your_reed_api_key_here
   

5. Start the server as required by your environment.

Cursor

1. Ensure Node.js (v16+) and npm/yarn are installed.
2. Obtain a Reed API key from the Reed Developer Portal.
3. Install dependencies:

   npm install
   

4. Create a .env file:

   REED_API_KEY=your_reed_api_key_here
   

5. Build and run the project:

   npm run build
   npm start
   

6. Configure mcp.json in Cursor:

   {
     "mcpServers": {
       "reed-jobs-mcp": {
         "command": "node",
         "args": ["path/to/your/dist/index.js"],
         "cwd": "path/to/your/project"
       }
     }
   }
   

Cline

No documented setup instructions for Cline were found.

Securing API Keys

Use environment variables in your .env file:

REED_API_KEY=your_reed_api_key_here

Example JSON configuration for environments:

{
  "mcpServers": {
    "reed-jobs-mcp": {
      "command": "node",
      "args": ["path/to/your/dist/index.js"],
      "cwd": "path/to/your/project",
      "env": {
        "REED_API_KEY": "${REED_API_KEY}"
      }
    }
  }
}

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "reed-jobs-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “reed-jobs-mcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Our opinion:
This MCP server is focused, provides real integration with the Reed Jobs API, and has clear setup instructions for Cursor and Claude. However, it lacks advanced MCP features like prompt templates, resource listing, and explicit sampling/roots support. Documentation is clear for basic use but is minimal for more advanced configurations.

MCP Score

Rating:
Based on the two tables, this MCP server scores a 5 out of 10. It does the core job well and is open source, but is missing advanced MCP features, resources, and community traction.