jopp
Search open jobs in Switzerland and Liechtenstein and read jopp job briefs.
Should I use this
Quality & Safety
Findings (1)
- LOWin fetch
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"jobs": {
"url": "https://getjopp.app/mcp"
}
}
}Remote endpoints
https://getjopp.app/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢search_jobs(query, cantons, category, role, workloadMin, ...)
Search open jobs in Switzerland and Liechtenstein by keywords and filters. Only jobs whose advert is still online are returned. Returns up to 20 jobs per page, newest first for filter-only searches; keyword searches rank by relevance, favouring recent adverts and mixing companies. Use get_job for a job's full description.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Keywords matched against job title, company and description, with German word forms (e.g. \"Pflegefachfrau\", \"Software Engineer Python\"). All words must match; use OR between alternatives, \"quotes\" for phrases and -word to exclude. Place names match only the text; use cantons to filter by location.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"cantons": {
"description": "Two-letter canton codes (ZH, BE, VD, GE, …) or LI for Liechtenstein.",
"maxItems": 27,
"type": "array",
"items": {
"type": "string",
"enum": [
"AG",
"AI",
"AR",
"BE",
"BL",
"BS",
"FR",
"GE",
"GL",
"GR",
"JU",
"LU",
"NE",
"NW",
"OW",
"SG",
"SH",
"SO",
"SZ",
"TG",
"TI",
"UR",
"VD",
"VS",
"ZG",
"ZH",
"LI"
]
}
},
"category": {
"description": "A category key from list_categories.",
"type": "string",
"maxLength": 60
},
"role": {
"description": "A role key from list_categories; requires its category.",
"type": "string",
"maxLength": 60
},
"workloadMin": {
"description": "Lowest workload in percent of full time (10–100).",
"type": "integer",
"minimum": 10,
"maximum": 100
},
"workloadMax": {
"description": "Highest workload in percent of full time (10–100).",
"type": "integer",
"minimum": 10,
"maximum": 100
},
"workModes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"onsite",
"hybrid",
"remote"
]
}
},
"contractTypes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"permanent",
"temporary",
"internship",
"apprenticeship",
"freelance"
]
}
},
"seniorities": {
"type": "array",
"items": {
"type": "string",
"enum": [
"entry",
"professional",
"senior",
"lead",
"management"
]
}
},
"advertLanguages": {
"description": "Language the advert is written in.",
"type": "array",
"items": {
"type": "string",
"enum": [
"de",
"fr",
"it",
"en",
"other"
]
}
},
"requiredLanguages": {
"description": "Only jobs that require all of these languages.",
"type": "array",
"items": {
"type": "string",
"enum": [
"de",
"fr",
"it",
"en"
]
}
},
"salaryStated": {
"description": "Only jobs whose advert states a salary.",
"type": "boolean"
},
"excludeAgencies": {
"description": "Leave out recruitment agencies.",
"type": "boolean"
},
"publishedWithinDays": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 14
},
{
"type": "number",
"const": 30
}
]
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 20
},
"cursor": {
"description": "nextCursor of a previous search_jobs result; the other arguments are then ignored.",
"type": "string",
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"total": {
"type": "number",
"description": "How many open jobs match."
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string",
"description": "The job on getjopp.app."
},
"title": {
"type": "string"
},
"company": {
"type": "string"
},
"isAgency": {
"type": "boolean",
"description": "True when a recruitment agency posted the job."
},
"locations": {
"type": "array",
"items": {
"type": "string"
}
},
"workload": {
"description": "Workload in percent of full time, e.g. \"80–100 %\".",
"type": [
"string",
"null"
]
},
"workMode": {
"anyOf": [
{
"type": "string",
"enum": [
"onsite",
"hybrid",
"remote"
]
},
{
"type": "null"
}
]
},
"contractType": {
"anyOf": [
{
"type": "string",
"enum": [
"permanent",
"temporary",
"internship",
"apprenticeship",
"freelance"
]
},
{
"type": "null"
}
]
},
"seniority": {
"anyOf": [
{
"type": "string",
"enum": [
"entry",
"professional",
"senior",
"lead",
"management"
]
},
{
"type": "null"
}
]
},
"salary": {
"description": "Salary as stated in the advert, if any.",
"type": [
"string",
"null"
]
},
"summary": {
"type": "string",
"description": "A short excerpt of the job description."
},
"publishedAt": {
"description": "ISO date the job was published or first seen.",
"type": [
"string",
"null"
]
},
"lastSeenAt": {
"description": "ISO date jopp last saw the advert online; a job is listed only while it is.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"url",
"title",
"company",
"isAgency",
"locations",
"workload",
"workMode",
"contractType",
"seniority",
"salary",
"summary",
"publishedAt",
"lastSeenAt"
],
"additionalProperties": false
}
},
"nextCursor": {
"description": "Pass as cursor for the next page; null at the end.",
"type": [
"string",
"null"
]
},
"searchUrl": {
"type": "string",
"description": "The same search on getjopp.app."
}
},
"required": [
"total",
"results",
"nextCursor",
"searchUrl"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_job(id)
Full details of one job by its id from search_jobs: facts, salary, description (usually a jopp brief) and the link to the original advert.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 100,
"description": "The job id from search_jobs."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string",
"description": "The job on getjopp.app."
},
"applyUrl": {
"type": "string",
"description": "The original advert: the employer's or source's page to read it in full and apply."
},
"status": {
"type": "string",
"enum": [
"open",
"closed"
]
},
"title": {
"type": "string"
},
"company": {
"type": "string"
},
"isAgency": {
"type": "boolean"
},
"locations": {
"type": "array",
"items": {
"type": "string"
}
},
"workload": {
"type": [
"string",
"null"
]
},
"workMode": {
"anyOf": [
{
"type": "string",
"enum": [
"onsite",
"hybrid",
"remote"
]
},
{
"type": "null"
}
]
},
"contractType": {
"anyOf": [
{
"type": "string",
"enum": [
"permanent",
"temporary",
"internship",
"apprenticeship",
"freelance"
]
},
{
"type": "null"
}
]
},
"seniority": {
"anyOf": [
{
"type": "string",
"enum": [
"entry",
"professional",
"senior",
"lead",
"management"
]
},
{
"type": "null"
}
]
},
"offerKind": {
"anyOf": [
{
"type": "string",
"enum": [
"job",
"apprenticeship",
"internship",
"trainee",
"working_student",
"freelance",
"not_a_job",
"unknown"
]
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"role": {
"anyOf": [
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"industry": {
"type": [
"string",
"null"
]
},
"start": {
"description": "An ISO date, \"immediately\" or \"by_agreement\".",
"type": [
"string",
"null"
]
},
"leadership": {
"anyOf": [
{
"type": "string",
"enum": [
"team_lead",
"people_manager"
]
},
{
"type": "null"
}
]
},
"education": {
"description": "Lowest education the advert asks for.",
"type": [
"string",
"null"
]
},
"experience": {
"description": "Years of experience the advert asks for.",
"type": [
"string",
"null"
]
},
"requiredLanguages": {
"type": "array",
"items": {
"type": "string"
}
},
"advantageLanguages": {
"type": "array",
"items": {
"type": "string"
}
},
"salary": {
"anyOf": [
{
"type": "object",
"properties": {
"basis": {
"type": "string",
"enum": [
"stated",
"estimated"
]
},
"text": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string"
},
"min": {
"type": [
"number",
"null"
]
},
"max": {
"type": [
"number",
"null"
]
},
"period": {
"type": [
"string",
"null"
]
}
},
"required": [
"basis",
"text",
"currency",
"min",
"max",
"period"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "\"stated\" comes from the advert. \"estimated\" is a jopp estimate of the yearly salary at 100 % workload and is not from the advert."
},
"language": {
"anyOf": [
{
"type": "string",
"enum": [
"de",
"fr",
"it",
"en",
"other"
]
},
{
"type": "null"
}
],
"description": "Language of title and description."
},
"description": {
"type": "string",
"description": "Markdown. Usually jopp's brief, a factual summary of the advert; the original advert at applyUrl is authoritative."
},
"publishedAt": {
"type": [
"string",
"null"
]
},
"lastSeenAt": {
"description": "ISO date jopp last saw the advert online.",
"type": [
"string",
"null"
]
},
"withJoppAccount": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"signInUrl": {
"type": "string"
}
},
"required": [
"text",
"signInUrl"
],
"additionalProperties": false,
"description": "What a person can do with this job after signing in to jopp."
}
},
"required": [
"id",
"url",
"applyUrl",
"status",
"title",
"company",
"isAgency",
"locations",
"workload",
"workMode",
"contractType",
"seniority",
"offerKind",
"category",
"role",
"industry",
"start",
"leadership",
"education",
"experience",
"requiredLanguages",
"advantageLanguages",
"salary",
"language",
"description",
"publishedAt",
"lastSeenAt",
"withJoppAccount"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_categories(category)
jopp's occupation categories and their roles, for the category and role filters of search_jobs. Pass a category key to get its roles with typical job titles.
Input Schema
{
"type": "object",
"properties": {
"category": {
"description": "A category key to list its roles in detail.",
"type": "string",
"maxLength": 60
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"examples": {
"type": "string"
},
"roles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"examples": {
"type": "string"
}
},
"required": [
"key",
"label"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"label",
"examples",
"roles"
],
"additionalProperties": false
}
}
},
"required": [
"categories"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢search(query)
Keyword search over open jobs in Switzerland; returns ids, titles and links. search_jobs offers filters and more fields.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords, e.g. \"Pflegefachfrau Bern\"."
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"results"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢fetch(id)
The full text of one job by its id from search, as a readable document.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 100,
"description": "The job id from search."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string"
},
"url": {
"type": "string"
},
"metadata": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"id",
"title",
"text",
"url",
"metadata"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence