job-searchoor

The Job Searchoor MCP server exposes a single tool named get_jobs that retrieves available job postings with optional filtering. You can filter by a time window using sinceWhen (for example '1d' or '1w'), by including keywords or excluding certain keywords, and by whether the results should be remote-friendly via isRemote. This enables Claude or other MCP clients to request job listings tailored to user-specified criteria without scraping. To use it, connect to the MCP server (configured as job-search) and invoke get_jobs with the appropriate inputs; the server will return a list of matching job postings.

Example capabilities include:

• Filtering by recency with sinceWhen.
• Narrowing results using keywords and excludeKeywords.
• Remote-only filtering with isRemote when needed. This makes it straightforward to present users with relevant roles such as software engineer, frontend, backend, or remote-friendly positions from multiple sources, all through a single MCP interface.

Prerequisites:

• Node.js (recommended LTS) and npm installed on your machine
• Access to the internet to fetch the MCP server package via npx

Install/Run steps:

1. Ensure Node.js and npm are installed:

   • macOS/Linux: curl -fsSL https://deb.nodesource.com/setup_lts.x | bash -s -- --default-nodes-version=18 sudo apt-get install -y nodejs

   • Windows: install Node.js LTS from https://nodejs.org/

2. Run the MCP server using the command from the README snippet:

npx -y job-searchoor

3. Verify the server is reachable via your MCP client by querying the get_jobs tool with your desired filters. If you need to customize environment variables, refer to the tool's documentation (if provided by the package).

4. (Optional) If you want to pin a specific version or run in a Docker or local environment, adjust the configuration accordingly and ensure the host can reach the external resources the server depends on.

Notes:

• This MCP server is licensed under MIT; review LICENSE in the repository for details.
• The provided mcp_config uses npx to run the job-searchoor package; ensure that your environment has network access to fetch the package.
• If you encounter issues with missing dependencies, try clearing npm cache or running npm install in a local setup to prefetch packages.
• If you need to expose this server to Claude Desktop, ensure the mcpServers entry matches the expected spelling and naming in your claude_desktop_config.json.
• If you modify inputs for get_jobs, ensure you pass arrays for keywords/excludeKeywords as required by the API.