---
title: "MCP per agenti AI | Giornata Mondiale"
description: "Consulta le giornate mondiali con il MCP pubblico gratuito: ricerca, calendario, fonti istituzionali e stato di verifica. Senza login o API key."
canonical_url: "https://giornatamondiale.it/per-agenti"
md_url: "https://giornatamondiale.it/per-agenti.md"
last_updated: 2026-09-06
language: it-IT
---

# 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](/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](/metodo-editoriale) e l'[osservatorio delle verifiche](/osservatorio). 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](/dati-aperti) è 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](/contatti). Corpo richiesta massimo: 64 KB.

Per consultare i contenuti senza MCP: [llms.txt](/llms.txt), [corpus Markdown](/llms-full.txt), [dataset JSON](/dati/giornate-mondiali.json) e [questa guida in Markdown](/per-agenti.md).

## Fonti e riferimenti

-   [Nazioni Unite — Giornate internazionali](https://www.un.org/en/observances)
-   [UNESCO — Giornate e ricorrenze internazionali](https://www.unesco.org/)

## Sitemap

Consulta la [sitemap completa](/sitemap.md) per tutte le sezioni del sito.
