ItalyCheck

io.github.yeick010由 GitHub 账号 yeick010 发布v0.2.0更新于 Oct 25, 2026

Italian public bodies by codice fiscale (IndicePA): name, PEC, address. Paid per call via x402.

发布方自己的服务:check.tattoo: tattoo size and placement guide

已验证Streamable HTTP可网页运行金融商业与电商

概览

AI 生成的概览

远程 MCP 服务器:免费校验意大利增值税号格式,并按次付费(USDC 或 EURC)通过税号查询意大利公共机构信息。

可以做什么
  • 离线校验意大利 partita IVA 格式:11 位数字加校验位,但不确认是否已注册
  • 按 11 位 codice fiscale 在 IndicePA 中查询意大利公共行政部门和公共服务机构
  • 获取机构名称、官方 PEC(认证邮箱)地址和地址
  • 通过 x402 以 Base 上的 USDC 或 EURC 按次支付查询费用
适用场景
适合助手需要核实意大利公共部门交易对手、查找其官方 PEC 地址,或在电子发票前确认机构是否存在时使用;也适合只需快速离线检查增值税号格式的场景。
运行要求
通过 Streamable HTTP 连接的远程端点;未声明需要账号、API 密钥或请求头。付费查询需要支持 x402 的客户端和已充值的 Base 钱包(默认 USDC,可选 EURC);使用默认支出控制的客户端可能只允许 USDC。需要能访问该端点的网络。
安装前请注意
查询工具每次调用都会花钱(Base 主网 0.005 USDC 或 EURC),请在客户端设置支出上限。格式校验并不确认增值税号已注册。IndicePA 数据为 CC BY 4.0,须注明来源。README 说明基于 VIES 的增值税端点已停用,滥用或重复查询会按 IP 封禁。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ItalyCheck,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.yeick010%2Fitalycheck/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "italycheck": {
      "type": "http",
      "url": "https://italycheck.italycheck.workers.dev/mcp"
    }
  }
}

README

ItalyCheck (MVP)

[ItalyCheck MCP server] Verifica fornitori pagata a chiamata dagli agenti AI. Solo fonti pubbliche gratuite. Pagamento x402 (USDC o EURC su Base).

Endpoint

PathPrezzoFonte
GET /v1/vat?vat=IT00743110157$0.01EU VIES REST (passthrough in tempo reale, nessuna conservazione)
GET /v1/pa?cf=80016350821$0.005 USDC o €0.005 EURCIndicePA, dataset "Enti" (AgID, CC BY 4.0, attribuzione obbligatoria)
GET /v1/vat/format?vat=...gratischecksum P.IVA offline
GET /gratiscatalogo con descrizioni per agenti

Uso

npm installnpm test              # test live su VIES + IndicePA, 402 x402, MCPnpm run dev           # senza pagamenti, porta 8787npm start             # con x402 (testnet Base Sepolia, facilitator x402.org)ITALYCHECK_URL=https://... npm run mcp   # server MCP stdio (proxy). ITALYCHECK_LOCAL=1 = lookup locali

Passare in produzione (NON fatto)

  1. PAY_TO = indirizzo wallet Base di Yeison.
  2. X402_NETWORK=eip155:8453; facilitator CDP (npm i @coinbase/x402, chiavi CDP_API_KEY_ID/SECRET; 1.000 tx/mese gratis, poi $0.001).
  3. npx wrangler deploy su Cloudflare Workers Free (uso commerciale consentito, 100k richieste/giorno, 10 ms CPU).
  4. Lo scopre il Bazaar dopo il primo pagamento regolato tramite facilitator CDP. Pubblicare il MCP su MCPize/Smithery.

Vincoli legali

  • Il disclaimer VIES consente l'uso solo per verificare la partita IVA per operazioni intracomunitarie. È vietata ogni estrazione non conforme e l'abuso viene bloccato per IP (es. stessa partita IVA più volte al giorno). Quindi niente cache condivisa, niente archivi, niente scraping massivo.
  • IndicePA: CC BY 4.0, va citata la fonte "© AgID – IndicePA".

Stato del deploy (16/10/2026)

  • Online: https://italycheck.italycheck.workers.dev (Cloudflare Workers Free, Base Sepolia testnet, facilitator x402.org)
  • Solo /v1/pa a pagamento. /v1/vat (VIES) disattivato: ENABLE_VAT="0", in attesa di parere legale.
  • Deploy: CLOUDFLARE_ACCOUNT_ID=... npx -y -p node@22 node ./node_modules/wrangler/bin/wrangler.js deploy (wrangler 4 richiede Node 22).
  • Il Worker crea una nuova app per ogni richiesta e mette in cache solo la risposta "supported" del facilitator, come dati. Condividere promise in corso tra più richieste bloccava le richieste su Workers.

Mainnet (16/10/2026, sera)

  • Rete Base mainnet eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, facilitator CDP. I segreti CDP_API_KEY_ID e CDP_API_KEY_SECRET sono in Cloudflare (wrangler secret).
  • Bazaar: estensione discovery con schema e esempio. Validato da CDP /x402/validate: valid true.
  • MCP remoto: POST /mcp (Streamable HTTP, stateless). lookup_italian_pa si paga con x402 via MCP (@x402/mcp).
  • CPU: src/bazaar-shim.js (alias wrangler) salta la rivalidazione ajv per ogni richiesta. JWT CDP e risposta "supported" sono in cache come dati.
  • Vedi SUBMISSIONS.md per la discovery.

EURC (24/10/2026)

  • /v1/pa e il tool MCP lookup_italian_pa accettano anche EURC su Base, oltre a USDC. USDC resta la prima opzione (default) in accepts; EURC è la seconda, stesso importo nominale (0.005 EURC = 5000 unità, 6 decimali), stesso payTo.
  • EURC Base mainnet 0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42 (Circle: https://developers.circle.com/stablecoins/eurc-contract-addresses). Base Sepolia 0x808456652fdb597867f38412077A9182bf77359F. Dominio EIP-712 letto on-chain: name EURC, version 2.
  • Il facilitator CDP accetta ogni ERC-20 con EIP-3009 (USDC, EURC) sulle sue reti EVM: https://docs.cdp.coinbase.com/x402/support/faq
  • Nota per chi compra: i client @x402 2.28 con spendControls predefiniti accettano solo gli asset predefiniti (USDC). Per pagare in EURC servono spendControls.allowedAssets con EURC, oppure allowedAssets: true.
  • Per disattivare EURC: variabile DISABLE_EURC="1".

来源:README.md,提交 43c356b

工具

2

check_partita_iva_format

Free offline check of an Italian partita IVA (11 digits + check digit). Does not confirm registration.

输入参数piva必填

lookup_italian_pa

Look up an Italian public administration or public-service operator by 11-digit codice fiscale in IndicePA (AgID). Use when an agent must verify a public-sector counterparty, find its official PEC (certified email) addresses, or confirm it exists before e-invoicing. Costs $0.005 in USDC on Base via x402.

输入参数cf必填

版本历史

1
  1. v0.2.0最新Oct 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Check 集成