Israel Business Intelligence MCP

以色列发票付款关卡与交易对手情报

在付款前检查以色列供应商发票的单一 Agent 原生关卡，并提供来自公共登记处的交易对手证据。

公共来源：https://github.com/itzikhr18/israel-counterparty-intelligence

项目状态（请先阅读）

有关当前生产状态、待跟进事项、阻碍因素和后续行动，请参阅 docs/PROJECT_STATUS.md。合作伙伴入口：PARTNER_HANDOFF.md。

**自备可信钱包：**免费的发票结果可为现有 x402 客户端准备经过验证的私密请求， 其中包含免费的供应商匹配和 0.25 USDC 的建议上限。 无需卖家钱包包。下载并不代表批准付款；买方的钱包必须 强制执行实时条款。独立钱包指南。

从免费发票检查开始，下载经过验证的 invoice-request.json，然后继续处理同一张发票：

npx --yes https://israel-counterparty-intelligence.vercel.app/israel-company-verify-buyer-0.4.0.tgz --invoice-file invoice-request.json

生产部署中的 /.well-known/x402、/llms.txt 和 /README.md 提供公开 Agent 元数据。Mainnet 和 Testnet 付款资源使用相同的业务逻辑，但采用不同的付款路由，因此 Test USDC 绝不会解锁 Mainnet 资源。

同一验证引擎也以无状态 Remote Streamable HTTP MCP 服务的形式提供：

• POST /mcp - Base Mainnet，包含 0.25 USDC 的以色列发票付款关卡，以及公司变更、验证和供应商风险工具。
• POST /mcp/testnet - Base Sepolia，每次成功调用 verify_company 收取 0.05 Test USDC。
• POST /mcp/pilot - 仅限受邀合作伙伴评估，使用有时限的 bearer token。
• 公司和付款风险预览、preview_agent_payment_trust、describe_service 和 get_schema 在两个 MCP 端点上均免费。

实现 External Paid Call #1 的最低成本路径：company-changes，费用为 $0.01 USDC（省略请求体或使用 {} 时，company_number 默认设为公开示例 514744887，供 marketplace canaries 使用）（低于 verify 的 $0.05 和 invoice-gate 的 $0.25）。未付款的 POST → HTTP 402 → 使用买方控制的 x402 钱包付款。准确的 curl 命令和 MCP 工具 get_israeli_company_changes_paid，请参阅 public/STATUS.md。

此仓库是一个刻意保持精简的 MVP，用于 External Paid Call #1。它会解析一家以色列注册公司，补充其公开政府合同／支持记录，构建字段级证据，并给出透明的启发式风险信号。它不是法律、信用、制裁或投资服务。

当前范围

• POST /v1/verify - 官方公司解析与证据。
• POST /v1/verify/mainnet - 相同的验证结果，使用 Base Mainnet 上的真实 USDC 付款。
• POST /v1/pilot/verify - 仅限受邀合作伙伴评估；绝非公开免费接口。
• POST /v1/government-footprint - 根据准确的公司编号查询公开合同与支持。
• POST /v1/counterparty-risk - 综合结果与确定性、带原因代码的评分。
• POST /v1/payment-risk/mainnet - Mainnet 付款前供应商筛查，结果为 PROCEED、REVIEW 或 BLOCK。
• POST /v1/invoice-gate/preview - 免费预览发票算术与分配适用性，使用日期、金额、VAT 组成部分及买方证明的条件；绝不构成付款授权。
• POST /v1/invoice-gate/mainnet - 0.25 USDC 的、由登记信息支持的以色列发票审核，返回 PAY、HOLD 或 BLOCK。
• POST /v1/company-changes/mainnet - 针对准确公司编号查询近期官方公司备案及状态变更事件，按时间从新到旧排列，并提供来源证据。
• POST /v1/agent-payment-trust - 免费的 x402 预签名防火墙试运行，结果为 ALLOW、REVIEW 或 DENY；绝不签署或提交付款。
• GET /health - 健康检查。
• GET /openapi.json - 机器可读的接口契约。
• 当 X402_ENABLED=true 时，提供 x402 v2 固定价格保护和 Bazaar 元数据。
• 远程 Streamable HTTP MCP，提供付费的 verify_company，以及免费的 preview_company、preview_agent_payment_trust、describe_service 和 get_schema。

分配适用性采用严格大于金额阈值的条件，并且还取决于 VAT 组成部分、授权经销商买方以及买方请求；买方上下文缺失时会安全地返回 HOLD。本服务不会调用或独立验证税务局；官方分配验证需要买方通过其自身的授权经销商／代表连接来完成。买方提供的验证结果会标记为 BUYER_ATTESTED，且不会经过独立验证。不包含：仪表板、账户、订阅、PDF 报告、大范围抓取、银行账户所有权验证、文档取证、UBO/PEP/制裁认证、不良媒体筛查、信用评估、TASE 数据增强或自定义 ML 模型。

已验证收款方防火墙 MVP

preview_agent_payment_trust 会在买方钱包签名前评估准确的 x402 条款。它会解析所声明的以色列公司，从服务源站获取 /.well-known/agent-payee.json（并提供 SSRF 和重定向防护），验证清单和 EVM 签名，检查声明的付款目的地，验证付款资源源站和买方授权，并为付款合约创建稳定的 SHA-256 指纹。

ALLOW 采用失败时拒绝策略：要求公司已解析且处于活跃状态、通过域名获取的清单有效、付款目的地已获授权、资源源站匹配，并且买方授权完整。不得自动签署 REVIEW 和 DENY 结果。Level 1 和 Level 2 保障等级不能证明收款方钱包的法律所有权。清单规范发布于 /agent-payee-manifest-v0.1.md，其 JSON Schema 发布于 /.well-known/agent-payee-schema.json。

生产状态：MAINNET LIVE - 已确认首笔外部付费调用。面向公开买方的摘要：public/STATUS.md（通过 /STATUS.md 提供）。启动无需进行内部 Mainnet 付款。首笔真实的外部 Base Mainnet USDC 付款也是首笔生产环境端到端结算，以及外部付费调用 #1。

公开数据源

公司适配器使用司法部公司注册处开放的 CKAN 公司数据集，以及 data.gov.il 上公司管理局的每日变更数据集。变更数据源覆盖约一年的数据；结果为空并不能证明此前没有发生过变更。官方请求类型会作为事实返回，并映射到确定性的导航类别，而非风险结论。政府足迹适配器使用公开的 BudgetKey 表格 API。源 URL、检索时间、源记录标识符和置信度会在 evidence 中返回。

数据不可用时，服务会返回 null 和 missing_data。它不会将政府合同转化为信誉背书，也不会仅因数据源缺失而增加风险分数。

本地设置

要求：Node.js 20 或更高版本。

npm install
cp .env.example .env.local
npm run dev

运行所有检查：

npm run check

示例

curl -X POST http://localhost:3000/v1/verify \
  -H 'content-type: application/json' \
  -d '{"company_number":"514744887","language":"en"}'

也支持按名称查询：

{
  "company_name": "MONDAY.COM",
  "city": "Tel Aviv",
  "language": "en"
}

存在多个可能的候选项时，API 会返回 409 AMBIGUOUS_ENTITY 和候选项，不会悄无声息地选中其中一个。无效编号会返回 400；对于两个数据补全端点，如果没有可靠的实体，则会返回 422。

x402 配置

此实现使用官方 x402 v2 软件包和 Next.js withX402，因此只有在响应成功后才会进行结算。默认测试设置使用 Base Sepolia，并通过公开的 x402 测试 Facilitator 进行结算。

启用付款所需配置：

X402_ENABLED=true
X402_PAY_TO=0xYourReceivingWallet
X402_NETWORK=eip155:84532
X402_ASSET=0x036CbD53842c5426634e7929541eC2318f3dCF7e
X402_FACILITATOR_URL=https://facilitator.payai.network
PUBLIC_BASE_URL=https://your-public-host.example

价格通过环境变量集中管理：

X402_VERIFY_PRICE=$0.10
X402_GOVERNMENT_PRICE=$0.35
X402_RISK_PRICE=$0.50

独立的 Mainnet 资源使用：

X402_MAINNET_ENABLED=true
X402_MAINNET_PAY_TO=0xYourReceivingWallet
X402_MAINNET_NETWORK=eip155:8453
X402_MAINNET_ASSET=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
X402_MAINNET_FACILITATOR_URL=https://facilitator.payai.network
X402_MAINNET_FACILITATOR_PROVIDER=auto
CDP_API_KEY_ID=
CDP_API_KEY_SECRET=
X402_MAINNET_VERIFY_PRICE=$0.05
X402_MAINNET_PAYMENT_RISK_PRICE=$0.10
X402_MAINNET_INVOICE_GATE_PRICE=$0.25
X402_MAINNET_COMPANY_CHANGES_PRICE=$0.01
X402_MCP_TESTNET_VERIFY_PRICE=$0.05
X402_MCP_MAINNET_VERIFY_PRICE=$0.05
X402_MCP_TESTNET_PAYMENT_RISK_PRICE=$0.10
X402_MCP_MAINNET_PAYMENT_RISK_PRICE=$0.10
X402_MCP_TESTNET_INVOICE_GATE_PRICE=$0.25
X402_MCP_MAINNET_INVOICE_GATE_PRICE=$0.25
X402_MCP_TESTNET_COMPANY_CHANGES_PRICE=$0.01
X402_MCP_MAINNET_COMPANY_CHANGES_PRICE=$0.01
MAINNET_INTERNAL_TEST_PAYER=0xYourIsolatedMainnetTestWallet

没有付款签名时，受保护的端点会返回带有 PAYMENT-REQUIRED 的 402 响应。质询中包含 Bazaar 输入/输出元数据。兼容的付费客户端必须在其付款载荷中回传此扩展。只有 Facilitator 处理了符合要求的付费载荷后，资源才会被纳入目录；最终是否纳入由该 Facilitator 决定。

X402_MAINNET_FACILITATOR_PROVIDER=auto 会在 CDP 凭据齐备之前保留已配置的 URL。添加凭据后，Mainnet 验证和结算会自动切换到经过身份验证的 Coinbase CDP Facilitator。密钥不会出现在质询、日志或健康检查响应中。运行 npm run bazaar:check，可针对 Coinbase Bazaar 验证所有正在运行的付费端点；GitHub Actions 也会每天运行同一项只读检查。

Base Sepolia 和 Base Mainnet 的网络标识符及 USDC 资产会作为不同的配置值进行验证。价格、资产、网络、Facilitator 和 payTo 均由服务器管理，无法通过请求输入覆盖。

MCP 客户端设置

生产环境 MCP URL：

https://israel-counterparty-intelligence.vercel.app/mcp

该端点实现了 Streamable HTTP 和 x402 v2。标准 MCP 客户端可以初始化服务、列出工具并调用免费工具。preview_company 会返回身份／状态信息，以及下一项付费操作可直接复用的确切参数。付费调用 verify_company 会返回结构化的 PaymentRequired 结果，直到客户端使用 _meta["x402/payment"] 重试；结算成功后，结果会在 _meta["x402/payment-response"] 中返回。请使用支持 x402 的 MCP 客户端（例如 @x402/mcp）自动签名并重试。无需买家账户或 API 密钥。

生产环境的 PaymentRequired.resource.description 包含规范的买家指南： https://israel-counterparty-intelligence.vercel.app/x402-buyer-quickstart.md。该指南包含 Streamable HTTP 客户端示例、明确的 Base Mainnet／USDC 要求、各工具的支出限制，以及预期的支付／结算元数据。没有 x402 钱包桥接的普通 MCP 客户端可以发现并调用免费工具，但无法自动完成 verify_company。

适用于 Claude 及其他支持远程 HTTP MCP 服务的客户端的最简配置：

{
  "mcpServers": {
    "israel-business-intelligence": {
      "type": "http",
      "url": "https://israel-counterparty-intelligence.vercel.app/mcp"
    }
  }
}

LangChain 使用相同的 URL，传输方式为 http；CrewAI 和 Google ADK 使用 streamable-http 传输方式。它们的标准 MCP 适配器可以发现并调用免费工具。付费调用需要完成上述 x402 支付元数据往返；无需使用框架专用 SDK。

可在 examples/aerchain-adapter 中找到隔离且由买家控制的供应商入驻组合。它包含严格的 Base Mainnet 支付策略、注册表到供应商的映射、结算回执处理、测试夹具和测试。它不会更改生产服务，也不会将公共注册表证据表述为完整的 KYB。

合作伙伴试点

无法使用 USDC 付款的合作伙伴，可通过仅限邀请的持有者密钥使用完整产品，免除付款，并按合作伙伴计量用量，以 ₪ 或 $ 开具月度发票：

产品	REST（POST）	/mcp/pilot 上的 MCP 工具
发票审核（PAY / HOLD / BLOCK）	/v1/pilot/invoice-gate	authorize_israeli_invoice_payment_paid
公司验证	/v1/pilot/verify	verify_israeli_company_paid（别名 verify_company）
供应商付款风险	/v1/pilot/payment-risk	assess_israeli_vendor_payment_risk_paid
公司变更	/v1/pilot/company-changes	get_israeli_company_changes_paid

契约与付费 Mainnet 路由一致；试点响应会额外包含 pilot 区块和 x-pilot-* 标头。密钥存储在 PILOT_KEYS 环境变量中，格式为 JSON 数组；每个合作伙伴对应一个条目，包含各自的 SHA-256 摘要、有效期和调用额度；原始密钥绝不会进入代码仓库。每次成功调用都会生成一条 pilot_call 事件，其中包含合作伙伴标识符和工具名称，不包含原始令牌或原始 IP 地址。设置 UPSTASH_REDIS_REST_URL 和 UPSTASH_REDIS_REST_TOKEN 后，还会按合作伙伴持久计量用量（试点期和日历月哈希），并根据额度执行限制；GET /v1/pilot/usage 会向合作伙伴返回用量，或向运营方返回所有合作伙伴的用量。未配置 Upstash 时，进程内计数器仅用作安全上限，权威总数以成功的 pilot_call 事件集中计数为准。有关密钥签发、启用、验证、计量和撤销，请参阅试点操作手册。

冒烟测试

针对正在运行且未启用保护的服务以及实时公共数据源：

BASE_URL=http://localhost:3000 npm run smoke

针对正在运行且已启用 x402 的服务，不付款：

BASE_URL=http://localhost:3000 EXPECT_X402=true npm run smoke

x402 冒烟模式会验证 HTTP 402、支付标头、协议版本 2、配置的确切价格以及 Bazaar 元数据。Base Sepolia 已证明完整的结算流程。Mainnet 会保持在线，不进行由运营方出资的自我支付，并等待真实的外部付款方。

MCP 发现和免费工具冒烟测试：

MCP_URL=https://israel-counterparty-intelligence.vercel.app/mcp/testnet npm run smoke:mcp

付费 MCP 冒烟脚本严格限定为 /mcp/testnet，并要求使用从仓库外提供的独立 Base Sepolia 钱包文件：

X402_TEST_WALLET_FILE=/secure/path/test-wallet.json npm run smoke:mcp:paid

风险评分 v0.1.0

• 实体未处于活动状态：+40。
• 注册机构的违法标记：+25。
• 年度报告发布时间超过两年：+10。
• 0-19：低，20-49：中，50-100：高。
• 身份不明确时不进行评分。
• 缺少关键身份数据会阻止评分；缺少补充数据会降低置信度。

每项风险响应都包含 reason_codes、explanation、confidence、scoring_version 和推理依据记录。安全的解读是：在已检查的数据源中，未发现重要的公开警示标记——而不是交易安全。

可靠性与隐私

• 使用 Zod 验证响应的类型化适配器。
• 默认启用中止超时和一次有界重试。
• 六小时内存数据源缓存。
• 每个实例独立的内存速率限制。
• JSON 日志包含请求 ID、耗时、数据源调用、支付是否存在、置信度、错误类别以及缩短的一次性客户端指纹。
• 只有在精确的 Base Mainnet 路由、官方 Base USDC 合约、配置金额和配置的 payTo 上成功结算，才会发出 external_paid_call。排除 Testnet 和配置的内部测试付款方。该事件由结算后的 SDK 钩子发出，包含网络、资产、付款方、金额、交易哈希、资源以及可选的发现来源。
• 不使用用户数据库，应用代码也不记录原始 IP。
• 仓库中不包含任何密钥。
• 试点身份验证会以恒定时间比较 SHA-256 令牌摘要；原始凭据保存在仓库外。

内存缓存和速率限制足以支持首次付费调用实验，但不足以支撑多区域高流量服务。只有出现真实需求后，才添加共享基础设施。

部署

先构建：

npm run check

然后从此目录关联项目并部署：

vercel link
vercel deploy
vercel promote <validated-preview-url>

在 Vercel 中配置运行时环境变量，而不要将其提交到仓库。在确认收款钱包无误之前，保持 x402 禁用。启用 x402 后，重新部署并运行不付款的 402 冒烟测试。不要为了激活或发现而人为制造 Mainnet 结算。

首次外部付费调用

1. 保持 Mainnet 公共端点和发现元数据在线。
2. 等待一个非运营方控制的付款方。
3. 要求使用真实 USDC 完成 Base Mainnet 结算，并且 API 返回 HTTP 200。
4. 排除 Testnet、内部钱包、冒烟测试、爬虫和目录探测。
5. 发出 external_paid_call，包含网络、付款方、金额、交易哈希、资源和时间戳。
6. 将同一事件视为首次 Mainnet 端到端验证和首次外部付费调用。

如果在合理的发现和推广测试后仍未发生外部付费调用，则不要添加功能。调整报价或停止。

政策

• 条款
• 隐私声明
• 更正流程
• 希伯来语实现分析
• 当前阻塞事项
• 付费结算测试

合作伙伴交接

从 PARTNER_HANDOFF.md 开始（状态、系统图、推广 CRM）。