Codice Fiscale Subito

npx add-mcp 'https://codicefiscalesubito.it/api/mcp'

API codice fiscale

Calcolo, verifica e inverso del codice fiscale in JSON, gratis e senza chiave. Gli stessi calcoli di questo sito, anche come server MCP per gli assistenti IA.

Endpoint	Cosa fa	Parametri
GET /api/v1/calcola	Calcola il codice da cognome, nome, sesso, data e luogo	surname, name, sex, birth_date, birth_place
GET /api/v1/decodifica	Legge sesso, data e comune da un codice (inverso)	code
GET /api/v1/verifica	Controlla formato, carattere di controllo, data, luogo, nome	code, surname (facoltativo), name (facoltativo)
GET /api/v1/luoghi	Cerca il codice catastale di un comune o Stato estero	q, date (facoltativo)

Esempio: calcolo

https://codicefiscalesubito.it/api/v1/calcola?surname=Rossi&name=Mario&sex=M&birth_date=1985-12-10&birth_place=Roma

{
  "codice_fiscale": "RSSMRA85T10H501O",
  "birth_place": {
    "code": "H501",
    "label": "Roma (RM)",
    "valid_to": null
  },
  "parts": [
    {
      "label": "Cognome",
      "characters": "RSS",
      "rule": "Le prime tre consonanti; se non bastano, le vocali, poi X."
    },
    {
      "label": "Nome",
      "characters": "MRA",
      "rule": "Con 4 o più consonanti: la prima, la terza e la quarta. Altrimenti come il cognome."
    },
    {
      "label": "Anno",
      "characters": "85",
      "rule": "Le ultime due cifre di 1985."
    },
    {
      "label": "Mese",
      "characters": "T",
      "rule": "Dicembre è la lettera T."
    },
    {
      "label": "Giorno e sesso",
      "characters": "10",
      "rule": "Il giorno di nascita, 10. Per un uomo resta così; per una donna si aggiunge 40 (sarebbe 50)."
    },
    {
      "label": "Comune",
      "characters": "H501",
      "rule": "Il codice catastale di Roma (RM)."
    },
    {
      "label": "Controllo",
      "characters": "O",
      "rule": "Calcolato dai primi 15 caratteri: verifica che il codice sia scritto bene."
    }
  ],
  "source": "D.M. 23 dicembre 1976 n. 13813 (Ministero delle Finanze); places: ANPR, Archivio storico dei comuni",
  "docs": "https://codicefiscalesubito.it/"
}

Esempio: codice catastale di un comune soppresso

Pola, in Istria, ha il codice G778 fino al 1947: con una data, l'API tiene solo i luoghi validi quel giorno.

https://codicefiscalesubito.it/api/v1/luoghi?q=Pola&date=1940-06-02

{
  "query": "Pola",
  "date": "1940-06-02",
  "count": 2,
  "places": [
    {
      "name": "Pola",
      "province": "PL",
      "foreign_state": false,
      "code": "G778",
      "valid_from": "1921-01-05",
      "valid_to": "1947-09-15",
      "label": "Pola (PL)"
    },
    {
      "name": "Polaveno",
      "province": "BS",
      "foreign_state": false,
      "code": "G779",
      "valid_from": "1861-03-17",
      "valid_to": null,
      "label": "Polaveno (BS)"
    }
  ],
  "source": "ANPR, Archivio storico dei comuni"
}

Server MCP

Indirizzo https://codicefiscalesubito.it/api/mcp, trasporto HTTP (streamable), senza autenticazione. In un file di configurazione MCP:

{
  "mcpServers": {
    "codicefiscale": {
      "type": "http",
      "url": "https://codicefiscalesubito.it/api/mcp"
    }
  }
}

Strumenti: compute_codice_fiscale, decode_codice_fiscale, verify_codice_fiscale, lookup_place. Stessi parametri dell'API.

Regole d'uso

Chiave	Nessuna
Limite	60 richieste al minuto per IP (429 oltre)
Metodi	GET con query string, o POST con corpo JSON
CORS	Aperto a tutti i domini
Errori	400 con error e message in italiano
Specifica	OpenAPI 3.1: https://codicefiscalesubito.it/api/openapi.json
Dati personali	Nessun dato salvato: ogni richiesta è calcolata e dimenticata

Regole del calcolo e fonti: metodo e fonti. Un problema o un'idea? Scrivi a contatto@codicefiscalesubito.it.

Domande frequenti

L'API del codice fiscale è gratuita?

Sì, senza chiave e senza registrazione, con CORS aperto: si può chiamare anche dal browser. Il limite è di 60 richieste al minuto per indirizzo IP; oltre, la risposta è 429. Per migliaia di codici c'è il calcolo massivo da Excel o CSV.

Come si calcola il codice fiscale con una chiamata API?

GET https://codicefiscalesubito.it/api/v1/calcola con surname, name, sex, birth_date e birth_place. Per Rossi Mario, nato a Roma il 10/12/1985, la risposta è RSSMRA85T10H501O, con la regola di ogni gruppo di caratteri.

L'API dice se il codice fiscale esiste davvero?

No: dice se è scritto bene e coerente con data e luogo. Che sia attribuito a una persona lo conferma solo l'Agenzia delle Entrate, con il servizio Verifica codice fiscale o, per enti e aziende, con i suoi servizi riservati.

Come uso il codice fiscale in Claude, ChatGPT o Cursor?

Aggiungi il server MCP https://codicefiscalesubito.it/api/mcp (HTTP, senza autenticazione) nelle impostazioni dei connettori o nel file di configurazione MCP. Gli strumenti sono quattro: calcolo, inverso, verifica e ricerca del codice catastale.

Quali comuni conosce l'API?

15.354 righe dell'archivio storico ANPR: comuni attuali, comuni soppressi con le date di validità, territori ceduti e Stati esteri con i codici Z. Il luogo usato è quello valido alla data di nascita.