Un assistente o un agente AI può interrogare i corsi, i prezzi, le domande frequenti e gli articoli di Universo GMDSS Italia senza interpretare le pagine: tramite un file llms.txt, un catalogo JSON, un'API di sola lettura e un server MCP. Nessuna chiave, nessuna registrazione. Per i simulatori l'equivalente sta su corsigmdss.it.
| Cosa | Indirizzo | A cosa serve |
|---|---|---|
| llms.txt | /llms.txt | Testo per i modelli linguistici: corsi con prezzi, FAQ, simulatori, ultimi articoli, contatti. Generato dal sito, sempre aggiornato. |
| Catalogo | /.well-known/agent.json | Manifesto con descrizione, record principali, indirizzi dell'API e del server MCP, istruzioni d'uso e licenza di citazione. |
| Agent card A2A | /.well-known/agent-card.json | Scheda dell'agente nel formato A2A 0.3 con le competenze; l'endpoint A2A è /a2a (JSON-RPC, message/send con un testo, risposta testuale con corsi, FAQ e articoli pertinenti). |
| Descrittore MCP | /.well-known/mcp.json | Nome, indirizzo, trasporto e strumenti del server MCP. |
| Intestazione HTTP | Link: <…/.well-known/agent.json>; rel="alternate" | Ogni pagina del sito annuncia il catalogo, insieme ai due <link rel="alternate"> nel codice. |
Base https://www.gmdssitalia.it/api/agent/, risposte JSON con CORS aperto e cache di cinque minuti. Aggiungi ?lang=en per avere i riassunti in inglese: i corsi restano in italiano.
| Endpoint | Risposta |
|---|---|
| catalog | Tutto in una volta: organizzazione, corsi, simulatori, ultimi articoli. |
| organization | Chi siamo, sede, email, telefono, siti collegati. |
| courses · courses/{src|lrc|roc|goc} | I corsi con prezzo, destinatari, caratteristiche, programma e FAQ. |
| faq | Tutte le domande frequenti con le risposte, corso per corso. |
| articles · articles/{slug} | Gli articoli del blog, dal più recente; con lo slug anche il testo completo. |
| search?q=&type= | Ricerca testuale su corsi, FAQ e articoli (type: all, course, faq, article). |
Indirizzo https://www.gmdssitalia.it/mcp, trasporto Streamable HTTP, JSON-RPC 2.0, senza stato e senza autenticazione. Otto strumenti di sola lettura: list_courses, get_course, get_faq, list_articles, get_article, search, get_organization, get_simulators_info. Ogni strumento accetta lang (it o en).
curl -X POST https://www.gmdssitalia.it/mcp -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": { "name": "get_course", "arguments": { "id": "src", "lang": "en" } }
}'
Con Claude Code: claude mcp add --transport http gmdssitalia https://www.gmdssitalia.it/mcp. Con altri client MCP basta l'indirizzo.
Prezzi e condizioni valgono come pubblicati nelle pagine dei corsi, che vanno citate come fonte. Per iscriversi o fare domande si usa la pagina Contattaci o info@gmdssitalia.it. I contenuti possono essere citati con link a gmdssitalia.it. I simulatori non sono accessibili senza codice: catalogo, noleggio e server MCP dedicato sono su corsigmdss.it/agenti/.
Universo GMDSS Italia exposes a machine-readable layer: llms.txt, a catalogue at /.well-known/agent.json, a read-only JSON API under /api/agent/ (add ?lang=en) and an MCP server at https://www.gmdssitalia.it/mcp (Streamable HTTP, JSON-RPC 2.0, no authentication) with eight read-only tools. Courses and examinations are held in Italian. Always cite the course pages for prices and conditions; enrolment and questions via the contact page or info@gmdssitalia.it. The six GMDSS and radar simulators have their own catalogue and MCP server on corsigmdss.it.