# Adzuna MCP

> Adzuna provides direct access to millions of live job advertisements, plus deep labor market analytics. Search for jobs by keyword or location, estimate salary ranges for specific roles using real-time data, and track regional vacancy trends across global markets.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** job-search, salary-data, labor-market, employment-trends, career-insights

## Description

Need to figure out what a role actually pays in the current market? This MCP connects your AI agent directly to one of the world's largest job search engines. You can stop relying on guesswork or outdated salary guides. Instead, you query millions of active listings by keyword, location, or contract type. Beyond simple searching, you analyze historical data to track how salaries and vacancies have changed over time, pinpointing specific regions with high demand for certain skills. It’s also useful for tracking which companies are hiring the most right now. You connect this Adzuna MCP through Vinkius's catalog, giving your agent immediate access to these professional-grade insights without needing manual data imports or complex API setups.

## Tools

### get_categories
Lists all major employment sectors, helping you narrow down your search criteria.

### get_geodata
Pulls regional data to show which specific areas have the highest demand for open positions.

### get_histogram
Generates a visual distribution map of salary data, showing where most pay rates cluster.

### get_history
Retrieves time-series data on salaries and job vacancies to show changes over past months or years.

### get_jobsworth
Predicts the market salary range for a specific role title and skill set using current listings.

### get_top_companies
Identifies the companies that are posting the highest number of vacancies right now.

### get_version
Checks the current version of the Adzuna API to ensure compatibility.

### search_jobs
Searches through millions of active job advertisements using keywords, location, and salary filters.

## Prompt Examples

**Prompt:** 
```
Search for 'Remote React Developer' jobs in the US.
```

**Response:** 
```
I've found several listings for Remote React Developers in the US. The top results include positions at TechFlow and CloudScale, with salaries ranging from $120k to $160k. Would you like to see the full details for any of these?
```

**Prompt:** 
```
What is the salary history for 'Data Scientist' in Great Britain?
```

**Response:** 
```
Accessing historical data for 'Data Scientist' in the GB market... I can see a steady 5% increase in average offered salaries over the last 12 months, with a current peak in vacancy volume in the London area.
```

**Prompt:** 
```
Estimate the salary for a 'Senior DevOps Engineer' with skills in 'Kubernetes, AWS, Terraform' in the UK.
```

**Response:** 
```
Based on the title and specific skills provided, the Jobsworth tool estimates a market salary of approximately £85,000 - £105,000 per year for this profile in the UK market.
```

## Capabilities

### Find specific job postings
Search millions of current jobs using keywords, location filters, and salary requirements.

### Determine market salaries
Predict the typical salary range for a job title or description based on live data feeds.

### Analyze salary trends over time
Retrieve historical records to track how average pay and vacancy volume have changed year-over-year.

### Map regional job demand
Drill into specific geographic areas to identify where the highest need for certain skills exists.

### Identify major employers
Get a list of top companies that are actively recruiting across various sectors or locations.

## Use Cases

### Assessing competitor hiring moves
A recruiter needs to know if their main competitor is suddenly expanding into AI. They use `get_top_companies` to check for spikes in postings, then run a targeted `search_jobs` query combined with `get_categories` to confirm the sector.

### Building an economic forecast
An economist needs to write a report on salary inflation. They call `get_history` for several different fields, then use `get_histogram` to visualize how the average pay has changed over the last five years.

### Optimizing job search strategy
A job seeker is unsure where to move. They ask their agent to run `get_geodata` for 'DevOps Engineer' roles, immediately identifying cities that have high demand and salary potential.

## Benefits

- Pinpoint your value instantly. Use `get_jobsworth` to estimate the current market rate for any role, eliminating salary negotiation guesswork.
- Track economic shifts over time. Running `get_history` lets you see if a skill's value has risen or fallen across multiple years.
- Target high-growth areas. By calling `get_geodata`, you can tell clients exactly which regions are seeing the biggest spike in vacancy volume.
- Understand corporate hiring power. Use `get_top_companies` to see who is aggressively expanding right now, giving you a competitive edge.
- Refine your search scope. First, use `get_categories` to understand what broad sectors dominate the market before running a full `search_jobs` query.

## How It Works

The bottom line is, you get professional-grade labor market intelligence routed straight into your workflow.

1. Subscribe to this MCP, then input your required Adzuna App ID and App Key.
2. Your AI client sends a request (e.g., 'What's the average salary for X?').
3. The MCP processes the query against millions of live listings and returns structured data directly to your agent.

## Frequently Asked Questions

**Can I see the distribution of salaries for a specific job title?**
Yes! Use the `get_histogram` tool with your keywords and country code to see the current salary distribution across the market.

**How do I find which companies are hiring the most in a certain sector?**
You can use the `get_top_companies` tool. Provide the country and optional keywords to get a leaderboard of the top five employers by vacancy count.

**Is it possible to estimate a salary for a job that doesn't have one listed?**
Absolutely. The `get_jobsworth` tool uses Adzuna's algorithms to estimate a salary based on the job title and description keywords you provide.

**When I use `search_jobs`, do I need to worry about API rate limits?**
Yes, there are usage limits applied. If you exceed the quota, your agent will receive a standard 429 error code and must implement an exponential backoff strategy before retrying.

**How do I use `get_categories` to ensure my job search is accurate?**
The `get_categories` tool lists all available employment sectors. You should run this first to get the precise category IDs, which helps narrow down your query and improve search relevance.

**Does `get_geodata` provide real-time vacancy counts for every region?**
No, regional data is based on aggregated historical submissions. While it shows strong trends, the numbers represent market averages rather than live, minute-by-minute vacancy feeds.

**What should I do if `get_history` returns insufficient salary data for a niche job?**
The tool provides the most robust data available from its connected sources. If the data is sparse, it means that specific market segment hasn't submitted enough records to establish a reliable trend line.

**Is there a way to check if my connection works before running `search_jobs`?**
You can run the `get_version` tool first. This confirms API connectivity and tells you which version of the Adzuna engine your agent is currently querying.