Skip to main content

​
Usage Examples

Learn how to effectively use the Hexjobs MCP server with real-world examples.

​
Simple Text Search

Search for jobs using natural language:
The AI assistant will use the search tool with:
  • query: “python developer”
  • Returns top 20 matching offers

​
Search by Company

Look for positions at specific companies:
Uses:
  • companies: [“Google”]
  • Returns all available positions

​
Single City

Parameters:
  • query: “IT”
  • country: “PL”
  • cities: [“Warszawa”]

​
Multiple Cities

Parameters:
  • categories: [“Marketing”]
  • country: “PL”
  • cities: [“Kraków”, “Wrocław”]

​
Remote Jobs

Parameters:
  • query: “developer”
  • experience_levels: [“senior”]
  • is_remote: true
  • work_modes: [“remote”]

​
Advanced Filtering

​
Salary Filter

Parameters:
  • categories: [“IT”]
  • country: “DE”
  • min_salary: 5000

​
Multiple Criteria

Parameters:
  • query: “python developer”
  • experience_levels: [“senior”]
  • contract_types: [“B2B”]
  • cities: [“Warszawa”]
  • work_modes: [“remote”]
  • min_salary: 20000
  • country: “PL”

​
Experience Level

Parameters:
  • query: “frontend developer”
  • experience_levels: [“junior”]

​
Market Analysis

​
Category Overview

Uses available_categories tool to show all categories with counts.

​
Regional Statistics

Combines:
  1. available_countries - get all countries
  2. offers_count for each country with categories: [“IT”]
Uses available_categories and sorts by count.

​
Specific Job Details

​
Get Full Job Description

Uses offer tool with:
  • slug: “python-developer-techcorp-123”
Returns complete job information including:
  • Full description
  • Requirements
  • Benefits
  • Company info
  • AI-generated insights

​
Complex Queries

Two separate searches:
  1. country: “PL”, query: “CTO”
  2. country: “DE”, query: “CTO”
Combined and deduplicated results.

​
Hybrid Work Analysis

Uses offers_count with:
  • categories: [“IT”]
  • experience_levels: [“senior”]
  • work_modes: [“hybrid”]
  • cities: [“Warszawa”]
  • country: “PL”

​
Salary Comparison

Multiple search calls:
  1. Warsaw: query: “python”, cities: [“Warszawa”]
  2. Kraków: query: “python”, cities: [“Kraków”]
Analyze salary ranges from results.

​
Workflow Examples

​
Daily Job Alerts

Set up AI assistant to check daily:
Uses:
  • search with appropriate filters
  • Assistant can track previously seen offers
  • Notify only about new positions

​
Career Path Exploration

Multiple searches:
  1. experience_levels: [“junior”]
  2. experience_levels: [“mid”]
  3. experience_levels: [“senior”]
Compare requirements and salaries.

​
Company Research

Uses:
  • search with companies: [“TechCorp”]
  • Group results by category
  • Analyze common requirements

​
Tips for Better Results

Use natural language - The semantic search understands context, so “looking for a leadership role in technology” works as well as “CTO position”.
Combine filters - More specific filters lead to more relevant results. Don’t hesitate to use multiple criteria.
Check market data first - Use available_* tools to see what values are valid for filters before searching.
Mind the limit - Default is 20 results, max is 100. For broader searches, use pagination with offset.

​
Sample Conversations

​
Job Seeker

1

Initial Search

“I’m looking for Python developer jobs in Warsaw”
2

Refine

“Show me only senior positions with remote work”
3

Details

“Tell me more about the first job in the list”
4

Compare

“What’s the salary range for similar positions in Kraków?”

​
Recruiter

1

Market Overview

“How many IT jobs are currently available in Poland?”
2

Category Breakdown

“What are the most popular IT subcategories?”
3

Salary Analysis

“What’s the average salary for senior developers in Warsaw?”
4

Competition

“How many companies are hiring for similar positions?”

​
Developer

1

Skill Check

“Find jobs that require Python and Django”
2

Location

“Which cities have the most of these positions?”
3

Compensation

“Show me only B2B contracts with salary above 20000”
4

Apply

“Give me the application link for the top result”

​
Integration Patterns

​
Slack Bot

Create a Slack bot that queries Hexjobs:
Bot uses MCP to search and format results for Slack.

​
Email Digest

Weekly email with matching jobs:
  1. Store user preferences (skills, location, salary)
  2. Weekly cron job queries via MCP
  3. Format and send email with new matches

​
Custom Dashboard

Build a dashboard showing:
  • Job count trends by category
  • Salary ranges over time
  • Top hiring companies
  • Regional distribution
All data fetched via MCP tools.