Skip to content

Helpmefindthejob

Open-source EU-wide civic employment commons. An MCP-composable copilot for users facing structural labor-market friction in Europe.


Who we build for

Aïcha is a Tunisian-trained registered nurse working through §16d Anerkennung in Berlin — clinically capable, German at B1 climbing toward B2, CV shaped for a Tunisian recruiter. The hospital ward she would slot into is short-staffed; the friction is bureaucratic, linguistic, and CV-formatting — not capability.

Käthe is a German nurse returning to clinical work after twelve years out for childcare — legally certified, German-native, but everything about practising nursing in Germany has changed since 2013 and her old CV reads wrong for 2026 conventions. The same Berlin clinic is hiring the role both Aïcha and Käthe could fill.

The project's architecture is friction-driven, not demographic- driven. Migrants and EU-mobile workers are the most acute use case and the primary narrative anchor; the same friction shapes affect career changers, returning workers, the long-term unemployed, and returning expats. Helpmefindthejob captures specialist HR and bureaucratic-navigation knowledge into modular, standards-anchored MCP tools and puts that knowledge directly into the hands of anyone navigating the European labour market.

See the seven-persona panel for the full friction-class breakdown (five most-acute migrant + two wider-friction-class).


What's here

  • Quickstart — install, run, and try the journey state machine locally.
  • MCP API — the five composition-oriented tools the MCP server exposes today (catalogue v0.2.0).
  • Deployment recipe + production deployment — the generic parallel-public- instance recipe + the maintainer's private deployment baseline.
  • ESCO + EURES integration — the curated skills reference dataset and EURES projection contract.
  • Architecture — Mermaid system diagram + component map (read first if you're going to contribute code).
  • Standards — the standards we hold ourselves to (Apache 2.0, ESCO, MCP, WCAG 2.2, EU AI Act).
  • Compliance pack — EU AI Act artefacts (transparency notice, risk management plan, FRIA template, technical documentation, accuracy + bias testing methodology, audit-log schema, data governance, human-oversight guide, deployer operating manual, EU database registration template).
  • Roadmap and Changelog — what's shipped, what's next.

License + governance

Apache 2.0 with a Contributor License Agreement. Programme of The Commons Conservancy (Dutch stichting co-founded by NLnet). Read CONTRIBUTING.md before opening a pull request.


Stability + honesty

This is alpha software. We hold ourselves to the project's "demand runtime proof on every closeout" standard — every feature gets a live runtime probe before it's declared done. We are honest about what's executed (the bias-testing surface, the deployment recipe, the persona seed script) and what's deferred (the four remaining methodology scenario classes, the §3.6 accessibility audit, the translator contributor pathway). See the grant workspace for the maintained planning record.


Contact