Voxjobs (Portugal)
Job listings in Portugal: search, salary statistics, comparables and companies.
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~3,744Token（工具定義）
~6.1 KB典型回應大小
顯著的注意力影響（128k 上下文的 2.93%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"voxjobs-pt": {
"url": "https://www.voxjobs.pt/api/mcp"
}
}
}遠端端點
https://www.voxjobs.pt/api/mcpstreamable-http它能做什麼
工具清單
工具（6）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢search_jobs(query, location, remoteMode, seniority, schedule, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "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."
},
"location": {
"type": "string",
"description": "City or region within the market (e.g. Lisbon, Porto, Berlin). Do not include the country — it is set by the host."
},
"remoteMode": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ONSITE"
],
"description": "Work arrangement. REMOTE, HYBRID or ONSITE."
},
"seniority": {
"type": "string",
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE"
],
"description": "Level of the role."
},
"schedule": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"SHIFTS",
"FLEXIBLE"
],
"description": "Hours: FULL_TIME, PART_TIME, SHIFTS or FLEXIBLE."
},
"contractType": {
"type": "string",
"description": "Contract type in market-local vocabulary (e.g. permanent, CDI, B2B, umowa o pracę)."
},
"salaryMinYearly": {
"type": "number",
"description": "Minimum gross yearly salary, in the market currency (EUR, GBP or PLN). Non-yearly periods are normalised."
},
"company": {
"type": "string",
"description": "Restrict to jobs from this employer (free-text name)."
},
"escoCode": {
"type": "string",
"description": "ESCO occupation code (see europa.eu/esco). Optional and precise: when the caller has one, it filters much more sharply than free text."
},
"limit": {
"type": "number",
"description": "Maximum number of results (default 10, max 20)."
}
}
}輸出結構描述
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"currency": {
"type": "string"
},
"total": {
"type": "number",
"description": "Exact number of listings matching the filters."
},
"shown": {
"type": "number"
},
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_job_detail or find_similar_jobs."
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"title": {
"type": "string"
},
"company": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"remoteMode": {
"type": [
"string",
"null"
],
"enum": [
"REMOTE",
"HYBRID",
"ONSITE",
null
]
},
"seniority": {
"type": [
"string",
"null"
],
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE",
null
]
},
"contractType": {
"type": [
"string",
"null"
]
},
"salary": {
"type": "object",
"description": "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net.",
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"max": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
],
"description": "YEAR, MONTH, WEEK, DAY or HOUR."
},
"currency": {
"type": "string"
},
"isEstimated": {
"type": "boolean"
}
},
"required": [
"currency",
"isEstimated"
]
},
"qualityScore": {
"type": [
"number",
"null"
],
"description": "Internal freshness/quality signal (0..1). Higher = better."
},
"postedAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was first published at the source."
},
"lastSeenAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 timestamp when this listing was last confirmed still live at the source. Sources expire listings without notice, so this — not postedAt — is the answer to 'is this still open?'."
}
},
"required": [
"slug",
"url",
"title",
"salary"
]
}
}
},
"required": [
"market",
"currency",
"total",
"shown",
"jobs"
]
}🟢get_salary_stats(escoCode, location, remoteMode, seniority, schedule, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"escoCode": {
"type": "string",
"description": "ESCO occupation code (see europa.eu/esco). Optional and precise: when the caller has one, it filters much more sharply than free text."
},
"location": {
"type": "string",
"description": "City or region within the market (e.g. Lisbon, Porto, Berlin). Do not include the country — it is set by the host."
},
"remoteMode": {
"type": "string",
"enum": [
"REMOTE",
"HYBRID",
"ONSITE"
],
"description": "Work arrangement. REMOTE, HYBRID or ONSITE."
},
"seniority": {
"type": "string",
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE"
],
"description": "Level of the role."
},
"schedule": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"SHIFTS",
"FLEXIBLE"
],
"description": "Hours: FULL_TIME, PART_TIME, SHIFTS or FLEXIBLE."
},
"contractType": {
"type": "string",
"description": "Contract type in market-local vocabulary (e.g. permanent, CDI, B2B, umowa o pracę)."
}
}
}輸出結構描述
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"currency": {
"type": "string"
},
"count": {
"type": "number",
"description": "Listings matching the filters, with or without a published salary."
},
"priced": {
"type": "number",
"description": "Subset that publishes a salary — the base of every figure below. A large gap to `count` means many listings in this slice hide compensation."
},
"salary": {
"type": [
"object",
"null"
],
"description": "Yearly salary distribution, in percentiles. null when no matching listing publishes a salary. There is deliberately no min or max: extremes on a third-party aggregator are set by data errors, not the market.",
"properties": {
"p10": {
"type": "number"
},
"p25": {
"type": "number"
},
"median": {
"type": "number",
"description": "The typical salary — use this to answer 'how much'."
},
"p75": {
"type": "number"
},
"p90": {
"type": "number"
}
}
},
"bySeniority": {
"type": "array",
"description": "Up to 6 most represented seniority levels, each with its own median.",
"items": {
"type": "object",
"properties": {
"seniority": {
"type": "string"
},
"count": {
"type": "number",
"description": "Listings at this seniority."
},
"priced": {
"type": "number",
"description": "How many of those disclose a salary — this, not `count`, is the sample behind `medianSalary`. Most listings do not disclose one, so quote it as the sample size."
},
"medianSalary": {
"type": [
"number",
"null"
]
}
},
"required": [
"seniority",
"count",
"priced"
]
}
}
},
"required": [
"market",
"currency",
"count",
"priced",
"bySeniority"
]
}🟢find_similar_jobs(slug, limit)
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.
輸入結構描述
{
"type": "object",
"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)."
}
},
"required": [
"slug"
]
}輸出結構描述
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"currency": {
"type": "string"
},
"reference": {
"type": "object",
"description": "The listing the comparables are measured against, echoed back for the comparison.",
"properties": {
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_job_detail or find_similar_jobs."
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"title": {
"type": "string"
},
"company": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"remoteMode": {
"type": [
"string",
"null"
],
"enum": [
"REMOTE",
"HYBRID",
"ONSITE",
null
]
},
"seniority": {
"type": [
"string",
"null"
],
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE",
null
]
},
"contractType": {
"type": [
"string",
"null"
]
},
"salary": {
"type": "object",
"description": "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net.",
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"max": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
],
"description": "YEAR, MONTH, WEEK, DAY or HOUR."
},
"currency": {
"type": "string"
},
"isEstimated": {
"type": "boolean"
}
},
"required": [
"currency",
"isEstimated"
]
},
"qualityScore": {
"type": [
"number",
"null"
],
"description": "Internal freshness/quality signal (0..1). Higher = better."
},
"postedAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was first published at the source."
},
"lastSeenAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 timestamp when this listing was last confirmed still live at the source. Sources expire listings without notice, so this — not postedAt — is the answer to 'is this still open?'."
}
}
},
"total": {
"type": "number",
"description": "Comparables returned."
},
"jobs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_job_detail or find_similar_jobs."
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"title": {
"type": "string"
},
"company": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"remoteMode": {
"type": [
"string",
"null"
],
"enum": [
"REMOTE",
"HYBRID",
"ONSITE",
null
]
},
"seniority": {
"type": [
"string",
"null"
],
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE",
null
]
},
"contractType": {
"type": [
"string",
"null"
]
},
"salary": {
"type": "object",
"description": "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net.",
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"max": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
],
"description": "YEAR, MONTH, WEEK, DAY or HOUR."
},
"currency": {
"type": "string"
},
"isEstimated": {
"type": "boolean"
}
},
"required": [
"currency",
"isEstimated"
]
},
"qualityScore": {
"type": [
"number",
"null"
],
"description": "Internal freshness/quality signal (0..1). Higher = better."
},
"postedAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was first published at the source."
},
"lastSeenAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 timestamp when this listing was last confirmed still live at the source. Sources expire listings without notice, so this — not postedAt — is the answer to 'is this still open?'."
}
},
"required": [
"slug",
"url",
"title",
"salary"
]
}
}
},
"required": [
"market",
"reference",
"total",
"jobs"
]
}🟢get_job_detail(slug)
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.
輸入結構描述
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Unique listing slug, as returned by search_jobs."
}
},
"required": [
"slug"
]
}輸出結構描述
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"closed": {
"type": "boolean",
"description": "true when the listing is EXPIRED or REMOVED at the source — recommend it and the user applies for a dead post."
},
"description": {
"type": "string"
},
"employerName": {
"type": [
"string",
"null"
]
},
"company": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"sector": {
"type": [
"string",
"null"
]
},
"websiteDomain": {
"type": [
"string",
"null"
]
}
}
},
"city": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"country": {
"type": "string"
},
"remoteMode": {
"type": [
"string",
"null"
]
},
"seniority": {
"type": [
"string",
"null"
]
},
"schedule": {
"type": [
"string",
"null"
]
},
"contractType": {
"type": [
"string",
"null"
]
},
"languagesRequired": {
"type": "array",
"items": {
"type": "string"
}
},
"salary": {
"type": "object",
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"max": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string"
},
"isGross": {
"type": [
"boolean",
"null"
]
},
"isEstimated": {
"type": "boolean"
}
}
},
"publicSector": {
"type": "boolean"
},
"positionsAvailable": {
"type": [
"number",
"null"
]
},
"educationLevel": {
"type": [
"string",
"null"
]
},
"experience": {
"type": [
"string",
"null"
]
},
"qualityScore": {
"type": [
"number",
"null"
]
},
"postedAt": {
"type": [
"string",
"null"
]
},
"validThrough": {
"type": [
"string",
"null"
]
},
"lastVerifiedAt": {
"type": [
"string",
"null"
]
},
"sourcePlatform": {
"type": [
"string",
"null"
]
},
"applyUrl": {
"type": [
"string",
"null"
],
"description": "Outbound URL. Fallback to sourceUrl when the ATS did not publish a separate apply link."
},
"sourceUrl": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"url",
"title",
"status",
"closed",
"country",
"salary"
]
}🟢search_companies(name, sector, limit)
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.
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Full or partial employer name."
},
"sector": {
"type": "string",
"description": "Sector (e.g. technology, healthcare, retail)."
},
"limit": {
"type": "number",
"description": "Maximum number of results (default 8, max 20)."
}
}
}輸出結構描述
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"total": {
"type": "number"
},
"companies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"sector": {
"type": [
"string",
"null"
]
},
"headquarters": {
"type": [
"string",
"null"
]
},
"sizeBucket": {
"type": [
"string",
"null"
]
},
"activeJobs": {
"type": "number"
}
},
"required": [
"slug",
"name",
"url",
"activeJobs"
]
}
}
},
"required": [
"market",
"total",
"companies"
]
}🟢search_articles(query, limit)
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.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Free-text topic (optional). Empty → the most recent articles."
},
"limit": {
"type": "number",
"description": "Maximum number of results (default 5, max 10)."
}
}
}輸出結構描述
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"articles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"excerpt": {
"type": "string"
},
"category": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"title",
"url"
]
}
}
},
"required": [
"market",
"articles"
]
}社群
證據
近期觀測
已驗證未記錄版本6 個工具
已驗證未記錄版本6 個工具
已驗證未記錄版本6 個工具