registry
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseFrames Registry
Frames 注册中心
Pay-per-call API gateway for AI agents. 4 services available via the x402 payment protocol. No API keys, no subscriptions — just pay per request with crypto.
面向AI Agent的按调用付费API网关。通过x402支付协议提供4项服务。无需API密钥,无需订阅——只需使用加密货币按请求付费。
Base URL
基础URL
https://registry.mcpay.techhttps://registry.mcpay.techPrerequisites
前置条件
A crypto wallet funded with USDC is required to use paid endpoints. Two options:
- AgentWallet (recommended for agents) — server-side wallet that handles 402 detection, payment signing, and retries automatically via a single call. No private key management needed on your side.
POST /x402/fetch - Self-managed wallet — any EVM wallet (Base) or Solana wallet with USDC. You sign x402 payment headers directly.
使用付费端点需要一个充值了USDC的加密货币钱包,有两种选择:
- AgentWallet(推荐Agent使用) —— 服务器端钱包,通过单次调用自动处理402检测、支付签名和重试。无需您这边管理私钥。
POST /x402/fetch - 自管钱包 —— 任何支持USDC的EVM钱包(Base链)或Solana钱包。您需要直接签署x402支付头。
Quick Start
快速开始
- Set up a wallet — create an AgentWallet or fund your own wallet with USDC
- Discover services:
GET https://registry.mcpay.tech/api/services - Read service docs:
GET https://registry.mcpay.tech/api/service/{slug}/skill.md - Check pricing:
GET https://registry.mcpay.tech/api/pricing - Make a paid request — via AgentWallet's or directly with x402 headers (see Payment Protocol below)
/x402/fetch
- 设置钱包 —— 创建AgentWallet,或为您自己的钱包充值USDC
- 发现服务:
GET https://registry.mcpay.tech/api/services - 查看服务文档:
GET https://registry.mcpay.tech/api/service/{slug}/skill.md - 查看定价:
GET https://registry.mcpay.tech/api/pricing - 发起付费请求 —— 通过AgentWallet的接口,或直接携带x402头发起请求(详见下方支付协议)
/x402/fetch
Services (4)
可用服务(共4项)
| Service | Slug | Description | Endpoints | Price Range |
|---|---|---|---|---|
| Twitter API | | Full Twitter API access - users, tweets, search, trends, and more via twitterapi.io | 17 | $0.005 - $0.02 |
| AI Generation API | | Run AI models for image, video, audio, and 3D generation | 1 | $0.01 |
| x402 Test Service | | Test x402 payment flows on Base Sepolia (EVM) and Solana Devnet. Use this service to verify your x402 client integration is working correctly. | 2 | $0.001 |
| Exa API | | Semantic web search via Exa | 4 | $0.002 - $0.01 |
| 服务 | 标识(Slug) | 描述 | 端点数量 | 价格范围 |
|---|---|---|---|---|
| Twitter API | | 完整的Twitter API访问权限——通过twitterapi.io获取用户、推文、搜索、趋势等信息 | 17 | $0.005 - $0.02 |
| AI生成API | | 运行AI模型生成图像、视频、音频和3D内容 | 1 | $0.01 |
| x402测试服务 | | 在Base Sepolia(EVM测试网)和Solana Devnet上测试x402支付流程。使用此服务验证您的x402客户端集成是否正常工作。 | 2 | $0.001 |
| Exa API | | 通过Exa实现语义网络搜索 | 4 | $0.002 - $0.01 |
Service Endpoints
服务端点
Each service lives at and exposes:
https://registry.mcpay.tech/api/service/{slug}| Endpoint | Description |
|---|---|
| Service info |
| Health check |
| Interactive API docs |
| OpenAPI 3.x spec |
| Agent-friendly documentation |
每个服务都部署在,并提供以下端点:
https://registry.mcpay.tech/api/service/{slug}| 端点 | 描述 |
|---|---|
| 服务信息 |
| 健康检查 |
| 交互式API文档 |
| OpenAPI 3.x规范 |
| 面向Agent的友好文档 |
Pricing Details
定价详情
Twitter API (twitter
)
twitterTwitter API (twitter
)
twitter| Endpoint | Price | Description |
|---|---|---|
| $0.005 | Get user info by username |
| $0.01 | Get user's recent tweets |
| $0.01 | Get user's followers |
| $0.01 | Get users that user follows |
| $0.01 | Search for users by keyword |
| $0.01 | Get tweets mentioning a user |
| $0.005 | Check if one user follows another |
| $0.02 | Batch get users by IDs |
| $0.01 | Get tweets by their IDs |
| $0.01 | Get replies to a tweet |
| $0.01 | Advanced tweet search with filters |
| $0.01 | Get quote tweets of a tweet |
| $0.01 | Get tweet thread context |
| $0.01 | Get tweets from a Twitter List |
| $0.01 | Get trending topics by location |
| $0.01 | Search tweets (legacy, use /api/search-tweets) |
| $0.01 | Search tweets (legacy, use /api/search-tweets) |
| 端点 | 价格 | 描述 |
|---|---|---|
| $0.005 | 通过用户名获取用户信息 |
| $0.01 | 获取用户的近期推文 |
| $0.01 | 获取用户的关注者列表 |
| $0.01 | 获取用户关注的用户列表 |
| $0.01 | 通过关键词搜索用户 |
| $0.01 | 获取提及该用户的推文 |
| $0.005 | 检查用户A是否关注用户B |
| $0.02 | 批量通过ID获取用户信息 |
| $0.01 | 通过ID获取推文 |
| $0.01 | 获取某条推文的回复 |
| $0.01 | 带筛选条件的高级推文搜索 |
| $0.01 | 获取某条推文的引用推文 |
| $0.01 | 获取推文的完整线程上下文 |
| $0.01 | 获取Twitter列表中的推文 |
| $0.01 | 获取指定地区的热门话题 |
| $0.01 | 搜索推文(旧版接口,建议使用/api/search-tweets) |
| $0.01 | 搜索推文(旧版接口,建议使用/api/search-tweets) |
AI Generation API (ai-gen
)
ai-genAI生成API (ai-gen
)
ai-gen| Endpoint | Price | Description |
|---|---|---|
| $0.01 | Run AI model prediction (price varies by model) |
x402 Test Service (test
)
testx402测试服务 (test
)
test| Endpoint | Price | Description |
|---|---|---|
| $0.001 | Test x402 payment flow (Base Sepolia & Solana Devnet) |
| $0.001 | Echo data with payment verification |
Exa API (exa
)
exaExa API (exa
)
exa| Endpoint | Price | Description |
|---|---|---|
| $0.01 | Semantic web search |
| $0.01 | Find similar pages |
| $0.002 | Extract URL contents |
| $0.01 | AI-powered answer |
AI Model Pricing (ai-gen
)
ai-genAI模型定价 (ai-gen
)
ai-genPrice is set dynamically based on the field in the request body.
modelImage Models:
| Model | Price |
|---|---|
| $0.004/image |
| $0.02 |
| $0.05/image |
| $0.04/image |
| $0.05/image |
| $0.18/image |
| $0.03/image |
| $0.04/image |
| $0.006/image |
| $0.006/image |
| $0.01 |
| $0.04/image |
| $0.09/image |
| $0.15/image |
| $0.003/image |
| $0.002 |
Video Models:
| Model | Price |
|---|---|
| $0.48/sec (audio), $0.24/sec (no audio) |
| $0.18/sec (audio), $0.12/sec (no audio) |
| $0.48/sec (audio), $0.24/sec (no audio) |
| $0.18/sec (audio), $0.12/sec (no audio) |
| $0.12/sec |
| $0.36/sec (720p), $0.60/sec (1080p) |
| $0.09/sec |
| $0.09/sec |
| $0.09/sec (std), $0.15/sec (pro) |
| $0.04/sec (480p), $0.08/sec (720p), $0.18/sec (1080p) |
| $0.03/sec (480p), $0.05/sec (720p), $0.09/sec (1080p) |
| $0.02/sec (480p), $0.03/sec (720p), $0.08/sec (1080p) |
| $0.04/sec (720p), $0.07/sec (720p+audio) |
| $0.60 |
| $0.12 |
| $0.07 |
| $0.09/sec (720p), $0.13/sec (1080p) |
| $0.06/sec |
| $0.22/sec |
| $0.10/sec (480p), $0.18/sec (768p) |
| $0.002/sec |
价格根据请求体中的字段动态设定。
model图像模型:
| 模型 | 价格 |
|---|---|
| $0.004/张 |
| $0.02/张 |
| $0.05/张 |
| $0.04/张 |
| $0.05/张 |
| $0.18/张 |
| $0.03/张 |
| $0.04/张 |
| $0.006/张 |
| $0.006/张 |
| $0.01/张 |
| $0.04/张 |
| $0.09/张 |
| $0.15/张 |
| $0.003/张 |
| $0.002/张 |
视频模型:
| 模型 | 价格 |
|---|---|
| $0.48/秒(带音频),$0.24/秒(无音频) |
| $0.18/秒(带音频),$0.12/秒(无音频) |
| $0.48/秒(带音频),$0.24/秒(无音频) |
| $0.18/秒(带音频),$0.12/秒(无音频) |
| $0.12/秒 |
| $0.36/秒(720p),$0.60/秒(1080p) |
| $0.09/秒 |
| $0.09/秒 |
| $0.09/秒(标准版),$0.15/秒(专业版) |
| $0.04/秒(480p),$0.08/秒(720p),$0.18/秒(1080p) |
| $0.03/秒(480p),$0.05/秒(720p),$0.09/秒(1080p) |
| $0.02/秒(480p),$0.03/秒(720p),$0.08/秒(1080p) |
| $0.04/秒(720p),$0.07/秒(720p+音频) |
| $0.60/条 |
| $0.12/条 |
| $0.07/条 |
| $0.09/秒(720p),$0.13/秒(1080p) |
| $0.06/秒 |
| $0.22/秒 |
| $0.10/秒(480p),$0.18/秒(768p) |
| $0.002/秒 |
Payment Protocol (x402)
支付协议(x402)
All paid endpoints use the x402 payment protocol. No API keys needed.
Flow:
- Call any paid endpoint without a payment header
- Receive with a
402 Payment Requiredheader (Base64 JSON with price, network, payTo address)PAYMENT-REQUIRED - Sign a payment for the requested amount on your chosen network
- Retry the same request with the header
PAYMENT-SIGNATURE - Receive the response plus a confirmation header
PAYMENT-RESPONSE
Failed requests are automatically refunded.
Supported Networks:
| Network | ID | Type | Environment |
|---|---|---|---|
| Base | | EVM | Mainnet |
| Base Sepolia | | EVM | Testnet |
| Solana | | Solana | Mainnet |
| Solana Devnet | | Solana | Devnet |
Accepted Tokens: USDC, USDT, CASH (availability varies by network)
所有付费端点均使用x402支付协议,无需API密钥。
流程:
- 在不携带支付头的情况下调用任意付费端点
- 收到响应,其中包含
402 Payment Required头(Base64编码的JSON,包含价格、网络、收款地址)PAYMENT-REQUIRED - 在您选择的网络上签署对应金额的支付授权
- 携带头重试同一请求
PAYMENT-SIGNATURE - 收到响应以及确认头
PAYMENT-RESPONSE
失败的请求将自动退款。
支持的网络:
| 网络 | ID | 类型 | 环境 |
|---|---|---|---|
| Base | | EVM | 主网 |
| Base Sepolia | | EVM | 测试网 |
| Solana | | Solana | 主网 |
| Solana Devnet | | Solana | 测试网 |
接受的代币: USDC、USDT、CASH(可用性因网络而异)
Platform Endpoints (FREE)
平台端点(免费)
| Endpoint | Description |
|---|---|
| Platform info and version |
| List all services with metadata |
| Single service details |
| All pricing policies |
| Supported payment networks |
| Health check |
| Skill/agent package catalog |
| Download package bundle |
| x402 discovery document |
| Interactive docs (HTML) |
| 端点 | 描述 |
|---|---|
| 平台信息和版本 |
| 列出所有服务及其元数据 |
| 单个服务详情 |
| 所有定价政策 |
| 支持的支付网络 |
| 健康检查 |
| Skill/Agent包目录 |
| 下载包捆绑文件 |
| x402发现文档 |
| 交互式文档(HTML) |
Agent Integration
Agent集成
With AgentWallet (recommended)
使用AgentWallet(推荐)
AgentWallet is a server-side wallet for AI agents. It manages keys, balances, and x402 payment signing so agents don't need to handle crypto directly.
- Authenticate with AgentWallet (email OTP → API token)
- Fund your wallet with USDC on Base or Solana
- Call any Frames Registry endpoint through AgentWallet's proxy:
POST https://agentwallet.mcpay.tech/x402/fetch
{
"url": "https://registry.mcpay.tech/api/service/twitter/api/search-tweets",
"method": "POST",
"body": { "query": "AI agents" }
}AgentWallet detects the 402 response, signs payment, and retries automatically.
AgentWallet是面向AI Agent的服务器端钱包。它管理密钥、余额和x402支付签名,让Agent无需直接处理加密货币。
- 通过AgentWallet认证(邮箱OTP → API令牌)
- 在Base或Solana网络为您的钱包充值USDC
- 通过AgentWallet的代理调用任意Frames Registry端点:
POST https://agentwallet.mcpay.tech/x402/fetch
{
"url": "https://registry.mcpay.tech/api/service/twitter/api/search-tweets",
"method": "POST",
"body": { "query": "AI agents" }
}AgentWallet会自动检测402响应、签署支付并重试请求。
Direct x402 (self-managed wallet)
直接使用x402(自管钱包)
Requires an EVM or Solana wallet with USDC and the ability to sign EIP-3009 or SPL transfers.
- Make the request to the paid endpoint
- Parse the header from the 402 response (Base64 JSON with price, network, payTo)
PAYMENT-REQUIRED - Sign a payment authorization for the exact amount
- Retry with the header
PAYMENT-SIGNATURE
需要一个充值了USDC的EVM或Solana钱包,并且具备签署EIP-3009或SPL转账的能力。
- 向付费端点发起请求
- 从402响应中解析头(Base64编码的JSON,包含价格、网络、收款地址)
PAYMENT-REQUIRED - 签署对应金额的支付授权
- 携带头重试请求
PAYMENT-SIGNATURE