mcpField
X
x402-ads-mcp

x402-ads-mcp

本地服务
github.com/forgemeshlabs商业与营销16 天前更新
代码仓库

关于 x402-ads-mcp

x402-ads-mcp 将 x402 Ads & Intent Network 的机器商业需求数据提供给 Agent 和服务运营者。它包含免费网络信息及按次付费的需求分析，运营者可查看自己服务的报告。

主要功能

  1. 01查看网络计数器与统计
  2. 02预览 402 响应中的推荐内容
  3. 03查询 Agent 请求趋势和类别需求
  4. 04生成单项服务的意图报告
  5. 05通过 CLI 注册发布者服务

适用场景

  1. 01了解 Agent 正在请求的端点和类别
  2. 02评估某类服务的需求量与价格点
  3. 03分析用户为何未购买某项服务
  4. 04注册 API 服务并接入发布者网络

MCP 相关

作为 MCP 服务，提供 x402 网络计数、推荐预览和意图分析工具。付费工具按次通过 x402 在 Base 上以 USDC 结算；发布者可免费获取自身服务报告。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "forgemeshlabs-x402-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-ads-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
        "X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
      }
    }
  }
}
启动命令npx -y @forgemeshlabs/x402-ads-mcp
需要配置的环境变量
WALLET_PRIVATE_KEY密钥Optional dedicated low-balance Base wallet private key for settling paid x402 analytics calls. Without it, paid tools return the x402 payment challenge instead of settling.
X402_ADS_PUBLISHER_KEY密钥Optional publisher key from ads.forgemesh.io. Makes get_intent_report free for your registered services.

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

安装包
npm@forgemeshlabs/x402-ads-mcp0.2.5

工具

8

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

此工具无需参数。

详细介绍

@forgemeshlabs/x402-ads-mcp

M8ven Score mcpservers.org

只需安装一个中间件，即可通过推荐、发现和机器商务分析，将闲置的 402 响应变现。

这是该网络的 MCP 端：了解自主 Agent 在 x402 生态中探测什么、需要什么以及放弃什么，并将其作为工具提供给你的 Agent。

此服务封装了 ForgeMesh x402 Ads & Intent Network。付费工具通过 x402 protocol 在 Base 主网上以 USDC 按次结算——无需账户或 API 密钥；你的钱包就是登录凭证。发布者可免费获取其自有服务的报告。

安装

{
  "mcpServers": {
    "intent": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/x402-ads-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x... (optional — enables paid analytics)",
        "X402_ADS_PUBLISHER_KEY": "pub_... (optional — free reports on your own services)"
      }
    }
  }
}

两个环境变量均为可选项。如果都未设置，免费工具仍可正常使用，付费工具则会返回 x402 付款挑战（价格、网络、payTo），而不会进行结算——便于在花费任何资金前进行检查。

附加福利：一条命令注册发布者

此软件包还可用作 API 运营方的注册 CLI（无需 MCP 客户端）：

# read the terms first: https://ads.forgemesh.io/terms
WALLET_PRIVATE_KEY=0xYOUR_WALLET npx -y @forgemeshlabs/x402-ads-mcp register \
  --url https://api.your-service.com --accept-terms

在 Base 上支付一笔 $0.10 USDC；付款钱包将成为你的身份，发布者密钥只会显示一次。无效请求会在付款之前被拒绝——你不会为注定失败的注册付款。

工具

工具价格返回内容
get_network_counters免费实时网络总量：已观测的 402 响应、Agent 类请求、已提供的推荐
preview_recommendations免费中间件注入 402 响应的完整推荐内容
get_terms免费标准条款及完整的数据收集披露
get_network_stats$0.005网络总量，以及监控器／索引器／Agent 分类明细
get_intent_trends$0.01自主 Agent 请求最多的端点和类别
get_category_demand$0.02单个类别的需求深度：请求量、买家占比、价格区间
get_intent_report$0.05 / 免费*单项服务的“Agent 为何未购买”转化漏斗

* 如果设置了 X402_ADS_PUBLISHER_KEY，则对于你提供过事件数据的服务，get_intent_report 免费——这是数据合作规则：自己的数据永久免费。

环境变量

变量必填用途
WALLET_PRIVATE_KEY否持有 USDC 的 Base 主网钱包；启用付费工具的自动结算
X402_ADS_PUBLISHER_KEY否ads.forgemesh.io 提供的发布者密钥；免费获取你自己的报告
X402_MAX_PRICE_USD否单次调用的美元价格上限；只能低于内置上限（$0.05，或 register 的 $0.10）
X402_SESSION_BUDGET_USD否每个进程的累计上限；只能低于内置的 $10 上限

后端 URL 固定为 https://ads.forgemesh.io（发布者密钥只会发送到该地址）。服务不会为 ForgeMesh Ads 钱包以外的收款方、Base 主网以外的网络、USDC 以外的资产或超过上限的金额签名。请使用专用且余额较低的钱包。密钥不会离开你的设备——付款在本地签名（EIP-3009），并在链上结算。

可直接使用的配置位于 examples/：其中包含 Claude Desktop 的 mcpServers 配置段和带注释的环境变量模板。

测试（从设计上确保安全）

npm test                # smoke: MCP boots over stdio and lists its 7 tools
npm run test:free       # free tools against the live network
npm run test:challenge  # every paid tool returns an x402 challenge — no wallet, nothing can spend
npm run test:all        # all of the above

没有任何测试会结算付款。挑战测试会在加载前删除付款环境变量，因此即使你的 shell 已配置钱包，也无法转移资金。

一句话介绍此网络

我们衡量的是机器商务，而不是 API 内容——运行 @forgemeshlabs/x402-ads 中间件的发布者会贡献匿名化的 402 探测元数据；此 MCP 则将汇总后的需求信号出售给 Agent 和开发者。

发布者发送（以及绝不发送）的内容完整披露：https://ads.forgemesh.io/terms

许可证

MIT © ForgeMesh

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。