关于 payment-guard-mcp
payment-guard-mcp 是面向资金操作 Agent 的 MCP 服务,可在付款或授权前检查 EVM 地址、ENS 名称、支付链接和代币合约。确定性检查返回安全、谨慎或拦截结果,并说明覆盖范围。
主要功能
- 01根据制裁及诈骗名单筛查 EVM 地址
- 02检查支付链接及重定向目标
- 03解析并筛查 ENS 名称
- 04检查代币蜜罐及税费风险
- 05返回带覆盖范围说明的判定
适用场景
- 01Agent 转账前核验收款地址
- 02付款前检查 x402 或商户链接
- 03购买或授权前筛查代币合约
MCP 相关
向 MCP 客户端提供地址、支付链接、ENS、制裁及代币筛查工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
5收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| chain | enum | 否 | EVM 链(默认 eth)。eth | base | polygon | arbitrum | optimism |
| address | string | 是 | EVM 地址(0x + 40 位十六进制字符)或 ENS 名称(例如 name.eth)。 |
详细介绍
payment-guard-mcp
一个 MCP 服务,可在 Agent 付款前检查收款对象。提供加密货币地址、ENS 名称或付款 URL,即可获取判定结果。确定性检测,不使用大模型,且免费。
Agent 已开始通过加密货币支付通道、x402 端点和付款链接自行转移真实资金。最明显的风险是误付给受制裁或诈骗地址,这类转账通常无法撤销。screen_address 是应首先运行的检查。
安装
{ "mcpServers": { "payment-guard": { "command": "npx", "args": ["-y", "payment-guard-mcp"] } } }
工具
screen_address:主要防护工具。接收 EVM 地址或 ENS 名称,并检查 OFAC 制裁名单、诈骗和滥用黑名单,以及链上信号(全新且未使用的地址、合约)。返回 safe、caution 或 block。screen_payment:审核 x402 或商户付款 URL,检查伪编码主机名、位于可注册域名之外的知名品牌名称、短链接、易遭滥用的顶级域名、新注册域名,以及重定向后的最终 URL。check_sanctioned:针对地址或 ENS 名称进行快速的 OFAC 制裁名单检查。resolve_name:将 ENS 名称解析为地址,并检查该地址。可发现无法解析的名称,但无法检测伪装的相似名称。screen_token:购买、兑换或批准代币前,检查合约是否存在蜜罐行为(可以买入但无法卖出)、极高的卖出税,以及是否命中黑名单。
链上检查支持 Ethereum、Base、Polygon、Arbitrum 和 Optimism。数据来自 OFAC SDN 名单、社区诈骗名单(ethereum-lists、ScamSniffer)、公共 RPC 节点和 ENS。
ENS 覆盖范围:通过 namehash 解析名称,然后在主网 ENS 注册表上调用 resolver(node),再直接调用 addr(bytes32)。返回的地址会根据制裁名单和诈骗名单进行检查。不提供易混淆字符检查,也不进行 ENSIP-15 规范化,因此无法检测相似名称和同形异义名称。不支持 ENSIP-10 通配符解析和 CCIP-Read,因此即使钱包可以解析,链下和 L2 名称——Basenames、.cb.id、免 gas 子名称——在这里也会报告为无法解析。
蜜罐覆盖范围:买入和卖出模拟由 api.honeypot.is 提供,仅支持 Ethereum 和 Base。对于 Polygon、Arbitrum 和 Optimism,该服务会返回 400 Invalid chain,因此不会填充蜜罐和税费字段。响应会说明支持哪些链;若未运行模拟,判定结果绝不会是 safe,而会是 caution;若已命中诈骗黑名单,则为 block。
URL 覆盖范围:相似名称规则会对 14 个品牌名称进行子字符串匹配;若品牌名称不是可注册域名,则会标记。paypal.com.secure-pay.xyz 会被检测到;paypa1.com 则不会,因为规则不计算编辑距离,也不映射同形异义字符。比较的仅是重定向后的最终 URL,而非每个跳转环节。
明确说明制裁名单的覆盖范围:OFAC 按货币而非链发布受制裁地址,因此此检查会合并所有 EVM 格式名单(ETH、ARB、BSC、ETC、USDC、USDT),并将结果应用于任何 EVM 链。不会检查 Bitcoin、Tron、Solana、Monero 和其他非 EVM 受制裁地址,因为这里只接受 EVM 地址。每个响应都会附带一个覆盖范围对象,说明这一点。如果无法加载名单,结果会是 unknown,绝不会是 clear。
规则更新
此服务大约每天会向规则源查询是否有更新的规则集,并在有更新时应用。请求会携带两项信息:发起请求的界面(此处为 facade),以及当前已安装的规则版本。不包含机器 ID、用户 ID、文件名或任何扫描过的内容。
规则包使用 Ed25519 签名,并通过编译进此软件包的公钥进行验证,因此由哪个镜像提供规则包并不重要。若规则包未通过签名、架构或 ReDoS 检查,则会被丢弃,现有规则保持不变。--offline 会关闭更新;设置 AGENT_GUARDS_NO_FEED=1 或在 ~/.agent-guards/config.json 中设置 {"feed": false} 也会关闭更新。规则包格式及自行验证的方法:https://github.com/mlawsonking/MCP/blob/main/rules/README.md
此服务会调用 https://payment-guard.vercel.app(可设置 PAYMENT_GUARD_API 进行覆盖)。这是此仓库中的六种 Agent 防护工具之一。MIT。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。