Per agenti AI

Cos'è

MCP (Model Context Protocol) è il protocollo aperto con cui i client AI — Claude, ChatGPT, gli IDE con assistente, gli agenti scritti a mano — si collegano a fonti di dati esterne. Invece di leggere una pagina e indovinare il numero, l'agente chiede il dato e riceve lo stesso valore pubblicato sul sito, con la fonte primaria da citare. I numeri sono quelli della nostra API pubblica e delle pagine indicatore: il server MCP legge dallo stesso database, non ne tiene una copia.

Come connettersi

L'endpoint usa il trasporto Streamable HTTP di MCP, senza autenticazione:

Nei client che accettano un server remoto basta incollare l'URL (in Claude: Impostazioni → Connettori → Aggiungi connettore personalizzato). Nei client configurati da file, come Claude Code o Cursor, la voce è questa — con Claude Code anche da riga di comando: claude mcp add --transport http ilreport https://il.report/api/mcp.

{
  "mcpServers": {
    "ilreport": {
      "type": "http",
      "url": "https://il.report/api/mcp"
    }
  }
}

I due tool

list_series — il catalogo: per ogni serie l'id, il titolo, l'unità, la frequenza, il periodo coperto (firstPeriod–lastPeriod) e la fonte; ogni fonte primaria — nome, URL, attribuzione e licenza — è descritta una volta sola in sources. Il catalogo conta circa 300 serie: l'argomento facoltativo query filtra per titolo o id.

→ tools/call  list_series  { "query": "euribor" }

← {
  "count": 4,
  "series": [
    {
      "id": "euribor-3m",
      "title": "Euribor 3 mesi",
      "unit": "%",
      "frequency": "monthly",
      "firstPeriod": "1994-01",
      "lastPeriod": "2026-08",
      "source": "bce-tassi",
      …
    },
    …
  ],
  "sources": {
    "bce-tassi": {
      "name": "BCE — Banca Centrale Europea",
      "url": "https://data.ecb.europa.eu/data/datasets/FM",
      "attribution": "Banca Centrale Europea (BCE), ECB Data Portal, …",
      "license": null
    }
  }
}

get_series — i valori di una serie, dato il suo id: metadati, nota metodologica e osservazioni { period, value }, con periodi nel formato 2024, 2024-Q1 o 2024-03. È lo stesso oggetto restituito da /api/series/{id}; from e to, facoltativi e inclusi, limitano l'intervallo a qualunque granularità: "to": "2020" su una serie mensile arriva a dicembre 2020.

→ tools/call  get_series  { "id": "euribor-3m", "from": "2026-06" }

← {
  "slug": "euribor-3m",
  "title": "Euribor 3 mesi",
  "unit": "%",
  "source": {
    "name": "BCE — Banca Centrale Europea",
    "url": "https://data.ecb.europa.eu/data/datasets/FM",
    "attribution": "Banca Centrale Europea (BCE), ECB Data Portal, …"
  },
  "license": null,
  "observations": [
    { "period": "2026-06", "value": 2.339 },
    { "period": "2026-07", "value": 2.425391 },
    { "period": "2026-08", "value": 2.513143 }
  ],
  …
}

Senza un client MCP, la stessa chiamata è una normale richiesta JSON-RPC:

curl -s https://il.report/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_series","arguments":{"id":"euribor-3m"}}}'

Non ci sono altri tool: il server non scrive, non modifica e non conserva nulla di ciò che gli chiedi.

Licenza e citazione

Ogni serie porta source— nome e URL dell'ente che ha prodotto il dato — e license: l'URL della licenza formale quando è nota (es. CC BY 4.0 per ISTAT ed Eurostat), o nullquando la fonte non ne pubblica una — mai un'attribuzione inventata. Un agente che riusa un valore dovrebbe citare la fonte primaria e il.report. Non pubblichiamo stime né dati interpolati: ogni osservazione è quella diffusa dalla fonte per quel periodo.

Limiti

Il servizio è gratuito e senza rate limit dichiarato: uso corretto e non aggressivo. I dati cambiano alla cadenza della fonte — mensile, trimestrale o annuale — quindi non serve interrogarli più spesso. Per chi legge senza MCP restano l'API JSON e CSV e l'elenco in llms.txt.