Voxjobs MCP
This MCP server provides public access to the Voxjobs job catalog, enabling AI agents to search for job vacancies, retrieve salary statistics, find similar jobs, get detailed job information, search for companies, and read editorial articles in real-time without requiring authentication.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://www.voxjobs.pt/api/mcpWhat its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to voxs.eu ·
- Passed Endpoint and vendor documentation share a domain
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search for job vacancies using filters like city, seniority, and remote status
- Retrieve salary statistics and comparable job data
- Search for companies currently hiring in specific regions
- Read editorial articles and market insights
Source and maintenance
Protocol and capabilities
- Server
- voxjobs-pt 1.0.0
- MCP protocol negotiated in check
- 2024-11-05
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {}
}Tools
6 advertised
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.
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of results (default 10, max 20)."
},
"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."
},
"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."
},
"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."
},
"schedule": {
"enum": [
"FULL_TIME",
"PART_TIME",
"SHIFTS",
"FLEXIBLE"
],
"type": "string",
"description": "Hours: FULL_TIME, PART_TIME, SHIFTS or FLEXIBLE."
},
"seniority": {
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE"
],
"type": "string",
"description": "Level of the role."
},
"remoteMode": {
"enum": [
"REMOTE",
"HYBRID",
"ONSITE"
],
"type": "string",
"description": "Work arrangement. REMOTE, HYBRID or ONSITE."
},
"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."
}
}
}{
"type": "object",
"required": [
"market",
"currency",
"total",
"shown",
"jobs"
],
"properties": {
"jobs": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"url",
"title",
"salary"
],
"properties": {
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"city": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_job_detail or find_similar_jobs."
},
"title": {
"type": "string"
},
"region": {
"type": [
"string",
"null"
]
},
"salary": {
"type": "object",
"required": [
"currency",
"isEstimated"
],
"properties": {
"max": {
"type": [
"number",
"null"
]
},
"min": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
],
"description": "YEAR, MONTH, WEEK, DAY or HOUR."
},
"currency": {
"type": "string"
},
"isEstimated": {
"type": "boolean"
}
},
"description": "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net."
},
"company": {
"type": [
"string",
"null"
]
},
"postedAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was first published at the source."
},
"seniority": {
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE",
null
],
"type": [
"string",
"null"
]
},
"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?'."
},
"remoteMode": {
"enum": [
"REMOTE",
"HYBRID",
"ONSITE",
null
],
"type": [
"string",
"null"
]
},
"contractType": {
"type": [
"string",
"null"
]
},
"qualityScore": {
"type": [
"number",
"null"
],
"description": "Internal freshness/quality signal (0..1). Higher = better."
}
}
}
},
"shown": {
"type": "number"
},
"total": {
"type": "number",
"description": "Exact number of listings matching the filters."
},
"market": {
"type": "string"
},
"currency": {
"type": "string"
}
}
}{
"title": "Search jobs in Portugal",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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."
},
"schedule": {
"enum": [
"FULL_TIME",
"PART_TIME",
"SHIFTS",
"FLEXIBLE"
],
"type": "string",
"description": "Hours: FULL_TIME, PART_TIME, SHIFTS or FLEXIBLE."
},
"seniority": {
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE"
],
"type": "string",
"description": "Level of the role."
},
"remoteMode": {
"enum": [
"REMOTE",
"HYBRID",
"ONSITE"
],
"type": "string",
"description": "Work arrangement. REMOTE, HYBRID or ONSITE."
},
"contractType": {
"type": "string",
"description": "Contract type in market-local vocabulary (e.g. permanent, CDI, B2B, umowa o pracę)."
}
}
}{
"type": "object",
"required": [
"market",
"currency",
"count",
"priced",
"bySeniority"
],
"properties": {
"count": {
"type": "number",
"description": "Listings matching the filters, with or without a published salary."
},
"market": {
"type": "string"
},
"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"
],
"properties": {
"p10": {
"type": "number"
},
"p25": {
"type": "number"
},
"p75": {
"type": "number"
},
"p90": {
"type": "number"
},
"median": {
"type": "number",
"description": "The typical salary — use this to answer 'how much'."
}
},
"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."
},
"currency": {
"type": "string"
},
"bySeniority": {
"type": "array",
"items": {
"type": "object",
"required": [
"seniority",
"count",
"priced"
],
"properties": {
"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."
},
"seniority": {
"type": "string"
},
"medianSalary": {
"type": [
"number",
"null"
]
}
}
},
"description": "Up to 6 most represented seniority levels, each with its own median."
}
}
}{
"title": "Salary statistics for Portugal",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_similar_jobs
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",
"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)."
}
}
}{
"type": "object",
"required": [
"market",
"reference",
"total",
"jobs"
],
"properties": {
"jobs": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"url",
"title",
"salary"
],
"properties": {
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"city": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_job_detail or find_similar_jobs."
},
"title": {
"type": "string"
},
"region": {
"type": [
"string",
"null"
]
},
"salary": {
"type": "object",
"required": [
"currency",
"isEstimated"
],
"properties": {
"max": {
"type": [
"number",
"null"
]
},
"min": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
],
"description": "YEAR, MONTH, WEEK, DAY or HOUR."
},
"currency": {
"type": "string"
},
"isEstimated": {
"type": "boolean"
}
},
"description": "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net."
},
"company": {
"type": [
"string",
"null"
]
},
"postedAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was first published at the source."
},
"seniority": {
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE",
null
],
"type": [
"string",
"null"
]
},
"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?'."
},
"remoteMode": {
"enum": [
"REMOTE",
"HYBRID",
"ONSITE",
null
],
"type": [
"string",
"null"
]
},
"contractType": {
"type": [
"string",
"null"
]
},
"qualityScore": {
"type": [
"number",
"null"
],
"description": "Internal freshness/quality signal (0..1). Higher = better."
}
}
}
},
"total": {
"type": "number",
"description": "Comparables returned."
},
"market": {
"type": "string"
},
"currency": {
"type": "string"
},
"reference": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"city": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_job_detail or find_similar_jobs."
},
"title": {
"type": "string"
},
"region": {
"type": [
"string",
"null"
]
},
"salary": {
"type": "object",
"required": [
"currency",
"isEstimated"
],
"properties": {
"max": {
"type": [
"number",
"null"
]
},
"min": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
],
"description": "YEAR, MONTH, WEEK, DAY or HOUR."
},
"currency": {
"type": "string"
},
"isEstimated": {
"type": "boolean"
}
},
"description": "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net."
},
"company": {
"type": [
"string",
"null"
]
},
"postedAt": {
"type": [
"string",
"null"
],
"description": "ISO 8601 date the listing was first published at the source."
},
"seniority": {
"enum": [
"INTERNSHIP",
"JUNIOR",
"MID",
"SENIOR",
"LEAD",
"EXECUTIVE",
null
],
"type": [
"string",
"null"
]
},
"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?'."
},
"remoteMode": {
"enum": [
"REMOTE",
"HYBRID",
"ONSITE",
null
],
"type": [
"string",
"null"
]
},
"contractType": {
"type": [
"string",
"null"
]
},
"qualityScore": {
"type": [
"number",
"null"
],
"description": "Internal freshness/quality signal (0..1). Higher = better."
}
},
"description": "The listing the comparables are measured against, echoed back for the comparison."
}
}
}{
"title": "Find comparable jobs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Unique listing slug, as returned by search_jobs."
}
}
}{
"type": "object",
"required": [
"slug",
"url",
"title",
"status",
"closed",
"country",
"salary"
],
"properties": {
"url": {
"type": "string"
},
"city": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"title": {
"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."
},
"region": {
"type": [
"string",
"null"
]
},
"salary": {
"type": "object",
"properties": {
"max": {
"type": [
"number",
"null"
]
},
"min": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
]
},
"isGross": {
"type": [
"boolean",
"null"
]
},
"currency": {
"type": "string"
},
"isEstimated": {
"type": "boolean"
}
}
},
"status": {
"type": "string"
},
"company": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"sector": {
"type": [
"string",
"null"
]
},
"websiteDomain": {
"type": [
"string",
"null"
]
}
}
},
"country": {
"type": "string"
},
"applyUrl": {
"type": [
"string",
"null"
],
"description": "Outbound URL. Fallback to sourceUrl when the ATS did not publish a separate apply link."
},
"postedAt": {
"type": [
"string",
"null"
]
},
"schedule": {
"type": [
"string",
"null"
]
},
"seniority": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
]
},
"experience": {
"type": [
"string",
"null"
]
},
"remoteMode": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
},
"contractType": {
"type": [
"string",
"null"
]
},
"employerName": {
"type": [
"string",
"null"
]
},
"publicSector": {
"type": "boolean"
},
"qualityScore": {
"type": [
"number",
"null"
]
},
"validThrough": {
"type": [
"string",
"null"
]
},
"educationLevel": {
"type": [
"string",
"null"
]
},
"lastVerifiedAt": {
"type": [
"string",
"null"
]
},
"sourcePlatform": {
"type": [
"string",
"null"
]
},
"languagesRequired": {
"type": "array",
"items": {
"type": "string"
}
},
"positionsAvailable": {
"type": [
"number",
"null"
]
}
}
}{
"title": "Get job detail",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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)."
}
}
}{
"type": "object",
"required": [
"market",
"total",
"companies"
],
"properties": {
"total": {
"type": "number"
},
"market": {
"type": "string"
},
"companies": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"name",
"url",
"activeJobs"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"sector": {
"type": [
"string",
"null"
]
},
"activeJobs": {
"type": "number"
},
"sizeBucket": {
"type": [
"string",
"null"
]
},
"headquarters": {
"type": [
"string",
"null"
]
}
}
}
}
}
}{
"title": "Search employers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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."
}
}
}{
"type": "object",
"required": [
"market",
"articles"
],
"properties": {
"market": {
"type": "string"
},
"articles": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"url"
],
"properties": {
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"excerpt": {
"type": "string"
},
"category": {
"type": "string"
}
}
}
}
}
}{
"title": "Search articles",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1036 ms
- 95th percentile latency
- 1036 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1036 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http voxjobs-mcp https://www.voxjobs.pt/api/mcpCodex
codex mcp add voxjobs-mcp --url https://www.voxjobs.pt/api/mcpCursor
{
"mcpServers": {
"voxjobs-mcp": {
"url": "https://www.voxjobs.pt/api/mcp"
}
}
}Cline
{
"mcpServers": {
"voxjobs-mcp": {
"type": "streamableHttp",
"url": "https://www.voxjobs.pt/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"voxjobs-mcp": {
"type": "http",
"url": "https://www.voxjobs.pt/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http voxjobs-mcp https://www.voxjobs.pt/api/mcpClaude Desktop
https://www.voxjobs.pt/api/mcpWindsurf
{
"mcpServers": {
"voxjobs-mcp": {
"serverUrl": "https://www.voxjobs.pt/api/mcp"
}
}
}Let your agent find its tools
Find servers like Voxjobs MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other productivity and knowledge servers
Do you run Voxjobs MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.