Voxjobs (Portugal)

Working · 2.0 s

eu.voxs/voxjobs-ptv1.0.0 Domain verified

Job listings in Portugal: search, salary statistics, comparables and companies.

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://www.voxjobs.pt/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

find_similar_jobs Read-only

Given one job listing, find comparable ones: same occupation family and area, close seniority. Use this when the user likes a role but wants alternatives — 'find me similar jobs', 'the same but remote', 'what else is around'. Comparability is by role (ESCO code) and geography, not by text similarity: it answers 'is there anything else out there for someone with this profile', which a keyword search misses.

slugstring, required

Slug of the reference listing, as returned by search_jobs or get_job_detail.

limitnumber

Maximum number of comparables (default 6, max 20).

Tools (6)

find_similar_jobs

read-only

Argument	Type	Description
slug*	string	Slug of the reference listing, as returned by search_jobs or get_job_detail.
limit	number	Maximum number of comparables (default 6, max 20).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug of the reference listing, as returned by search_jobs or get_job_detail."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of comparables (default 6, max 20)."
    }
  }
}

get_job_detail

Get the complete record of one job listing in Portugal by its slug. Use this after search_jobs when the user asks about a specific role: full description, requirements, salary (gross/net/estimated), employer, contract type and the outbound URL to apply.

read-only

Argument	Type	Description
slug*	string	Unique listing slug, as returned by search_jobs.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Unique listing slug, as returned by search_jobs."
    }
  }
}

get_salary_stats

Get salary statistics for a slice of the Portugal job market: how many listings match, how many publish a salary, the median annual salary, the p25–p75 range and a breakdown by seniority. Use this when the user asks what a role pays, or how two locations/seniorities compare — instead of listing individual jobs. Takes the same filters as search_jobs and describes exactly the set that tool would return. Reports percentiles rather than averages, because job salaries have a long right tail and a single executive listing moves an average. All figures normalised to the yearly period.

read-only

Argument	Type	Description
escoCode	string	ESCO occupation code (see europa.eu/esco). Optional and precise: when the caller has one, it filters much more sharply than free text.
location	string	City or region within the market (e.g. Lisbon, Porto, Berlin). Do not include the country — it is set by the host.
schedule	string	Hours: FULL_TIME, PART_TIME, SHIFTS or FLEXIBLE.
seniority	string	Level of the role.
remoteMode	string	Work arrangement. REMOTE, HYBRID or ONSITE.
contractType	string	Contract type in market-local vocabulary (e.g. permanent, CDI, B2B, umowa o pracę).

Input schema (JSON)

search_articles

Search editorial articles about the Portugal job market: job-hunting guides, salary analysis, career advice. Use this when the user asks how something works — the interview process, an ATS, a specific market or benefit — rather than asking for jobs.

read-only

Argument	Type	Description
limit	number	Maximum number of results (default 5, max 10).
query	string	Free-text topic (optional). Empty → the most recent articles.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default 5, max 10)."
    },
    "query": {
      "type": "string",
      "description": "Free-text topic (optional). Empty → the most recent articles."
    }
  }
}

search_companies

Search employers with active listings in Portugal. Returns sector, headquarters, size band and the number of active jobs in this market. Use this when the user wants to explore who is hiring, or to restrict a subsequent search_jobs by employer.

read-only

Argument	Type	Description
name	string	Full or partial employer name.
limit	number	Maximum number of results (default 8, max 20).
sector	string	Sector (e.g. technology, healthcare, retail).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Full or partial employer name."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default 8, max 20)."
    },
    "sector": {
      "type": "string",
      "description": "Sector (e.g. technology, healthcare, retail)."
    }
  }
}

search_jobs

Search active job listings in Portugal. Use this whenever the user wants to find a job — by title, skills, location, salary or schedule. Combines semantic ranking on the `query` (title/skills) with structural filters. Returns company, city, region, remote mode, seniority, salary and a citable URL, plus `total`: the exact number of listings matching the filters, which makes this useful for market-size questions. Listings are aggregated from ATSs, boards and public-sector portals and refreshed daily; each result carries `postedAt` and `lastSeenAt`. Salaries are published in EUR.

read-only

Argument	Type	Description
limit	number	Maximum number of results (default 10, max 20).
query	string	Free-text semantic hint: job title, skills or field (e.g. 'data engineer', 'react developer', 'marketing manager'). Ranks results by meaning; combine with structural filters.
company	string	Restrict to jobs from this employer (free-text name).
escoCode	string	ESCO occupation code (see europa.eu/esco). Optional and precise: when the caller has one, it filters much more sharply than free text.
location	string	City or region within the market (e.g. Lisbon, Porto, Berlin). Do not include the country — it is set by the host.
schedule	string	Hours: FULL_TIME, PART_TIME, SHIFTS or FLEXIBLE.