Le giornate mondiali, a disposizione degli agenti

Un catalogo editoriale italiano consultabile dagli agenti AI, con date, temi, fonti e URL da citare. Il server MCP è pubblico, gratuito e di sola lettura: non richiede login o API key.

Collega il tuo agente

Nel tuo client MCP scegli un server remoto con trasporto Streamable HTTP e inserisci questo indirizzo:

https://giornatamondiale.it/mcp

Per i client che accettano una configurazione mcpServers con URL:

{
  "mcpServers": {
    "giornata-mondiale": {
      "url": "https://giornatamondiale.it/mcp"
    }
  }
}

I nomi delle opzioni variano fra client. L'endpoint usa POST JSON-RPC e non apre un flusso GET permanente; aprirlo come una pagina web restituisce HTTP 405. La configurazione pubblica del Registry è disponibile in mcp-server.json.

Cosa puoi chiedere

search: cerca per titolo italiano, titolo ufficiale, descrizione o tema. Esempio: {"query":"acqua","authority_status":"official"}.
fetch: recupera testo pubblico, date, fonti e correzioni usando un identificativo restituito dalla ricerca. Esempio: {"id":"giornata-mondiale-dellacqua"}.
list_days: consulta oggi oppure un intervallo inclusivo. Esempio: {"start_date":"2026-10-01","end_date":"2026-10-31","limit":50}. Senza date usa oggi in Europe/Rome.
list_topics: elenca temi e identificativi da usare nel filtro topic.

Le liste restituiscono 20 risultati per pagina, fino a 50 con limit. Passa next_offset come offset per continuare. Gli intervalli non possono superare 366 giorni. Date mobili, anni bisestili e fine ricorrenza sono considerati nel calendario.

Fonti e stato editoriale

Il catalogo include tutte le schede pubbliche. Ogni risposta distingue:

official: ricorrenza con fonte istituzionale verificata editorialmente.
community: ricorrenza comunitaria, senza attribuirle un riconoscimento istituzionale.
unreviewed: verifica editoriale non completata; non significa che la giornata sia inesistente o falsa.

Il filtro authority_status accetta questi valori oppure all, che è il valore predefinito. Una data di aggiornamento non equivale a una nuova verifica della fonte. Le date calcolate sono proiezioni di calendario e non provano che la giornata fosse già istituita in quell'anno.

Leggi il metodo editoriale e l'osservatorio delle verifiche. Giornata Mondiale è un progetto editoriale indipendente e non rappresenta ONU, UNESCO o OMS.

Come citare e riutilizzare

Cita Giornata Mondiale con la canonical_url della scheda e conserva i riferimenti istituzionali quando presenti. I risultati espongono fonte, istituzione, risoluzione quando disponibile, data di verifica e correzioni. Il testo di fetch è limitato a 24.000 caratteri: content_truncated segnala eventuali tagli e content_url collega alla scheda completa.

Il dataset è disponibile con licenza CC BY 4.0; questa licenza non si estende automaticamente ai testi editoriali, alle immagini o ai materiali di terzi.

Disponibilità e integrazione

Il catalogo viene conservato in cache per cinque minuti. Un errore della fonte dati produce un errore esplicito, non una lista vuota. I client server possono collegarsi senza Origin; per le integrazioni browser sono ammessi gli Origin del sito, chatgpt.com e claude.ai. Per un altro Origin contatta la redazione tramite la pagina contatti. Corpo richiesta massimo: 64 KB.

Per consultare i contenuti senza MCP: llms.txt, corpus Markdown, dataset JSON e questa guida in Markdown.