DeFi工具服务

PayToll MCP服务器提供27种工具,涵盖DeFi、交换、跨链桥接、社交、链上数据和AI功能,支持基于x402微支付的Base链上USDC按次付费。无需API密钥或订阅。

  • by foodaka
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 foodaka/paytoll-mcp

使用说明

付费mcp

MCP服务器 付费通行费 --27个用于DeFi、交换、桥接、社交、链上数据和人工智能的工具,由 x402 基础上的小额支付。没有API密钥,没有订阅。您的人工智能代理以美元支付每次通话费用。

快速开始

# Works without PRIVATE_KEY while API free tier is available
npx -y paytoll-mcp

# Add PRIVATE_KEY (or keychain/secret-service source) for paid/unlimited access
PRIVATE_KEY=0xYourKey npx -y paytoll-mcp

服务器连接到PayToll API,发现所有可用的工具,并通过stdio注册它们。您的代理可以立即开始查询DeFi数据、交换令牌、搜索Twitter、提示LLM等。

安全: 使用资金最少的专用钱包。不要使用你的主钱包。私钥仅用于签署x402小额支付(每次通话的几分之一),它永远不会离开你的机器,也不会发送到任何服务器。

需求

  • Node.js 20+
  • 钱包密钥可用于免费通话
  • 付费通话需要一个钱包私钥,其中包含Base上的USDC(+少量ETH用于加油)

对于成千上万的API调用来说,几美元的USDC就足够了。

配置

变量 描述 默认值
PRIVATE_KEY 钱包私钥(十六进制,前缀0x)。回退选项。 未设置
PRIVATE_KEY_KEYCHAIN_SERVICE 钱包密钥的macOS钥匙链服务名称 未设置
PRIVATE_KEY_KEYCHAIN_ACCOUNT macOS钥匙串帐户(默认为 $USER) $USER
PRIVATE_KEY_SECRET_SERVICE Linux秘密服务密钥属性 service 未设置
PRIVATE_KEY_SECRET_ACCOUNT Linux秘密服务密钥属性 account (默认为 $USER) $USER
PRIVATE_KEY_COMMAND 将私钥打印到stdout unset的命令
PAYTOLL_API_URL PayToll API端点 https://api.paytoll.io
FREE_TIER_DAILY_LIMIT 免费等级每日上限的启动消息提示 50

对于付费流量,服务器需要一个关键来源:

  • PRIVATE_KEY
  • PRIVATE_KEY_KEYCHAIN_SERVICE (macOS)
  • PRIVATE_KEY_SECRET_SERVICE (Linux/Ubuntu)
  • PRIVATE_KEY_COMMAND

如果没有设置密钥源,MCP服务器将以自由层模式启动,并在以下情况下返回一个明确的错误:

  • 免费等级已用尽,或
  • 被调用的端点是仅付费的(例如默认API配置上的社交/X或AI路径)。

安全密钥存储(推荐)

macOS钥匙扣

存储密钥一次:

security add-generic-password -a "$USER" -s paytoll-mcp -w '0xYOUR_PRIVATE_KEY'

然后运行:

PRIVATE_KEY_KEYCHAIN_SERVICE=paytoll-mcp npx -y paytoll-mcp

Ubuntu(GNOME特勤局)

安装CLI:

sudo apt-get update && sudo apt-get install -y libsecret-tools

存储密钥一次:

printf '0xYOUR_PRIVATE_KEY' | secret-tool store --label='PayToll MCP Wallet' service paytoll-mcp account "$USER"

然后运行:

PRIVATE_KEY_SECRET_SERVICE=paytoll-mcp npx -y paytoll-mcp

设置

对于下面的macOS示例,请使用 PRIVATE_KEY_KEYCHAIN_SERVICE.在Ubuntu/Linux上,使用 PRIVATE_KEY_SECRET_SERVICE 具有相同的值。

克劳德桌面版

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "paytoll": {
      "command": "npx",
      "args": ["-y", "paytoll-mcp"],
      "env": {
        "PRIVATE_KEY_KEYCHAIN_SERVICE": "paytoll-mcp"
      }
    }
  }
}

重新启动克劳德桌面。您将在工具菜单中看到PayToll工具。

克劳德代码

添加到 .claude/settings.json:

{
  "mcpServers": {
    "paytoll": {
      "command": "npx",
      "args": ["-y", "paytoll-mcp"],
      "env": {
        "PRIVATE_KEY_KEYCHAIN_SERVICE": "paytoll-mcp"
      }
    }
  }
}

光标

添加到 .cursor/mcp.json 在您的项目中:

{
  "mcpServers": {
    "paytoll": {
      "command": "npx",
      "args": ["-y", "paytoll-mcp"],
      "env": {
        "PRIVATE_KEY_KEYCHAIN_SERVICE": "paytoll-mcp"
      }
    }
  }
}

龙虾

/install paytoll

不要设置为原始状态 PRIVATE_KEY 在OpenClaw环境设置中。

改为设置一个非秘密选择器:

  • macOS: PRIVATE_KEY_KEYCHAIN_SERVICE=paytoll-mcp
  • Ubuntu: PRIVATE_KEY_SECRET_SERVICE=paytoll-mcp

如果不使用,则可选 $USER:

  • macOS: PRIVATE_KEY_KEYCHAIN_ACCOUNT=your-account
  • Ubuntu: PRIVATE_KEY_SECRET_ACCOUNT=your-account

可用工具(27)

DeFi智能-Aave V3

工具 描述 价格
aave-best-yield 为所有链中的资产查找最佳供应APY 0.01美元
aave-best-borrow 查找所有链中资产的最低借款年利率 0.01美元
aave-markets 包含TVL和费率的所有Aave V3市场概述 0.005美元
aave-health-factor 获取头寸的健康因素和清算风险 $0.005
aave-user-positions 获取钱包的所有供应/借款头寸 $0.01

DeFi交易——Aave V3

为Aave操作构建未签名的交易数据。返回交易有效载荷供您的钱包签名-- 不广播或执行交易.

工具 描述 价格
aave-supply 建立供应(存款)交易 $0.01
aave-borrow 建立借款交易 $0.01
aave-repay 创建还款交易 $0.01
aave-withdraw 创建提款交易 $0.01

DEX掉期和交叉链桥

由...驱动 李菲 聚合器。支持跨12个网络(以太坊、Base、Arbitrum、Optimism、Polygon、Avalanche、BSC、zkSync、Linea、Scroll、Fantom、Gnosis)的相同链交换和跨链桥。

工具 描述 价格
swap-quote 获得DEX掉期或跨链过桥报价 $0.005
swap-build 构建用于签名的掉期/过桥交易 $0.01
token-balance 检查任何链上的钱包令牌余额 $0.005

要桥接,请设置 fromChain 和 toChain 不同的链ID。Li.Fi通过最佳网桥协议(Stargate、Across、Hop等)自动路由。

链上令牌数据

工具 描述 价格
onchain-token-data 代币价格、供应量、FDV、市值、顶级池 0.015美元
onchain-token-price 按合约地址列出的链上代币价格 $0.015
search-pools 按名称、符号或地址搜索流动性池 $0.015
trending-pools 按交易活动划分的网络趋势池 $0.015

社交媒体-X/Twitter

工具 描述 价格
twitter-search 搜索最近的推文(过去7天) $0.08
twitter-user-tweets 获取用户最近的推文 $0.08
twitter-tweet-lookup 按ID查找推文(每次通话最多10条) 0.02美元
twitter-user-lookup 按用户名或ID查找用户 $0.02
twitter-post 发布推文(需要您的OAuth令牌) $0.015

加密实用程序

工具 描述 价格
crypto-price 实时加密货币价格(CoinGecko) 0.015美元
ens-lookup 将ENS名称解析为地址(反之亦然) $0.001
wallet-validator 使用校验和验证钱包地址 $0.0005

AI--LLM代理

工具 描述 价格
llm-openai GPT-4o、GPT-4 Turbo、GPT-3.5 Turbo、o3 mini 0.01美元
llm-anthropic 克劳德十四行诗4,俳句4,克劳德3.5 0.01美元
llm-google Gemini 2.0 Flash、1.5 Pro、1.5 Flash 0.01美元

所有工具都是在启动时从API自动发现的。

运作原理

AI Agent (Claude, Cursor, etc.)
  |  stdio JSON-RPC
  v
paytoll-mcp
  |  1. Startup: GET /v1/meta -> discover all endpoints -> register MCP tools
  |  2. Tool call: POST endpoint -> 402 -> auto-sign USDC payment -> retry -> result
  v
PayToll API (api.paytoll.io)

代理人看不到付款。MCP服务器处理全部 x402支付协议 自动流动:

  1. 代理调用工具(例如。, aave-best-yield)
  2. MCP服务器向PayToll API发送请求
  3. API以 402 Payment Required 以及付款详情
  4. MCP服务器使用您钱包的私钥签署USDC付款
  5. MCP服务器重试已签名的付款
  6. API验证付款,执行请求,在Base上结算
  7. 结果返回给代理

当没有配置钱包密钥时,MCP服务器首先发送普通请求(自由层模式)。如果API返回 402,MCP报告付费访问需要钱包密钥。

您的私钥 永远不要离开你的机器。它仅在本地用于对x402付款的EIP-712类型数据进行签名。PayToll API和MCP服务器通过HTTPS进行通信-密钥本身从不传输。

安全

  • 使用专用钱包。 只使用您需要的USDC/ETH创建一个新钱包。不要重复使用你的主钱包。
  • 私钥保持在本地。 该密钥仅用于在您的计算机上签署付款授权。它从不发送到任何服务器。
  • 没有交易执行。 交易构建工具(aave-supply, swap-build等等)返回未签名的交易数据。他们不在链上广播任何内容。
  • 付款是小额的。 大多数通话费用为0.001-0.08美元。几美元可以拨打数千个电话。
  • 开源。 整个MCP服务器都是开源的——自己审核吧。

发展

git clone https://github.com/foodaka/paytoll-mcp.git
cd paytoll-mcp
npm install
npm run build
PRIVATE_KEY_KEYCHAIN_SERVICE=paytoll-mcp npm start

许可证

麻省理工学院