Skip to main content
Glama
profesia-mcp

profesia-mcp

by kiko-siska

profesia-mcp

An unofficial Model Context Protocol server for Profesia.sk, the largest Slovak job board. It lets an AI assistant (Claude Desktop, Claude Code, Cursor, …) search jobs, read full offers, bulk-collect results and prepare applications.

Not affiliated with, endorsed by, or sponsored by Profesia.sk / Alma Career. Profesia is a trademark of its owner. Use it in line with Profesia's terms of use and applicable law.

Tools

Tool

What it does

search_jobs

Search offers by keywords, location or category, minimum salary, remote/hybrid/on-site, with paging (20 per page).

get_job

Full offer by id or URL: title, company, location, salary (+ note), contract type, date posted, description and structured sections (requirements, languages, benefits, contact…).

get_application_info

How to apply: apply link(s), contact emails found in the offer, and the "selection process" text.

company_jobs

Open jobs of one employer (pro-hr/C56404).

scrape_jobs

Bulk collection across several pages, optionally with full details (hard caps: 5 pages, 25 detail pages per call).

list_locations / list_job_categories

Valid location / category slugs for search_jobs.

About applying (deliberate design choice)

This server does not submit applications and never touches credentials. Applying on Profesia goes through a logged-in account (or the employer's own site, or plain email), and automating that would mean handling your password and bypassing the site's protections. Instead, get_application_info returns the right link or email, so your assistant can read the offer, draft a tailored CV/cover letter or email, and you send it.

Related MCP server: job-scout-mcp

Quick demo

Once installed, ask your assistant something like:

"I'm a student who can work at most 20 hours a week. Find part-time Python / AI jobs in Bratislava that accept secondary-school students, and tell me how to apply."

It will call search_jobs (e.g. category="na-dohodu-brigady", which is Profesia's part-time / agreement-based section), read the best matches with get_job, check the education requirements, and use get_application_info to give you the apply link or email.

Install

Requires Python 3.10+. With uv:

uvx --from git+https://github.com/kiko-siska/profesia-mcp profesia-mcp

or from a clone: pip install . then run profesia-mcp.

Claude Code

claude mcp add profesia -- uvx --from git+https://github.com/kiko-siska/profesia-mcp profesia-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "profesia": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kiko-siska/profesia-mcp", "profesia-mcp"]
    }
  }
}

Example prompts

  • "Find remote Python jobs on Profesia paying at least 3000 EUR/month and summarise the top 5."

  • "Compare the requirements of these three offers and tell me which fits my CV."

  • "Read offer 5356737 and draft an email application for me in Slovak."

Being a good citizen

The server is intentionally conservative:

  • robots.txt is enforced in code (client.py): disallowed URLs (e.g. anything with count_days=, form=, ajax, print=1, send_cv.php, list_similar_offers.php) are never requested.

  • Rate limit: one request at a time, at least 1 s apart (PROFESIA_MCP_MIN_INTERVAL).

  • Cache: responses are cached for 10 minutes (PROFESIA_MCP_CACHE_TTL).

  • Honest User-Agent that identifies this project. If you fork it, set PROFESIA_MCP_USER_AGENT (and update the default in client.py).

  • Read-only: only GET requests to www.profesia.sk; no login, no form submission.

Please don't use scrape_jobs to mirror the site or republish its content. Offers belong to their employers and to Profesia.

Limitations

  • It parses HTML, which can change without notice; the offline tests in tests/ (saved page fixtures for several different offer layouts, with personal contact details scrubbed) will tell you when a parser breaks.

  • Employers may use custom page designs. Core fields are filled for all layouts tested, but sections is only available for the standard layout, and some large employers' company pages (company_jobs) are custom-built and may return no jobs; use search_jobs with the company name instead.

  • Offer text is in Slovak, English or other languages, depending on the employer.

  • With a keyword search Profesia only offers relevance sorting. The tracking search_id is stripped from URLs.

Development

python -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"
pytest            # offline; uses saved HTML fixtures

Works with mcp 1.x (FastMCP) and 2.x (MCPServer).

License

MIT, see LICENSE.

Available Tools

7 tools
company_jobsA
Read-only

List open jobs of one employer.

Args: company: Company page URL or path such as "https://www.profesia.sk/praca/pro-hr/C56404" or "pro-hr/C56404" (company slug + C-id; both appear in search_jobs / get_job results). page: Page number, starting at 1.

Note: some large employers use custom-designed pages; if no jobs are returned for them, use search_jobs with the company name as query instead.

Inputs: company (required), page. Returns: object

get_application_infoA
Read-only

Find out how to apply for a job, so the user (or you, drafting for them) can apply.

This tool does NOT submit anything and never handles credentials. It returns the apply link(s) (Profesia account login or the employer's own site), any contact emails found in the offer, and the offer's "selection process" text. Typical use: read the offer with get_job, draft a tailored cover letter/email, and hand it to the user to send.

Args: job: Offer id ("5356737", "O5356737") or a profesia.sk offer URL.

Inputs: job (required). Returns: object

get_jobA
Read-only

Get the full details of one job offer.

Args: job: Offer id ("5356737", "O5356737") or a profesia.sk offer URL.

Returns title, company, location, salary (+ note), contract type, date posted, the full description, and sections (requirements, languages, benefits, contact...) when the employer uses the standard layout.

Inputs: job (required). Returns: object

list_job_categoriesA
Read-only

List job position/category slugs usable as category in search_jobs.

Inputs: no named parameters. Returns: result

list_locationsA
Read-only

List location slugs (regions and cities) usable as location in search_jobs.

Inputs: no named parameters. Returns: result

scrape_jobsA
Read-only

Collect many search results at once (optionally with full details for each).

Same filters as search_jobs. Requests are rate-limited (about 1/second), so large jobs are slow on purpose; hard caps: 5 pages and 25 detail pages per call.

Args: max_pages: Result pages to fetch (1-5, 20 offers per page). include_details: Also fetch the full offer page for the first max_details jobs. max_details: How many offers to fetch details for (1-25).

Inputs: query, remote, category, location, +5 more. Returns: object

search_jobsA
Read-only

Search Profesia.sk job offers (20 per page).

Args: query: Free-text keywords, e.g. "python developer". location: Location slug from list_locations, e.g. "bratislava", "kosice", "bratislavsky-kraj". category: Job category slug from list_job_categories, e.g. "java-programator-programatorka". Only one of location / category can be used; put the other in query. salary_min: Minimum salary (EUR) - per month when salary_period="m", per hour when "h". salary_period: "m" monthly or "h" hourly. remote: "onsite" (workplace only), "remote" (home only) or "hybrid" (partly from home). page: Page number, starting at 1.

Returns jobs (id, title, employer, location, salary, labels, posted, url) and has_next. Pass a job id or url to get_job for the full description.

Inputs: page, query, remote, category, +3 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes: search_jobs finds listings, get_job fetches one offer, get_application_info explains how to apply, company_jobs lists an employer's openings, and the list_* tools provide filter slugs. search_jobs and scrape_jobs overlap in filtering, but scrape_jobs is clearly distinguished as a bulk/detail-collection tool with rate limits and caps.

    Naming Consistency4/5

    The set mostly follows a consistent verb_noun snake_case pattern: get_job, search_jobs, get_application_info, list_locations, scrape_jobs, list_job_categories. company_jobs is a minor deviation because it omits the verb and breaks the list_* pattern used by the other listing tools.

    Tool Count5/5

    Seven tools is well-scoped for a job-search server: search, detail, application guidance, company listings, bulk scraping, and two reference-list tools. Each tool earns its place without obvious redundancy or thin coverage.

    Completeness4/5

    The surface covers the core job-discovery lifecycle: find jobs, inspect details, identify filter options, explore employer listings, and learn how to apply. Minor gaps exist, such as no dedicated salary/statistics or saved-search/alert tooling, but agents can work around these for the stated purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for job search and application tracking, enabling AI agents to search jobs, get details, manage applications, and find contacts across 128K+ jobs and 1,900+ companies.
      689 npm
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that scours job openings from public, ToS-clean sources (Greenhouse, Lever, Ashby, HN, RemoteOK, Adzuna, USAJobs) and provides tools for job search, company listings, and salary context.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that exposes job-search and application-management capabilities to compatible AI clients, enabling discovery of vacancies, drafting of tailored application materials, and coordinated human-approved submissions.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      This MCP server lets AI assistants search job listings on Taiwan's 104 Job Bank, read full job details, and prepare applications with human-in-the-loop confirmation before final submission.
      11
      10
      ISC