Adzuna Jobs

Provides access to Adzuna Job Search API for job searches, salary analysis, and employer research across 12 countries.

python

8

GitHub Stars

python

Language

5 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": {
    "folathecoder-adzuna-job-search-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "ADZUNA_APP_ID": "YOUR_APP_ID",
        "ADZUNA_APP_KEY": "YOUR_APP_KEY"
      }
    }
  }
}

You run an MCP server that gives AI assistants access to the Adzuna Job Search API. It lets you search millions of job listings, analyze salaries, and research employers across 12 countries, all through a reusable MCP interface.

How to use

You connect your MCP client to the Adzuna Jobs MCP Server using a standard stdio MCP configuration. Start the server locally and pass credentials via environment variables. Once running, your AI assistant can perform job searches, salary analyses, and company research across multiple countries.

To run the server locally with your MCP client, activate your Python environment and start the server in stdio mode. The following approach uses a local Python process as the endpoint.

How to install

Prerequisites you must have before installing: Python 3.10 or newer.

Install the MCP server package from PyPI or install from source as part of your setup.

Install from PyPI (recommended):

pip install adzuna-mcp

Or run via isolated execution with uvx if you prefer containerized isolation.

uvx adzuna-mcp

If you clone the project and install from source, use these steps to set up a development environment and install the package in editable mode.

git clone https://github.com/folarinakinloye/adzuna-mcp.git
cd adzuna-mcp
pip install -e .

Configure credentials for Adzuna in a local environment file or environment variables. Create a file named ".env" with your credentials:

ADZUNA_APP_ID=your_app_id_here
ADZUNA_APP_KEY=your_app_key_here

Configuration and running by yourself

You will run the MCP server in a local environment. The server exposes a standard Python entry point that you start from your project directory.

Use this basic starting command to run the server in stdio mode after you activate your virtual environment.

# Activate virtual environment (example)
source venv/bin/activate

# Run the MCP server in stdio mode
python server.py

Security and credentials

Keep your Adzuna credentials secure. Do not commit credentials to version control. Use environment variables or secured secret management to provide ADZUNA_APP_ID and ADZUNA_APP_KEY to the MCP server.

If you are deploying in a shared environment, prefer isolated execution options (like uvx) or containerization to minimize exposure of credentials.

Examples of typical prompts

With the server running, you can instruct your AI assistant to perform actions such as searching for jobs, analyzing salaries, and researching top employers. Examples include:

Find software engineer jobs in London paying over £60,000
Show salary trends for data scientists in the UK
Identify the leading employers hiring software engineers in Berlin

Available tools

search_jobs

Search for jobs with filters (keywords, location, salary, job type)

get_categories

Get valid job category tags for a country

get_salary_histogram

Get salary distribution data for job searches

get_top_companies

Get top employers by number of open positions

get_geodata

Get salary data broken down by geographic region

get_salary_history

Get historical salary trends over time

get_api_version

Get current Adzuna API version