Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Verika - Verifica P.IVA, Codice Fiscale e IBAN

de JackPonsversión 0.6.0i★ 0iSe ejecuta en la nubeRepositorio ↗
Nombre en el registroio.github.JackPons/partita-iva-mcp

Cómo instalar

What it does

Verifica partita IVA, codice fiscale e IBAN italiani con dati ufficiali (VIES, IPA, ISTAT)

  • Connects Se ejecuta en la nube
  • Account or key No key needed
  • Category Otros

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad7/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso15/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Verika - Verifica P.IVA, Codice Fiscale e IBAN. Sigue https://mcp.popnx.com/i/jackpons-partita-iva-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (partita-iva-mcp.pons-labs.workers.dev) · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreVerika - Verifica P.IVA, Codice Fiscale e IBAN
    Remote MCP server URL · Direcciónhttps://partita-iva-mcp.pons-labs.workers.dev/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsVerika - Verifica P.IVA, Codice Fiscale e IBAN

  4. Pruébalo

    Usa Verika - Verifica P.IVA, Codice Fiscale e IBAN y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Verika - Verifica P.IVA, Codice Fiscale e IBAN o muestra una herramienta de Verika - Verifica P.IVA, Codice Fiscale e IBAN en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreVerika - Verifica P.IVA, Codice Fiscale e IBAN
    Connection · Direcciónhttps://partita-iva-mcp.pons-labs.workers.dev/mcp
  3. Elige Verika - Verifica P.IVA, Codice Fiscale e IBAN en un chat

    Abre un chat nuevo y elige Verika - Verifica P.IVA, Codice Fiscale e IBAN en tus plugins antes de escribir

  4. Pruébalo

    Usa Verika - Verifica P.IVA, Codice Fiscale e IBAN y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Verika - Verifica P.IVA, Codice Fiscale e IBAN o muestra una herramienta de Verika - Verifica P.IVA, Codice Fiscale e IBAN en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user partita-iva https://partita-iva-mcp.pons-labs.workers.dev/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Verika - Verifica P.IVA, Codice Fiscale e IBAN en la lista como conectado

  4. Pruébalo

    Usa Verika - Verifica P.IVA, Codice Fiscale e IBAN y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Verika - Verifica P.IVA, Codice Fiscale e IBAN o muestra una herramienta de Verika - Verifica P.IVA, Codice Fiscale e IBAN en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Verika - Verifica P.IVA, Codice Fiscale e IBAN y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Verika - Verifica P.IVA, Codice Fiscale e IBAN o muestra una herramienta de Verika - Verifica P.IVA, Codice Fiscale e IBAN en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Verika - Verifica P.IVA, Codice Fiscale e IBAN y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Verika - Verifica P.IVA, Codice Fiscale e IBAN o muestra una herramienta de Verika - Verifica P.IVA, Codice Fiscale e IBAN en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://partita-iva-mcp.pons-labs.workers.dev/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Verika - Verifica P.IVA, Codice Fiscale e IBAN💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user partita-iva https://partita-iva-mcp.pons-labs.workers.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "partita-iva": {
      "url": "https://partita-iva-mcp.pons-labs.workers.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "partita-iva": {
      "type": "http",
      "url": "https://partita-iva-mcp.pons-labs.workers.dev/mcp"
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
0.6.0
Categoríai
Otros
Publicado en el registroi
10 oct 2026
Último cambio de códigoi
10 oct 2026
Última revisión
19 nov 2026
Creador
JackPons
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 19 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • controlla_sanzioni

    Confronta un nome (persona o ente) con la lista consolidata delle sanzioni finanziarie UE, con matching tollerante (ignora forme societarie e accenti). Restituisce le possibili corrispondenze con un punteggio 0-1. Screening indicativo, non un sistema AML certificato: 'da_verifica

  • cerca_comune

    Trova un comune italiano per nome (con provincia opzionale) o per codice catastale, dalla tabella ISTAT locale. Restituisce denominazione canonica, provincia, regione, codice catastale e codice ISTAT.

  • valida_partita_iva

    Controllo formale e offline di una partita IVA italiana: lunghezza, cifra di controllo, codice ufficio. Non dice se la partita IVA è attiva: per quello usa `verifica_partita_iva`.

  • verifica_partita_iva

    Verifica se una partita IVA italiana è attiva interrogando VIES (Commissione Europea). Restituisce anche denominazione e indirizzo quando disponibili. Se la partita IVA non supera il controllo formale, VIES non viene interrogato.

  • valida_codice_fiscale

    Validazione offline di un codice fiscale italiano. Per le persone fisiche (16 caratteri) verifica il carattere di controllo, gestisce l'omocodia ed estrae sesso, data di nascita (anno con secolo dedotto) e codice catastale del comune. Per le persone giuridiche (11 cifre) applica

  • valida_iban

    Validazione offline di un IBAN (mod 97, lunghezza per paese). Per gli IBAN italiani verifica anche il CIN e scompone ABI, CAB e numero di conto. Non verifica l'esistenza del conto.

  • scheda_soggetto

    Quadro completo di un soggetto italiano a partire dalla partita IVA: controllo formale, stato su VIES con denominazione e indirizzo normalizzato (via, CAP, comune ISTAT, provincia, regione), screening sanzioni UE sulla denominazione, se il soggetto è una Pubblica Amministrazione

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub JackPons, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 40 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 388 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 7 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/jackpons-partita-iva-mcp.svg)](https://mcp.popnx.com/en/servers/jackpons-partita-iva-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 0% de los otros 20653 servidores de esta categoría
  • Publicado en el registro más recientemente que el 53% de los otros 20653 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 20653 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Verika - Verifica P.IVA, Codice Fiscale e IBAN?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 40 días, y la última versión (0.6.0) llegó al registro hace 40 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

de koala73Muy usado★ 90,9 milActualizado hace 3 días

Se ejecuta en la nube✓ del servicio · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

de openstatusHQMuy usado★ 9,3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

de JanDeDobbeleerMuy usado★ 23,8 mil Estrellas de todo el repositorioActualizado hace 30 días

Se ejecuta en la nube✓ del servicio · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

de Klavis-AIEn crecimiento★ 5,8 milActualizado hace 14 meses

Se ejecuta en la nubeRepo archivado✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

de jitsucomMuy usado★ 5,1 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · jitsu.com
Comparado con otros parecidos
Este
Verika - Verifica P.IVA, Codice Fiscale e IBAN
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas5/54/44/44/41/44/4
LicenciaMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Verika · partita-iva-mcp

Server MCP per verificare identificativi italiani — partita IVA, codice fiscale, IBAN — e arricchirli con fonti ufficiali gratuite (VIES, IPA, GLEIF, ISTAT, lista sanzioni UE).

Pensato per chi usa o costruisce agenti AI che devono fare controlli su aziende ed enti italiani (onboarding, KYC leggero, fatturazione verso la PA, pulizia anagrafiche) senza integrare quattro API diverse.

Usalo subito

Il server è già online, gratuito e senza chiave: non serve installare nulla né registrarsi.

  • Endpoint: https://partita-iva-mcp.pons-labs.workers.dev/mcp
  • Trasporto: Streamable HTTP (MCP remoto)
  • Autenticazione: nessuna

Claude (desktop, web, mobile) — Impostazioni → Connettori → *Aggiungi connettore personalizzato* → incolla l'endpoint → Aggiungi. In una chat nuova attivalo da + → Connettori. Richiede un piano che supporti i connettori personalizzati.

Claude Code

claude mcp add --transport http partita-iva --scope user https://partita-iva-mcp.pons-labs.workers.dev/mcp

Cursor, VS Code e altri client con configurazione JSON:

{

"mcpServers": { "partita-iva": { "url": "https://partita-iva-mcp.pons-labs.workers.dev/mcp" } } }

È pubblicato anche nel registry ufficiale MCP come io.github.JackPons/partita-iva-mcp.

Esempi

Domande da fare all'assistente con il connettore attivo:

  • *"Fammi la scheda della partita IVA [una P.IVA reale, es. presa da una fattura]: è attiva? Dove ha sede?"* → scheda_soggetto restituisce stato VIES, denominazione, sede normalizzata su ISTAT (comune, provincia, regione), screening sanzioni, LEI con forma giuridica e gruppo societario (se l'impresa ne ha uno) e, se è una PA, codice IPA e PEC.
  • *"Questo codice fiscale è valido? RSSMRA85T10A562S. Dove è nata questa persona?"* → valida_codice_fiscale verifica il carattere di controllo e ricava sesso, data e luogo di nascita (qui: San Giuliano Terme, PI).
  • *"Controlla l'IBAN DE89 3704 0044 0532 0130 00"* → valida_iban verifica le cifre di controllo; per gli IBAN italiani scompone anche ABI, CAB e conto e indica la banca quando è nota.
  • *"Bank Rossiya è nella lista sanzioni UE?"* → controlla_sanzioni restituisce le possibili corrispondenze con un punteggio di somiglianza (esito da_verificare).
  • *"Ho una lista di 10 fornitori con partita IVA: dimmi quali non risultano attivi"* → l'assistente chiama verifica_partita_iva per ciascuno e riassume.

Esempio di risposta di valida_iban (estratto):

{

"normalizzato": "DE89370400440532013000", "valido": true, "paese": "DE", "formattato": "DE89 3704 0044 0532 0130 00" }

Strumenti

StrumentoCosa faChiamate esterne
valida_partita_ivaControllo formale (11 cifre, cifra di controllo, codice ufficio)no
verifica_partita_ivaStato su VIES: attiva/non attiva, denominazione, indirizzoVIES
valida_codice_fiscaleCarattere di controllo, omocodia, sesso, data e luogo di nascita (comune ISTAT o stato estero); 11 cifre → persona giuridicano
valida_ibanMod 97 per tutti i paesi; per l'Italia anche CIN, ABI → banca, CAB, contono
cerca_comuneComune per nome o codice catastale: provincia, regione, codice ISTATno
controlla_sanzioniScreening indicativo di un nome contro la lista consolidata UE, matching tollerante con punteggiono
scheda_soggettoQuadro completo da partita IVA: formale + VIES con indirizzo normalizzato su ISTAT + screening sanzioni + dati IPA se è una PA + LEI, forma giuridica, capogruppo e numero di controllate (GLEIF)VIES, IPA, GLEIF

Ogni risposta indica la fonte e se il servizio era raggiungibile, così l'agente non confonde "non attiva" con "non ho potuto verificare".

Sviluppo locale

Per modificare il server o eseguirne una copia tua. Requisiti: Node.js 22+, npm; per il deploy un account Cloudflare (piano gratuito sufficiente).

npm install

npm run dati # scarica le tabelle ISTAT e la lista sanzioni UE in src/data/ (una volta, poi ogni tanto) npm test # test unitari, nessuna rete necessaria npm run inspect # apre MCP Inspector sul server stdio npm run dev # server HTTP locale su http://localhost:8787/mcp

In VS Code il file .vscode/mcp.json registra già il server stdio: apri la palette → *MCP: List Servers* → partita-iva-locale.

Da Claude Code, con il server HTTP locale avviato:

claude mcp add partita-iva -t http http://localhost:8787/mcp

Deploy su Cloudflare Workers

npx wrangler login

npm run deploy

L'endpoint sarà https://partita-iva-mcp. .workers.dev/mcp. La home page (/) mostra le istruzioni di collegamento, /health risponde {ok:true}.

Statistiche d'uso e privacy

Il worker conta le chiamate su Cloudflare D1 e applica un rate limit di 60 richieste al minuto per utente. Entrambi sono opzionali: senza configurazione il server funziona uguale.

Cosa viene salvato per ogni chiamata: data e ora, metodo MCP, nome dello strumento, client (es. claude-ai), paese, esito, durata, e un identificativo utente che è un hash di IP + giorno + sale segreto.

Cosa NON viene salvato: gli argomenti degli strumenti (partite IVA, codici fiscali, IBAN, nomi) e gli indirizzi IP. L'hash cambia ogni giorno, quindi permette di contare gli utenti distinti in una giornata ma non di seguirli nel tempo. Le righe più vecchie di 90 giorni vengono cancellate ogni notte.

Configurazione (una volta)
npx wrangler d1 create partita-iva-mcp-stats     # copia il database_id in wrangler.jsonc

npm run db:migra # crea la tabella sul D1 remoto npx wrangler secret put STATS_TOKEN # una stringa lunga a caso: protegge /stats npx wrangler secret put HASH_SALT # un'altra stringa a caso: sale per l'hash degli IP npm run deploy

Per lo sviluppo locale: npm run db:migra-locale e un file .dev.vars (escluso da git) con STATS_TOKEN=... e HASH_SALT=....

Leggere le statistiche
curl -H "Authorization: Bearer $STATS_TOKEN" https://<tuo-worker>/stats?giorni=30

oppure dal browser https:// /stats?token=.... Restituisce totali, chiamate e utenti per giorno, chiamate ed errori per strumento, client e paesi.

Pubblicazione nei registry

  1. Aggiorna server.json (nome io.github. / , versione, URL con /mcp in fondo). Ogni pubblicazione richiede una versione nuova.
  2. Registry ufficiale: installa mcp-publisher, poi mcp-publisher validate, mcp-publisher login github, mcp-publisher publish. PulseMCP e Glama lo raccolgono da lì.
  3. Smithery: da smithery.ai/new con l'URL dell'endpoint; dopo ogni deploy, *Releases → Publish* per una nuova scansione.
  4. Catalogo italiano: PR su bsab/italia-mcp-servers seguendo il loro CONTRIBUTING.

Tabelle locali (src/data/)

I JSON partono come seed (poche voci, giusto per i test). npm run dati li sostituisce con:

  • comuni.json — tutti i comuni ISTAT con codice catastale, provincia, regione, codice ISTAT
  • sanzioni.json — lista consolidata sanzioni finanziarie UE (id, tipo, nomi/alias, programmi)

stati-esteri.json (codici Z) e abi.json (banche) sono tabelle compilate a mano, parziali: vanno verificate ed estese. Per gli ABI la fonte autorevole è l'elenco degli intermediari di Banca d'Italia; se trovi un CSV ufficiale, aggiungi un caso allo script.

Ogni strumento che usa una tabella dichiara nell'output se la tabella è seed o aggiornata (infoTabelle), e controlla_sanzioni risponde lista_non_caricata finché non hai lanciato npm run dati: meglio un "non so" esplicito che un falso "nessuna corrispondenza".

Struttura

src/

lib/ algoritmi puri e client delle fonti (testabili senza MCP) partita-iva.ts codice-fiscale.ts iban.ts vies.ts ipa.ts gleif.ts LEI, forma giuridica e gruppo tabelle.ts accesso alle tabelle locali sanzioni.ts matching contro la lista UE data/ tabelle JSON (seed → aggiornate da npm run dati) server.ts definizione degli strumenti MCP (condivisa) telemetria.ts conteggio chiamate (D1), rate limit, statistiche stdio.ts entrypoint locale worker.ts entrypoint Cloudflare Workers (Streamable HTTP, stateless) migrations/ schema SQL del database D1 scripts/ aggiorna-dati.ts scarica e converte le tabelle ufficiali test/ node:test, con fetch finto per VIES, IPA e GLEIF

Fonti e limiti

Tutti gli strumenti sono in sola lettura: non modificano dati e non inviano nulla a terzi oltre alle interrogazioni a VIES, IPA e GLEIF. Rate limit: 60 richieste al minuto per utente.

  • VIES (Commissione Europea): stato della partita IVA ai fini IVA intracomunitaria. Per l'Italia restituisce di solito denominazione e indirizzo; a volte è temporaneamente non disponibile, e il server lo segnala.
  • IPA (indicepa.gov.it, open data CKAN): usato per riconoscere le Pubbliche Amministrazioni e recuperare codice IPA, PEC e sito.
  • GLEIF (api.gleif.org, licenza CC0): registro mondiale dei LEI. Ricerca per codice fiscale sulle imprese iscritte al Registro Imprese; restituisce forma giuridica, stato del LEI, controllante diretta, capogruppo e numero di controllate. Il LEI ce l'hanno soprattutto le imprese medio-grandi e chi opera sui mercati finanziari: per una piccola impresa trovato: false è normale.
  • ISTAT (elenco comuni): normalizzazione di comuni e codici catastali.
  • Lista consolidata sanzioni UE: screening per nome, indicativo. Non sostituisce un provider AML né il giudizio di un operatore; i nomi traslitterati (arabo, cirillico) possono sfuggire al matching su token.
  • Il server non accede al Registro Imprese: soci, cariche, bilanci e protesti sono dati a pagamento e restano fuori da questa versione.
  • La data di nascita estratta dal codice fiscale ha il secolo dedotto (anno_ambiguo: true).

I dati restituiti sono soggetti alle licenze delle fonti originali.

Roadmap

  • Comune da codice catastale, stato estero da codice Z
  • Banca da ABI (tabella parziale)
  • Screening sanzioni UE
  • Conteggio chiamate per strumento (D1), senza dati personali
  • Rate limit di base
  • Output schema e annotazioni read-only su tutti gli strumenti
  • API key opzionale con limiti più alti
  • CAP → comune (ISTAT/Poste)
  • ANAC (appalti aggiudicati) e RNA (aiuti di Stato) nella scheda soggetto
  • Descrizione codice ATECO

Licenza

MIT.