WorkMCP
Uses the Algolia search API to query Hacker News for automation signals related to roles, tasks, and skills.
Retrieves job postings directly from public Greenhouse career-site feeds, including structured job-board metadata such as department, seniority, and employment type where available.
Exports the job knowledge graph as Neo4j Cypher so it can be loaded into Neo4j.
Retrieves job postings directly from public Personio career-site feeds, including structured job-board metadata such as department, seniority, and employment type where available.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WorkMCP get role context for Buchhalter in Berlin including salary and skills"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WorkMCP – Job-Graph Deutschland als MCP-Server
WorkMCP ist eine MCP-Kontextschicht für Rollen, Aufgaben und Automatisierung. Agent-Harnesses wie Claude Code, OpenCode oder Copilot Studio erhalten darüber Stellenanzeigen, Berufe, Aufgaben, Skills, Gehälter und Automatisierungssignale aus öffentlichen Quellen. Jeder Abruf wird lokal gemerkt. Neue und geänderte Daten werden versioniert ergänzt, nichts wird stillschweigend überschrieben.
Rechtlicher Hinweis: WorkMCP ist keine Rechtsberatung. Lizenzen und Nutzungsbedingungen der Datenquellen müssen Nutzende selbst prüfen. Eine Haftung für die Nutzung ist ausgeschlossen, soweit gesetzlich zulässig. Details stehen auf der Landingpage und im Rechtlichen Hinweis.
Was der Server kann
Stellenanzeigen aus drei sich ergänzenden Volltextquellen:
BA-Jobsuche als Deutschland-Kern.
Arbeitnow mit aggregierten ATS-Feeds, Remote- und Visa-Filter.
ATS-Karriereseiten direkt (Greenhouse, Lever, Ashby, Workable, Recruitee, Personio, SmartRecruiters, BambooHR, Workday) mit Abteilung, Seniority und Anstellungsart.
Berufe und Aufgaben:
BERUFENET mit Aufgaben, Tätigkeitsfeldern und KldB-Code.
ESCO mit essential/optional Skills und ISCO-Gruppe.
O*NET Task Statements (Core/Supplemental).
KldB 2010 inklusive Hierarchie als Jobfamilien.
Crosswalks KldB ↔ ISCO-08 ↔ ESCO ↔ O*NET ↔ BERUFENET, auch über mehrere Stufen.
Gehälter:
Amtliche Medianentgelte mit Quartilen aus dem Entgeltatlas der BA.
Optional Gehalts-Histogramme aus Adzuna (kostenloser Key).
Automatisierungssignale aus Hacker News. Aufgaben, Skills und Bewertungen speichert das Modell mit
record_extractionversioniert im Graphen.Rollenkontext in einem Aufruf (
get_role_context): Zuordnung, Aufgaben, Skills, Gehalt und Marktsignal.Job-Graph mit Knoten, Kanten und Herkunft, exportierbar als JSON, Neo4j-Cypher, GraphML oder als Archivy-Wissensdatenbank.
check_sourcesprüft die Erreichbarkeit aller Quellen vom eigenen Rechner aus.
Related MCP server: CodeMind
Schnellstart
Voraussetzungen: Python ≥ 3.10 und uv.
Claude Code (stdio, lokal):
claude mcp add workmcp -- uvx --from git+https://github.com/GodModeAI2025/WorkMCP workmcpMit eigenem Speicherort der Wissensdatenbank:
claude mcp add --transport stdio workmcp --env WORKMCP_DB=$HOME/.workmcp/knowledge.db -- uvx --from git+https://github.com/GodModeAI2025/WorkMCP workmcpAus einem lokalen Klon:
git clone https://github.com/GodModeAI2025/WorkMCP.gitclaude mcp add workmcp -- uv --directory /pfad/zu/WorkMCP run workmcpZentral über Streamable HTTP (ein Server für mehrere Harnesses):
uvx --from git+https://github.com/GodModeAI2025/WorkMCP workmcp --transport streamable-http --host 0.0.0.0 --port 8000claude mcp add --transport http workmcp http://<server>:8000/mcpDer HTTP-Modus hat keine eigene Authentifizierung. Betreibe ihn nur im internen Netz oder hinter einem Reverse Proxy mit Zugangsschutz. Mit --allowed-host mcp.firma.de (mehrfach möglich) oder WORKMCP_ALLOWED_HOSTS prüft der Server zusätzlich den Host-Header (Schutz vor DNS-Rebinding). Das Compose-Setup aktiviert diese Prüfung standardmäßig für localhost.
Docker: WorkMCP und Archivy zusammen (zentraler MCP-Server plus Wissensdatenbank mit vorinstallierter Doku):
cp .env.example .envdocker compose up -d --buildArchivy: http://localhost:5000 (Login aus
.env). Die Doku liegt im Ordner WorkMCP.WorkMCP:
http://localhost:8000/mcp, in Claude Code mitclaude mcp add --transport http workmcp http://localhost:8000/mcp.export_knowledge('archivy')schreibt die gemerkten Berufe direkt in denselben Archivy-Ordner. Beide Container teilen sich das Archivy-Volume (WORKMCP_ARCHIVY_DIR=/archivy/data).Beide Ports sind nur an 127.0.0.1 gebunden. Bei Docker-Hub-Rate-Limits lassen sich in
.envSpiegel-Images setzen (ARCHIVY_PYTHON_IMAGE,WORKMCP_PYTHON_IMAGE).Getestet am 29.10.2026 mit Docker 29.9 und Compose v5.6: Start ohne Assistent, Login, Doku-Notizen sichtbar, Export aus WorkMCP erscheint sofort in Archivy, Neustart idempotent.
Projektkonfiguration .mcp.json:
{
"mcpServers": {
"workmcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/GodModeAI2025/WorkMCP", "workmcp"],
"env": { "WORKMCP_DB": "~/.workmcp/knowledge.db" }
}
}
}OpenCode (opencode.json):
{
"mcp": {
"workmcp": {
"type": "local",
"command": ["uvx", "--from", "git+https://github.com/GodModeAI2025/WorkMCP", "workmcp"],
"enabled": true
}
}
}Erste Schritte im Harness:
check_sourcesprüft, ob alle Quellen erreichbar sind.import_reference_data('onet')lädt die O*NET-Aufgaben einmalig, die Version wird automatisch erkannt.get_role_context('Buchhalter', ort='Berlin')liefert den ersten Rollenkontext.
Gedächtnis: merken und ergänzen
Situation | Verhalten |
Neuer Datensatz | wird gespeichert (Version 1, Ereignis |
Geänderter Datensatz | neue Version, alte Version bleibt erhalten, feldgenaues Diff ( |
Unveränderter Datensatz | nur „zuletzt gesehen“ und der Abrufzähler werden aktualisiert |
Anzeige nicht mehr abrufbar (404) | Status |
Wiederholte Anfrage innerhalb der TTL | Antwort aus dem Speicher ( |
Quelle nicht erreichbar | letzter gespeicherter Stand mit Warnung |
| frischer Abruf; das Delta zeigt |
Offline-Modus ( | nur Gedächtnis, keine Netzzugriffe |
Werkzeuge zum Gedächtnis:
get_changes(seit='7d'): Änderungsprotokoll.get_history(...): alle Versionen eines Datensatzes.search_knowledge(...): Volltextsuche offline.knowledge_stats(): Überblick.remember(...): eigene Daten wie interne Rollenprofile oder Expertenfeedback, ebenfalls versioniert.
Tools
Bereich | Tools |
Stellen |
|
Berufe |
|
Gehalt |
|
Automatisierung |
|
Gedächtnis |
|
Daten und Betrieb |
|
Dazu kommt der Prompt rollen_analyse(rolle, ort). Er führt durch den Ablauf Rolle → Aufgaben → Automatisierung. Die vollständige Referenz steht in docs/archivy/WorkMCP/910004-Tools-Referenz.md.
Datenquellen
Alle integrierten Quellen sind kostenlos. Kostenpflichtige APIs wie Apify werden bewusst nicht genutzt.
Quelle | Zugang | Hinweise zu Lizenz und Bedingungen (selbst prüfen!) |
BA-Jobsuche, BERUFENET, Entgeltatlas | JSON-Backends der BA-Web-Apps, öffentliche Client-IDs | Keine offiziell angebotene API, dokumentiert von bundesAPI. Endpunkte können sich ändern. Entgeltatlas: „Statistik der Bundesagentur für Arbeit“ als Quelle angeben. |
ESCO | Web-API der EU-Kommission | Nutzungsbedingungen des ESCO-Portals, Quellenangabe |
O*NET | Datenbank-Download (Text) | CC BY 4.0, Namensnennung von USDOL/ETA erforderlich; O*NET® ist eine Marke von USDOL/ETA |
KldB 2010, Umsteigeschlüssel KldB→ISCO-08 | Datei der BA-Statistik (Import) | Quellenangabe Bundesagentur für Arbeit |
ESCO↔O*NET-Crosswalk | Datei vom ESCO-Portal oder O*NET (Import) | Bedingungen der Herausgeber |
Arbeitnow | kostenlose API ohne Key | Bedingungen von Arbeitnow |
ATS-Job-Boards | öffentliche Karriereseiten-Feeds ohne Login | robots.txt und Bedingungen der Arbeitgeber und ATS-Anbieter, schonend abrufen |
Adzuna (optional) | kostenloser Developer-Key | Adzuna-API-Bedingungen, u. a. Verlinkung über |
Hacker News | Algolia-Such-API | Inhalte gehören den Verfassenden |
Common Crawl | URL-Index und WARC-Abruf | Common Crawl Terms of Use; Urheberrecht der Seitenbetreiber |
Nicht integriert sind LinkedIn, Indeed, StepStone und XING: keine Lese-API, Scraping verbieten die AGB. Ebenso Interamt (keine Lese-API) und Apify (kostenpflichtig). Die Einordnung steht im Faktencheck.
Datenschutz: Stellenanzeigen können personenbezogene Daten enthalten. Felder mit Kontaktpersonen, Telefonnummern, E-Mail-Adressen und Bewerbungsangaben werden vor dem Speichern entfernt. Mit WORKMCP_STORE_PERSONAL_DATA=1 lässt sich das abschalten; dann ist DSGVO-Konformität selbst sicherzustellen.
Referenzdaten importieren
import_reference_data('onet') # automatisch neueste Version, CC BY 4.0
import_reference_data('kldb', quelle='/pfad/kldb2010.xlsx') # KldB-2010-Systematik (Fassung 2020)
import_reference_data('kldb_isco', quelle='/pfad/umsteiger.xlsx')
import_reference_data('esco_onet', quelle='/pfad/esco_onet.csv')Herkunft der Dateien:
KldB-Systematik: BA-Statistik → KldB 2010 Fassung 2020 → Systematik-Verzeichnisse.
Umsteigeschlüssel KldB→ISCO-08: BA-Statistik → Arbeitsmittel.
ESCO↔O*NET: ESCO „Other crosswalks“ oder O*NET Crosswalk Files.
Die Spalten werden an Kopfzeilen und Wertformen erkannt, Titelzeilen stören nicht. Wiederholte Importe melden neue, geänderte und entfallene Einträge, etwa zwischen zwei O*NET-Releases.
Konfiguration
Variable | Standard | Bedeutung |
|
| Wissensdatenbank (SQLite) |
|
| nur Gedächtnis, keine Netzzugriffe |
| 6 / 24 / 24 | Gültigkeitsdauer für Stellen, Details und Signale |
| 30 | Gültigkeitsdauer für Berufe und Referenzdaten |
|
| Sprache für ESCO |
| – | z. B. |
| automatisch | z. B. |
| – | aktiviert Adzuna (kostenloser Key) |
|
| Kontaktfelder aus Stellenanzeigen speichern |
| – | Standardquellen für den Import |
| – | Archivy-Datenverzeichnis als Standardziel von |
| – | erlaubte Host-Header für streamable-http, kommagetrennt (wie |
| siehe | Endpunkte und Client-IDs überschreiben |
Graph-Modell
Knoten:
Beruf,Klassifikation(KldB/ISCO, Hierarchie als Jobfamilien),Aufgabe,Skill,Stellenanzeige,Arbeitgeber,Branche,Region,Automatisierung,Entgelt.Kanten:
STELLT_AN,ERFORDERT,TEIL_VON(mit O*NET Core/Supplemental),AUTOMATISIERBAR_DURCH(Bewertung, Anteil an der Wochenarbeitszeit),GEHOERT_ZU,FUER_BERUF,IN_REGION,AUSGESCHRIEBEN_VON,KLASSIFIZIERT_ALS,ENTSPRICHT,UNTERGRUPPE_VON,HAT_ENTGELT.
Details stehen in docs/archivy/WorkMCP/910007-Job-Graph-Modell.md. Für Neo4j: export_knowledge('cypher'), dann cypher-shell < graph.cypher.
Dokumentation
Landingpage, für GitHub Pages aus dem Ordner
/docsgedacht.Archivy-Dokumentation: Notizen mit YAML-Front-Matter, direkt in eine Archivy-Wissensdatenbank kopierbar.
export_knowledge('archivy')schreibt auch die gemerkten Berufe als verlinkte Archivy-Notizen.Faktencheck der zugrunde liegenden Recherche.
Bekannte Grenzen
Die Clients sind gegen dokumentierte Antwortformate getestet (bundesAPI-OpenAPI, ESCO-HAL, O*NET-Dateilayout, live verifizierte ATS-Referenz). Gegen die Live-APIs konnten sie in der Entwicklungsumgebung nicht laufen, deren Netzwerk-Policy die Hosts sperrt. Vor dem Produktiveinsatz
check_sourcesausführen und Ergebnisse stichprobenartig prüfen.Die Aufgaben-Extraktion aus BERUFENET ist heuristisch (Abschnitte „Aufgaben und Tätigkeiten“). Die Rohantwort wird immer vollständig gespeichert.
ONET-Aufgaben sind englisch und beschreiben US-Berufe. Für die Zuordnung zu deutschen Berufen werden ESCO-URIs und der ESCO↔ONET-Crosswalk empfohlen.
search_arbeitnowfiltert lokal, weil die API keine Suchparameter für Begriff und Ort hat.
Entwicklung
uv sync --extra devuv run pytestuv run ruff check src tests && uv run mypy srcLizenz
MIT, siehe LICENSE. Die abgerufenen Daten unterliegen den Bedingungen ihrer jeweiligen Quellen.
Available Tools
24 toolsadzuna_salaryAIdempotent
Gehaltsverteilung (Histogramm), Top-Arbeitgeber und optional Gehaltsverlauf aus Adzuna-Inseraten.
Optional: braucht einen kostenlosen Adzuna-Developer-Key (WORKMCP_ADZUNA_APP_ID/_APP_KEY). Für amtliche Medianentgelte nach Beruf get_salary (Entgeltatlas) verwenden.
Inputs: was (required), monate, standort, kategorie, +1 more. Returns: object
check_sourcesAIdempotent
Erreichbarkeit aller Datenquellen von diesem Rechner aus prüfen (HTTP-Status und Latenz je Quelle).
Inputs: no named parameters. Returns: object
commoncrawl_lookupAIdempotent
Common-Crawl-Index nach archivierten Seiten (z. B. Karriereseiten) durchsuchen und optional Text laden.
Inputs: url_muster (required), crawl, limit, text_abrufen. Returns: object
crosswalkAIdempotent
Übersetzt Berufscodes zwischen KldB 2010, ISCO-08, ESCO, O*NET und BERUFENET (auch über mehrere Stufen).
Inputs: von (required), code (required), nach (required), sprache. Returns: object
export_knowledgeBIdempotent
Graph exportieren: JSON, Neo4j-Cypher, GraphML oder als Archivy-Wissensdatenbank (Markdown-Notizen).
Inputs: pfad, format. Returns: object
find_automation_signalsCIdempotent
Automatisierungssignale aus Hacker News (Berichte, wie Tätigkeiten automatisiert wurden).
Inputs: suchbegriff (required), limit, aufgabe_id, aktualisieren, +2 more. Returns: object
get_ats_jobsAIdempotent
Offene Stellen direkt aus dem Bewerbermanagement eines Arbeitgebers (öffentliche Job-Board-APIs ohne Login).
Unterstützt Greenhouse, Lever, Ashby, Workable, Recruitee, Personio (XML), SmartRecruiters, BambooHR und Workday. Liefert Primärdaten wie Abteilung, Seniority, Anstellungsart. Das Delta zeigt neue und geschlossene Stellen seit dem letzten Abruf.
Inputs: company_slug (required), ats, ort, max_jobs, +2 more. Returns: object
get_changesCRead-onlyIdempotent
Änderungsprotokoll des Gedächtnisses: was ist neu, geändert, verschwunden oder wieder aufgetaucht.
Inputs: art, seit, limit, quelle, +1 more. Returns: object
get_historyBRead-onlyIdempotent
Alle gespeicherten Versionen eines Datensatzes mit feldgenauen Änderungen.
Inputs: art (required), quelle (required), schluessel (required). Returns: object
get_job_detailsAIdempotent
Volltext und Details einer BA-Stellenanzeige (Beschreibung, Branche, Fertigkeiten, Vergütung).
Nicht mehr vorhandene Anzeigen werden im Gedächtnis als 'verschwunden' markiert. Kontaktpersonen werden vor dem Speichern entfernt (Datenminimierung).
Inputs: refnr (required), aktualisieren. Returns: object
get_occupationBIdempotent
Profil eines Berufs bzw. einer Berufsklasse mit Klassifikation, Aufgaben, Skills und Verknüpfungen.
Inputs: beruf_id (required), sprache, aktualisieren. Returns: object
get_role_contextAIdempotent
Rollenkontext in einem Aufruf: Zuordnung, Aufgaben (BERUFENET/O*NET), Skills (ESCO), Gehalt (Entgeltatlas) und Marktsignal (offene Stellen laut BA).
Inputs: rolle (required), ort, sprache, mit_signalen. Returns: object
get_salaryCIdempotent
Amtliche Medianentgelte (mit Quartilen) nach Beruf aus dem Entgeltatlas der BA.
Inputs: kldb (required), alter, niveau, region, +3 more. Returns: object
get_skillsCIdempotent
Skills eines Berufs: ESCO essential/optional plus Häufigkeiten aus gespeicherten BA-Stellenanzeigen.
Inputs: beruf (required), limit, sprache, relation. Returns: object
get_tasksBIdempotent
Kanonische Aufgabenliste eines Berufs: O*NET Task Statements (Core/Supplemental) und BERUFENET-Tätigkeiten.
Die Zuordnung läuft über BERUFENET→KldB→ISCO→ESCO→O*NET (Crosswalks müssen importiert sein).
Inputs: beruf (required), limit, quellen, sprache, +1 more. Returns: object
graph_neighborsBRead-onlyIdempotent
Nachbarn eines Knotens im Job-Graphen (Berufe, Aufgaben, Skills, Stellen, Branchen, Regionen ...).
Inputs: knoten (required), limit, richtung, kantentyp. Returns: object
import_reference_dataAIdempotent
Referenzdaten importieren bzw. aktualisieren. Wiederholte Importe ergänzen neue/geänderte Einträge und markieren entfallene (z. B. zwischen O*NET-Releases).
Inputs: datensatz (required), quelle, onet_version, alternativtitel. Returns: object
knowledge_statsARead-onlyIdempotent
Überblick über das Gedächtnis: Datensätze je Quelle, Versionen, Graph-Knoten/-Kanten, letzte Abrufe.
Inputs: no named parameters. Returns: object
record_extractionAIdempotent
Vom Modell oder von Fachexperten extrahierte Aufgaben, Skills und Automatisierungsbewertungen versioniert im Graphen speichern. Liefert Vorschläge passender kanonischer Aufgaben (Deduplizierung).
Inputs: bezug (required), quelle, skills, aufgaben, +1 more. Returns: object
rememberAIdempotent
Eigene Daten (interne Rollenprofile, Expertenfeedback) versioniert im Gedächtnis speichern oder ergänzen.
Inputs: art (required), daten (required), schluessel (required), titel, +1 more. Returns: object
search_arbeitnowAIdempotent
Stellen von Arbeitnow (kostenlos, ohne Schlüssel; aggregiert ATS-Feeds wie Greenhouse, Personio, Recruitee).
Gefiltert wird lokal über die abgerufenen Seiten; alle abgerufenen Stellen werden gespeichert.
Inputs: ort, was, seiten, remote_only, +2 more. Returns: object
search_jobsAIdempotent
Stellensuche in der Jobbörse der Bundesagentur für Arbeit (größter Stellenbestand in Deutschland).
Speichert jede Anzeige im Gedächtnis und meldet im Delta neue, geänderte und nicht mehr enthaltene Anzeigen gegenüber der letzten identischen Suche. Details mit get_job_details(refnr).
Inputs: wo, was, seiten, groesse, +9 more. Returns: object
search_knowledgeBRead-onlyIdempotent
Offline-Suche im Gedächtnis (auch zur Zuordnung freier Aufgabentexte zu kanonischen Aufgaben).
Inputs: suchbegriff (required), art, limit, quelle. Returns: object
search_occupationBIdempotent
Berufe finden: BERUFENET (mit KldB-Zuordnung), ESCO-Berufe, KldB-Systematik und O*NET-Titel.
Inputs: query (required), limit, quellen, sprache, +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Tools mostly target distinct sources or actions: search_jobs (BA), search_arbeitnow, and get_ats_jobs are separated by source, and get_salary (official median) vs adzuna_salary (histogram) is explained in descriptions. Slight overlap remains between search_knowledge and get_changes/get_history, and between find_automation_signals and commoncrawl_lookup, but boundaries are mostly clear.
Dominant verb_noun snake_case pattern (search_jobs, get_job_details, import_reference_data, export_knowledge) is applied consistently. Minor deviations exist with noun-first/source-prefixed names (adzuna_salary, commoncrawl_lookup, graph_neighbors, knowledge_stats) and single verbs (crosswalk, remember), but the convention stays readable.
24 tools is heavy and sits in the borderline range, though the server spans several sub-domains (job search, occupation/task/skill data, salary, knowledge graph, change tracking, export). Each tool maps to a real operation, but the surface is large enough to burden tool selection.
Coverage is broad: multi-source job search and details, occupation/task/skill lookups, salary data, crosswalks, versioned memory storage, change/history tracking, graph traversal, export, and source health checks. Minor gaps like no explicit delete/forget tool for stored records and no direct occupation-to-job matching helper, but agents can work around these.
Maintenance
Related MCP Connectors
Jobs, ads, SEO, keywords, YouTube and AliExpress data for AI agents. Runs on Apify.
Company brain for AI agents — temporal knowledge graph search, exploration, and durable memory.
German Handelsregister + Austrian Firmenbuch for AI agents: master data, financials & ratios.
Public job postings and market data for France, Germany, Spain and Latin America, as JSON.
Related MCP Servers
- AlicenseAqualityBmaintenanceProvides agent coordination for Claude Code through a shared blackboard, decision tracking with rationale, and local semantic search over git-trackable JSONL files. It enables users to assemble tailored context packages and manage a lightweight knowledge graph for complex development tasks.15208 npm7MIT
- FlicenseNot gradedqualityDmaintenanceProvides persistent codebase memory and semantic context for AI agents via AST-aware chunking and symbol graph indexing.1-
- AlicenseNot gradedqualityCmaintenanceEnables coding agents to query a local, versioned knowledge graph of a software project, retrieving overviews, context packs, evidence, and explanations to make informed changes.MIT
- AlicenseNot gradedqualityCmaintenanceProvides AI coding agents with fast, deterministic access to code graphs, knowledge lifecycle state, and cross-document symbol links, enabling compact context retrieval and seamless session handoffs.1MIT