Browse the catalog

Enables querying Germany's official statistics from Destatis GENESIS-Online through natural language or direct tool calls.

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 typical salary for a machine learning engineer in the UK?" - "Compare software engineer salaries between London and Manchester" - "How have data scientist salaries changed over the past year?" **Company Research:** - "Which companies are hiring the most software engineers in London?" - "Show me the top employers for finance jobs in New York" ## Tool Details ### search_jobs Search for jobs with comprehensive filtering: ``` Parameters: - country (required): Country code (e.g., "gb", "us") - keywords: Search terms (e.g., "python developer") - location: City, region, or postal code - page: Page number (starts at 1) - results_per_page: Results per page (max 50) - salary_min/salary_max: Annual salary filter - full_time/part_time/contract/permanent: Job type filters - category: Category tag from get_categories - sort_by: "date", "salary", or "relevance" - max_days_old: Maximum listing age in days ``` ### get_categories Get valid category tags before searching: ``` Parameters: - country (required): Country code Returns category tags like "it-jobs", "engineering-jobs", "finance-jobs" ``` ### get_salary_histogram Understand salary distribution: ``` Parameters: - country (required): Country code - keywords: Filter by job type - location: Filter by location - category: Filter by category ``` ### get_top_companies Find major employers: ``` Parameters: - country (required): Country code - keywords: Filter by job type - location: Filter by location - category: Filter by category ``` ### get_geodata Compare salaries across regions: ``` Parameters: - country (required): Country code - keywords: Filter by job type - location: Focus on sub-regions - category: Filter by category ``` ### get_salary_history Analyze salary trends: ``` Parameters: - country (required): Country code - keywords: Filter by job type - location: Filter by location - category: Filter by category - months: Months of history (default 12, max ~24) ``` ## Important Notes - **Salaries are annual amounts** in the local currency of the selected country - **Call `get_categories` first** to get valid category tags for your country - **Many jobs don't list salaries** - salary filters will exclude these jobs - **Rate limits apply** - the Adzuna API has usage limits on free tier ## Project Structure ``` adzuna-mcp/ ├── server.py # Main MCP server ├── pyproject.toml # Package configuration ├── requirements.txt # Python dependencies ├── .env.example # Environment template ├── .env # Your credentials (gitignored) ├── tests/ # Test suite │ ├── __init__.py │ └── test_server.py ├── .github/ │ └── workflows/ │ ├── ci.yml # CI pipeline │ └── publish.yml # PyPI publishing ├── CONTRIBUTING.md # Contribution guide ├── LICENSE ├── .gitignore └── README.md ``` ## Troubleshooting ### Server not appearing in Claude Desktop 1. Check the Python path is correct in your config 2. Ensure the virtual environment has all dependencies installed 3. Restart Claude Desktop completely (Cmd+Q / Alt+F4) 4. Check Claude Desktop logs: `~/Library/Logs/Claude/mcp*.log` ### Authentication errors 1. Verify your API credentials at [Adzuna Developer Portal](https://developer.adzuna.com/) 2. Check the `.env` file has correct values 3. Ensure environment variables are passed in the MCP config ### No results returned 1. Try broader search terms 2. Check the country code is valid 3. Remove salary filters (many jobs don't list salaries) 4. Verify the category tag is valid for that country ## Contributing Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. ## License MIT License - see [LICENSE](LICENSE) for details. ## Acknowledgments - [Adzuna](https://www.adzuna.com/) for providing the job search API - [FastMCP](https://github.com/jlowin/fastmcp) for the MCP framework - [Anthropic](https://www.anthropic.com/) for the Model Context Protocol specification

RAG MCP Server

A Model Context Protocol (MCP) server that provides comprehensive WHOIS lookup capabilities using the IP2WHOIS API. This server allows AI agents to query domain registration details, including expiry dates, registrar information, and registrant data.

A Python MCP server that exposes health metrics from the Sapphire Wellness App to AI assistants, providing tools for activity, blood pressure, glucose, heart rate, sleep, and SpO2 data.

Model Context Protocol server for the Website Toolbox forum platform. Exposes forum REST API tools for managing categories, topics, posts, users, and more.

Lets MCP-capable AI agents interact with the Arcade DEX and launchpad on Circle's Arc L1 to discover markets, get quotes, and execute trades via contract-call descriptors.

The Jupyter MCP Server provides a bridge between AI assistants and Jupyter notebooks, enabling models to programmatically create and execute code cells, add markdown content, and interact with Earth data through specialized tools. Built using the MCP protocol with both stdio and SSE transport options, it leverages the jupyter_kernel_client and jupyter_nbmodel_client libraries to manipulate notebook content and execute code in a running kernel. This implementation is particularly valuable for data science workflows where AI assistants need to generate executable code, document analysis with markdown, or facilitate Earth data retrieval and processing within Jupyter environments.

Provides access to live UK Parliament data through multiple official APIs. Queries bills, Commons and Lords votes, MP profiles, financial interests, and petitions without requiring an API key. Offers a unified interface to Parliament's open data feeds for political research and policy analysis.

MCP server for DemoStudio — lets any MCP-compatible AI assistant generate short-form video ads directly from a conversation.

Enables an agent to run shell commands through a JupyterLab/JupyterHub-hosted terminal, using REST API and WebSocket via Selenium for session handling, when SSH is not available.

Enables interaction with Microsoft Teams chats and channels using official Microsoft Graph API or Power Automate for enterprise environments with restricted permissions.

Wraps sigrok-cli for signal analysis: capture data, decode protocols, and query instruments.

MCP server: parse and stringify CSV (RFC 4180). Header rows, quoting, custom delimiters.

Provides live Greek weather data from EMY, including forecasts, alerts, marine bulletins, warnings, and climate records. Supports location-based queries by name, ID, or coordinates without requiring an API key.

A remote MCP server that provides a counting tool, e.g., to count letters in words.

Run the GreenCalculus MCP server over stdio — sourced carbon emission factors and audit-traced calculations an AI can cite.

MCP server for Shodan API — device search, IP lookup, DNS, and CVE/CPE queries.

MCP proxy that wraps any MCP server and transparently converts JSON responses in tools/call to TOON format — a token-efficient alternative to JSON optimized for LLMs (~40% fewer tokens).

Enables AI CLIs to send alerts to a Zona inbox, including optional categories, severities, and up to five attached images, while keeping the source token local.