Coinlooter

PayFlowAgent — MCP 服务与参考 Agent

面向自主 AI Agent 的按次付费 API。通过 x402 使用 USDC，无需注册。

MCP 注册表名称： io.github.Coinlooter/mcp

• Hub（目录）： payflowagent.net
• nad.fun 情报： nad.payflowagent.net
• DeFi 数据馈送： data.payflowagent.net
• npm： [email protected]

此代码库包含开源集成组件：

路径	内容
/（根目录）	payflowagent-mcp — 适用于 Cursor、Claude Desktop 和自定义 Agent 的 MCP 服务。
examples/screen-bot/	参考轮询机器人：每隔几分钟查找高分 nad.fun 代币。

评分 API 在 PayFlowAgent 基础设施上运行；此代码库提供客户端接口， 让 Agent 和开发者一步即可完成集成。

工具（MCP）

nad.fun（Monad）

工具	价格	描述
score_token	免费	0–100 分、riskLevel、action（有速率限制）。
decide_token	x402	完整报告：影响因素、毕业情况、动量。
token_summary	x402	毕业进度 + 动量（低成本入门）。
screen_tokens	x402	经过预评分的新代币排名列表。

Datafeed（DeFiLlama）

工具	价格	描述
sample_yields	免费	收益率最高的池 + 3 项机会预览（评分 + 原因）。
yield_opportunities	x402	收益机会排名，附带风险评分和可解释原因。

安装（一行命令）

npx -y [email protected]

在 Cursor 中使用

~/.cursor/mcp.json（或项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "payflowagent": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "PAYFLOWAGENT_API_BASE": "https://nad.payflowagent.net",
        "PAYFLOWAGENT_DATAFEED_BASE": "https://data.payflowagent.net"
      }
    }
  }
}

在 Claude Desktop 中使用

配置与 Cursor 相同（Settings → Developer → MCP Servers）。

如果未设置 X402_BUYER_PRIVATE_KEY，则只能使用免费工具（score_token、sample_yields）。 请使用专用付款钱包（Base、USDC）——切勿使用主钱包。

配置（环境变量）

变量	默认值	用途
PAYFLOWAGENT_API_BASE	https://nad.payflowagent.net	nad.fun API 基础 URL。
PAYFLOWAGENT_DATAFEED_BASE	https://data.payflowagent.net	Datafeed API 基础 URL。
X402_BUYER_PRIVATE_KEY	—	付款钱包密钥（Base、USDC）。启用付费工具。
X402_BUYER_RPC	https://mainnet.base.org	付款 RPC（可选）。

MCP 注册表

发布到 npm 后，可在官方注册表中登记：

npm install -g @modelcontextprotocol/publisher
cd payflowagent-mcp
mcp-publisher login github
mcp-publisher publish

清单：server.json（io.github.Coinlooter/mcp）。

参考 Agent

请参阅 examples/screen-bot — 每隔几分钟轮询 /v1/screen， 去重，并在发现新的高分代币时发出提醒（可选 Webhook）。 Fork 此项目，并将其指向你自己的交易逻辑。

本地开发

npm install
npm run typecheck
npm run build      # emits dist/
npm start          # stdio server from source (tsx)

发布到 npm

npm run build
npm publish

许可证

MIT — 请参阅 LICENSE。