使用说明
付费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_KEYPRIVATE_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支付协议 自动流动:
- 代理调用工具(例如。,
aave-best-yield) - MCP服务器向PayToll API发送请求
- API以
402 Payment Required以及付款详情 - MCP服务器使用您钱包的私钥签署USDC付款
- MCP服务器重试已签名的付款
- API验证付款,执行请求,在Base上结算
- 结果返回给代理
当没有配置钱包密钥时,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
许可证
麻省理工学院