mcp-italian-workplace-safety

MCP server che espone i dati di 123Formazione sulla sicurezza sul lavoro italiana (D.Lgs 81/08) a qualsiasi AI assistant compatibile Model Context Protocol — Claude Desktop, Cursor, Cline, Windsurf, Continue, e altri.

Chiedi al tuo assistente AI cose tipo:

"Quali corsi sicurezza sono obbligatori per il codice ATECO 41 (costruzioni di edifici)?"

"Ogni quanto va aggiornato il corso preposto secondo l'Accordo Stato-Regioni 78/CSR del 17 aprile 2025?"

"Cerca nel glossario D.Lgs 81/08 il termine RSPP e dammi la definizione + normativa di riferimento."

"Mostrami tutte le sanzioni dell'art. 55 D.Lgs 81/08 per omessa formazione."

L'assistente userà gli strumenti MCP per chiamare l'API pubblica gratuita di 123formazione.com/api/public e restituire dati strutturati, citabili e aggiornati.

---

Install

Quick install (npx — no global install)

// claude_desktop_config.json (Claude Desktop) o equivalente
{
  "mcpServers": {
    "italian-workplace-safety": {
      "command": "npx",
      "args": ["-y", "github:tutor-sicurezza/mcp-italian-workplace-safety"]
    }
  }
}

Local install

git clone https://github.com/tutor-sicurezza/mcp-italian-workplace-safety.git
cd mcp-italian-workplace-safety
npm install
npm run build

Poi nel client MCP punta al binario dist/index.js:

{
  "mcpServers": {
    "italian-workplace-safety": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-italian-workplace-safety/dist/index.js"]
    }
  }
}

---

Client-specific instructions

Claude Desktop

1. Apri il file di configurazione:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Aggiungi il blocco italian-workplace-safety come sopra.
3. Riavvia Claude Desktop. Vedrai i tool get_ateco, search_ateco, get_corsi_obbligatori, get_scadenze_formazione, search_glossario, get_normativa, search_normativa, suggest disponibili nelle conversazioni.

Cursor

1. Apri ~/.cursor/mcp.json (crea il file se non esiste).
2. Aggiungi lo stesso JSON dell'esempio sopra.
3. Riavvia Cursor.

Cline (VS Code extension)

1. Apri le settings VS Code → cerca "Cline MCP".
2. Aggiungi il server italian-workplace-safety con il blocco JSON.

Windsurf

1. Apri ~/.codeium/windsurf/mcp_config.json.
2. Aggiungi il blocco MCP server come sopra.

Continue (VS Code/JetBrains)

1. Apri ~/.continue/config.json.
2. Aggiungi nella sezione mcpServers.

---

Tools

Tool	Descrizione
get_ateco(codice)	Dettagli ATECO 2007 (codice o slug) con classificazione rischio e corsi obbligatori
search_ateco(query)	Ricerca fuzzy ATECO per nome settore
get_corsi_obbligatori(ateco)	Lista corsi sicurezza obbligatori per settore ATECO
get_scadenze_formazione(corso?)	Periodicità rinnovo formazione (D.Lgs 81/08 + Accordi SR)
search_glossario(termine, categoria?)	Glossario 200+ termini D.Lgs 81/08
get_normativa(slug?)	Index normative italiane SSL
search_normativa(query)	Ricerca fuzzy normative
suggest(query)	Autocomplete combinato corsi + glossario

Resources

URI	Descrizione
123formazione://ateco	Dataset ATECO completo
123formazione://scadenze	Scadenze formazione
123formazione://glossario	Glossario completo
123formazione://normativa	Normative complete
123formazione://llms.txt	Site map per LLM (llmstxt.org)
123formazione://openapi	OpenAPI 3.1 spec

---

Data source

Tutti i dati sono serviti dall'API pubblica gratuita di 123Formazione — REST + OpenAPI 3.1 + DCAT-AP-IT, licenza CC-BY 4.0.

L'API espone:

• ATECO 2007 + classificazione rischio (Accordo Stato-Regioni 21/12/2011)
• Scadenze formazione (D.Lgs 81/08 + Accordi 2011/2012/2016 + Rep. 78/CSR 2025)
• Glossario 200+ termini
• Index normative (D.Lgs 81/08, Accordi SR, DM 388/2003, DM 02/09/2021, DPR 177/2011, GDPR, Reg. CE 852/2004, CEI 11-27)

Environment variables (optional)

• MCP_123F_BASE_URL — override base URL (default https://123formazione.com)

English summary

This MCP server exposes Italian workplace-safety data (D.Lgs 81/08 — Italy's main occupational safety code) to any MCP-compatible AI assistant. It uses the free public REST API of 123formazione.com and provides 8 tools and 6 resources for querying ATECO economic sectors with risk classification, required training courses, renewal schedules, glossary terms, and regulations.

Useful for: legal-tech tools, compliance assistants, HR / RSPP (workplace safety officers) chatbots, content generation for Italian SSL (Salute e Sicurezza sul Lavoro) topics.

---

Related repositories

Open dataset / tooling ecosystem for Italian workplace safety (D.Lgs 81/08) maintained by @tutor-sicurezza:

Datasets

• italian-ateco-database — ATECO 2007 codes + workplace-safety risk
• italian-province-regioni-dataset — Italian provinces + regions metadata
• comuni-italiani-istat — Italian municipalities with ISTAT codes
• dlgs-81-08-glossario — 218 D.Lgs 81/08 glossary terms
• dlgs-81-08-testo-unico — D.Lgs 81/08 structured by Title + key articles index
• haccp-italia-normativa-regionale — HACCP regional regulations (20 Italian regions)
• verifiche-periodiche-inail-attrezzature — Equipment subject to INAIL periodic verification
• accordi-stato-regioni-sicurezza-lavoro — Stato-Regioni training agreements

Libraries / tools

• scadenze-formazione-calculator — Training renewal schedule calculator
• next-seo-italian-helpers — Next.js SEO helpers for Italian B2B

Online services

• Public REST API + OpenAPI 3.1 + DCAT-AP-IT — Free open data API
• Live documentation site (GitHub Pages) — Accordi Stato-Regioni

All resources are MIT or CC-BY licensed and maintained as production-quality open data.

License

MIT © 2026 tutor-sicurezza / 123Formazione

Data served from the API is licensed under CC-BY 4.0 with attribution 123Formazione — https://123formazione.com.