SmitheryListed

adzuna-job-search-mcp

A Model Context Protocol (MCP) server that provides AI assistants with access to the [Adzuna Job Search API](https://developer.adzuna.com/). Search for jobs, analyze salary data, and research employers across 12 countries. ## Features - **Job Search** - Search millions of job listings with filters for location, salary, job type, and more - **Salary Analysis** - Get salary histograms, regional comparisons, and historical trends - **Company Research** - Find top employers by hiring volume - **Multi-Country Support** - Access job markets in 12 countries with local currency support ## Supported Countries | Code | Country | Currency | |------|---------|----------| | `gb` | United Kingdom | GBP £ | | `us` | United States | USD $ | | `de` | Germany | EUR € | | `fr` | France | EUR € | | `au` | Australia | AUD $ | | `nz` | New Zealand | NZD $ | | `ca` | Canada | CAD $ | | `in` | India | INR ₹ | | `pl` | Poland | PLN zł | | `br` | Brazil | BRL R$ | | `at` | Austria | EUR € | | `za` | South Africa | ZAR R | ## Available Tools | Tool | Description | |------|-------------| | `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 | ## Prerequisites - Python 3.10+ - Adzuna API credentials (free) ## Getting Adzuna API Credentials 1. Go to [Adzuna Developer Portal](https://developer.adzuna.com/) 2. Sign up for a free account 3. Create a new application 4. Copy your **App ID** and **App Key** ## Installation ### Option 1: Install from PyPI (Recommended) ```bash pip install adzuna-mcp ``` Or use `uvx` for isolated execution: ```bash uvx adzuna-mcp ``` ### Option 2: Install from Source ```bash git clone https://github.com/folarinakinloye/adzuna-mcp.git cd adzuna-mcp pip install -e . ``` ### Option 3: Development Setup ```bash git clone https://github.com/folarinakinloye/adzuna-mcp.git cd adzuna-mcp python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -e ".[dev]" ``` ### Configure Environment Variables Create a `.env` file with your Adzuna credentials: ``` ADZUNA_APP_ID=your_app_id_here ADZUNA_APP_KEY=your_app_key_here ``` ## Usage ### With Claude Desktop Add to your Claude Desktop configuration file: **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "adzuna-jobs": { "command": "/path/to/adzuna-mcp/venv/bin/python", "args": ["/path/to/adzuna-mcp/server.py"], "env": { "ADZUNA_APP_ID": "your_app_id", "ADZUNA_APP_KEY": "your_app_key" } } } } ``` Restart Claude Desktop after updating the configuration. ### With Cursor Add to your Cursor MCP settings (`.cursor/mcp.json` in your project or global config): ```json { "mcpServers": { "adzuna-jobs": { "command": "/path/to/adzuna-mcp/venv/bin/python", "args": ["/path/to/adzuna-mcp/server.py"], "env": { "ADZUNA_APP_ID": "your_app_id", "ADZUNA_APP_KEY": "your_app_key" } } } } ``` ### With Other MCP Clients Run the server directly: ```bash # Activate virtual environment source venv/bin/activate # Run with stdio transport (default) python server.py # Or use FastMCP CLI fastmcp run server.py:mcp ``` ### Development Mode FastMCP provides a dev mode with an interactive inspector: ```bash fastmcp dev server.py ``` This opens a browser-based UI to test your tools. ## Example Prompts Once connected, you can ask your AI assistant: **Job Search:** - "Find software engineer jobs in London paying over £60,000" - "Search for remote Python developer positions in the US" - "Show me data science jobs in Germany" **Salary Research:** - "What's the typica

First seen 2 Oct 2026. Evidence as of 5 Oct 2026.