Search and retrieve Reed job listings

Reed Jobs MCP Server is a TypeScript MCP server that integrates with the Reed Jobs API (Reed.co.uk, a UK job board) to search and retrieve job listings from within an MCP client. It exposes two tools: mcp_reed_jobs_search_jobs, which searches with multiple filters at once, and mcp_reed_jobs_get_job_details, which fetches full detail for a single listing by ID.

Use this connector when an agent or assistant needs to search UK job listings on behalf of a user - filtering by keyword, location, distance, salary range, or contract type (permanent, full-time, part-time) - or pull the full detail of a specific job posting once found. It is scoped to Reed's own listings and API surface; it does not search other job boards, and every call requires a valid Reed API key from the Reed Developer Portal, so it is only usable where that key has been provisioned.

mcp_reed_jobs_search_jobs accepts keywords, locationName, contract, permanent, fullTime, partTime, minimumSalary, maximumSalary, and distanceFromLocation as search parameters, letting a caller combine keyword search with location radius, salary bounds, and contract-type filters in one query. mcp_reed_jobs_get_job_details takes a single jobId and returns the full listing. The four boolean filters (contract, permanent, fullTime, partTime) can be combined to narrow results to a specific employment arrangement, while distanceFromLocation expands or tightens the search radius around locationName rather than requiring an exact location match.

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

for automatic installation via Smithery, or manually: clone the repository, run npm install, create a .env file with REED_API_KEY=your_reed_api_key_here, then npm run build and npm start. Node.js v16 or higher is required. For Cursor IDE, register it in mcp.json:

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

The only required environment variable is REED_API_KEY.

Developers and job-seeker-facing assistants built on Cursor, Claude, or another MCP client that need to search or retrieve UK job listings from Reed.co.uk conversationally - for example, finding remote-friendly or salary-filtered roles in a specific location and pulling full posting details for the ones that match, without wiring up the Reed API directly. It is built to run as an MCP server process rather than a standalone script, so it is meant to be launched and called by an MCP-aware client (Cursor, Claude Desktop) rather than invoked directly from a shell.