Careerjet Job Search

Provides job search via Careerjet API with filtering, multi-language support, and MCP integration.

python

3

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rftsngl-careerjet_mcpv2": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You have a dedicated MCP server that uses the Careerjet API to perform job searches, apply filters, and deliver multi-language results. It lets you build AI-assisted search experiences by connecting clients to Careerjet-powered job data through MCP protocols.

How to use

Use this MCP server with an MCP client to perform job searches across keywords and locations. You can filter results by contract type, duration, and salary, and you can switch languages and locales to support 50+ markets. You access the server through an MCP client using the provided tools, and you pass parameters like keywords, location, locale, and API key to tailor the search and results.

How to install

Prerequisites you need before you start are Python 3.11 or newer and pip. You also need a valid Careerjet API key to enable search functionality.

pip install -r requirements.txt

Configure your API key. The default API key is shown below, but you should replace it with your own key obtained from Careerjet Partner credentials.

371d48447450886ce16b718533cca6f2

Run the MCP server locally with Python. This starts the MCP server in stdio mode so your MCP client can connect directly.

python server.py

If you prefer to run the server inside Docker, build the image and start a container with the following commands.

# Build the Docker image
docker build -t careerjet-mcp .

# Run the container
docker run -it careerjet-mcp

Additional configuration and notes

MCP client configuration can include an Affiliate ID and default locale. A starter configuration example is provided for MCP clients to define the default values used at startup.

startCommand:
  type: stdio
  configSchema:
    type: object
    properties:
      affid:
        type: string
        description: "Careerjet Affiliate ID"
        default: "371d48447450886ce16b718533cca6f2"
      locale:
        type: string
        description: "Default locale code"
        default: "en_US"

Security and usage notes

Keep your Careerjet API key secure. Do not expose it in client applications or logs. If you regenerate your API key, update the configuration to use the new key. Be mindful of API rate limits and implement appropriate request throttling in your MCP client.

Development and testing

You can run quick tests to verify the server responds to basic search requests and to ensure the basic tools work as expected.

# Simple test: import search function and run a basic query (example only)
python -c "from app import search_jobs; print(search_jobs('python', 'London'))"

Available tools

search_jobs_tool

Performs a job search using the Careerjet API with parameters for keywords, location, locale, API key, sort order, page size, contract type, and contract period.

get_job_details_tool

Fetches details for a specific job entry returned by the search tool.