x402 Trust

Name: x402 Trust
Author: x402 Trust

本地服务

x402-trust.com搜索与检索12 周前更新

文档代码仓库访问官网

关于 x402 Trust

x402 Trust 是用于查找 x402 端点并在付款前评估其可信度的 MCP 服务。它提供可搜索的目录、可审计评分、历史记录、批量检查和监控；付费检查可在配置限额内自动付款。

主要功能

01按关键词或语义搜索端点
02查看生态统计和可信度排名
03查询端点评分、等级、价格和标记
04查看端点探测与事件历史
05批量评分并监控变化

适用场景

01按能力描述查找 x402 服务
02付款前比较端点可信度
03查看端点可靠性和价格历史
04跟踪端点停机、价格变化和规范退化

MCP 相关

向 MCP 客户端提供 x402 端点发现、可信度评估、历史记录、批量评分和监控管理工具。付费工具通过 x402 付款；配置本地钱包后可在限额内自动付款。

#x402 #trust #score #compliance #endpoint #search #discovery

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "x402-trust": {
      "command": "npx",
      "args": [
        "-y",
        "x402-trust-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "X402_MAX_USD": "<X402_MAX_USD>",
        "X402_MAX_TOTAL_USD": "<X402_MAX_TOTAL_USD>",
        "X402_MAX_CALLS": "<X402_MAX_CALLS>",
        "X402_TRUST_API_BASE": "<X402_TRUST_API_BASE>",
        "X402_TIMEOUT_MS": "<X402_TIMEOUT_MS>"
      }
    }
  }
}

启动命令npx -y x402-trust-mcp

需要配置的环境变量

X402_PRIVATE_KEY密钥Optional Base wallet private key (with or without the 0x prefix). When set, the paid tools auto-pay over x402 up to X402_MAX_USD; otherwise they return a price quote. The free tools need no key.

X402_MAX_USDPer-call auto-pay ceiling in USD. 0 disables auto-pay.

X402_MAX_TOTAL_USDCumulative auto-pay cap per process in USD. 0 = unlimited.

X402_MAX_CALLSMax paid calls per process. 0 = unlimited.

X402_TRUST_API_BASEAPI base URL.

X402_TIMEOUT_MSRequest timeout in milliseconds.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmx402-trust-mcp1.16.0stdio

工具

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

x402-trust-mcp

一个用于 发现 x402 端点并在付款前检查其可信度 的 MCP 服务：可在受监控的目录中进行语义和关键词搜索，并提供任何端点的可信度评分、历史记录、批量评分和监控功能。

该服务由 x402-trust.com 提供支持，全天候监控 Base 和 Solana 上的 x402 生态系统：包括运行时间探测、402 信封规范合规性、价格历史记录，以及每个端点真实的链上 USDC 结算量。所有评分均通过确定性方式计算，不涉及大模型，因此评分细目完全可审计。

工具

工具	费用	描述
`x402_ecosystem_stats`	免费	x402 生态系统整体快照：端点数量、可访问性，以及过去 30 天的真实 USDC 结算量。
`x402_trust_leaderboard`	免费	最可信 x402 主机的前 100 名排名，根据其整体测量范围评分。使用 `offset` 翻页。
`x402_verified_providers`	免费	已证明域名控制权并确认联系邮箱的主机。仅供参考，验证不会影响评分。
`x402_search`	免费	在整个目录中按主机、URL 和服务名称进行子串搜索。
`x402_semantic_search`	免费	基于含义的搜索：用通俗语言描述你需要的功能。仅用于发现，不提供判定。
`x402_trust_preview`	免费	三份完整的可信度报告（最高、中位和最低），格式与 `x402_trust_score` 返回的完全相同。
`x402_trust_score`	付费	单个端点的完整可信度判定：0-100 分、等级、建议、价格和标记。未知端点会立即进行实时探测。
`x402_endpoint_history`	付费	单个端点过去 1-90 天的原始探测和事件历史记录。
`x402_find_alternatives`	付费	语义上相似且评分高于指定端点的端点。结果为空表示没有更好的选择。
`x402_trust_bulk`	付费	一次调用为最多 500 个端点评分；自动选择能满足需求的最低价档位（10/50/100/200/500）。
`x402_watch_create`	付费	对单个端点进行 30 天监控：通过轮询或 webhook 发送有关 payTo 或价格变更、下架、规范退步和服务中断的警报。返回一次性密钥。
`x402_watch_events`	免费	使用监控 ID 和密钥轮询监控事件日志，并通过返回的游标翻页。
`x402_watch_edit`	免费	更改监控的 webhook URL、灵敏度或订阅事件。
`x402_watch_cancel`	免费	立即停止监控；其日志在到期前仍可读取。
`x402_watch_renew`	付费	为有效监控增加 30 天。使用相同密钥。

付费工具的费用从 $0.005（单次查询）到 ~$0.50（批量查询 500 个端点）不等，通过 x402（Base 上的 USDC）收取。设置 X402_PRIVATE_KEY 后，服务会在你的限额内自动付款；否则会返回价格报价，由你的主机付款。列表工具使用 limit（最大值为 25）和 offset 翻页，并返回 total。

字段级文档、判定语义、监控游标规则和 webhook 签名详情见 x402-trust.com/llms.txt；每个响应都可通过其 x402-trust.com/schemas 中的架构自我描述。

安装

添加到 MCP 客户端配置中（例如 Claude Desktop 的 claude_desktop_config.json）：

{
  "mcpServers": {
    "x402-trust": {
      "command": "npx",
      "args": ["-y", "x402-trust-mcp"]
    }
  }
}

要为付费工具启用自主付款，请添加一个已注资的 Base USDC 钱包：

{
  "mcpServers": {
    "x402-trust": {
      "command": "npx",
      "args": ["-y", "x402-trust-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0xYOUR_BASE_WALLET_KEY",
        "X402_MAX_USD": "0.05"
      }
    }
  }
}

配置（环境变量）

变量	默认值	描述
`X402_TRUST_API_BASE`	`https://x402-trust.com`	API 基础 URL。
`X402_PRIVATE_KEY`	(未设置)	基础钱包私钥。启用付费工具的自动付款。若已设置但格式错误，则会记录警告并关闭自动付款。
`X402_MAX_USD`	`0.05`	单次调用的自动付款上限。设为 0 可关闭自动付款。
`X402_MAX_TOTAL_USD`	`1.00`	每个进程的累计自动付款上限。设为 0 表示不设上限。
`X402_MAX_CALLS`	`1000`	每个进程的付费调用次数上限。设为 0 表示不设上限。
`X402_TIMEOUT_MS`	`20000`	请求超时时间。
`X402_BASE_RPC_URL`	公共 Base RPC	用于预签名 USDC 余额检查的端点（免费的 `eth_call`；默认使用公共 Base 主网 / Sepolia RPC）。

免费工具无需任何配置即可使用。

安全性

X402_PRIVATE_KEY 是热钱包：只向其中存入你愿意用于信任查询的金额。密钥不会离开你的机器；它会在通过策略检查后，在本地签署 EIP-3009 付款授权：包括链允许列表（默认仅限 Base 主网）、规范 USDC 合约验证，以及上述支出和调用次数上限。每次付款前，客户端都会重新读取钱包的 USDC 余额：如果钱包余额不足以支付报价，系统会在本地拒绝，不会签署任何内容，因此空钱包不会导致结算失败的尝试；充值后，下一次调用即可生效。

响应签名

已签名的工具结果包含顶层 signature 块：它是对 JCS 规范化（RFC 8785）响应的 Ed25519 签名，可证明内容由 x402-trust 生成，之后未被修改。

验证时有一条重要规则：固定信任锚，绝不要从响应中获取信任锚。 signature.publicKeys 只是发现提示；伪造的响应可以指向攻击者自己的密钥文档，并且仍然通过验证。应固定公钥本身，或在启动时获取一次 https://x402-trust.com/.well-known/x402-trust-keys.json 并缓存。可在 x402-trust.com/schemas 查看完整测试向量和一份 20 行的参考验证器。Watch 管理响应按设计不带签名：其中包含绝不能转发为证据的能力密钥。