registry

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Frames 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.tech
https://registry.mcpay.tech

Prerequisites

前置条件

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
    POST /x402/fetch
    call. No private key management needed on your side.
  • Self-managed wallet — any EVM wallet (Base) or Solana wallet with USDC. You sign x402 payment headers directly.
使用付费端点需要一个充值了USDC的加密货币钱包,有两种选择:
  • AgentWallet(推荐Agent使用) —— 服务器端钱包,通过单次
    POST /x402/fetch
    调用自动处理402检测、支付签名和重试。无需您这边管理私钥。
  • 自管钱包 —— 任何支持USDC的EVM钱包(Base链)或Solana钱包。您需要直接签署x402支付头。

Quick Start

快速开始

  1. Set up a wallet — create an AgentWallet or fund your own wallet with USDC
  2. Discover services:
    GET https://registry.mcpay.tech/api/services
  3. Read service docs:
    GET https://registry.mcpay.tech/api/service/{slug}/skill.md
  4. Check pricing:
    GET https://registry.mcpay.tech/api/pricing
  5. Make a paid request — via AgentWallet's
    /x402/fetch
    or directly with x402 headers (see Payment Protocol below)
  1. 设置钱包 —— 创建AgentWallet,或为您自己的钱包充值USDC
  2. 发现服务
    GET https://registry.mcpay.tech/api/services
  3. 查看服务文档
    GET https://registry.mcpay.tech/api/service/{slug}/skill.md
  4. 查看定价
    GET https://registry.mcpay.tech/api/pricing
  5. 发起付费请求 —— 通过AgentWallet的
    /x402/fetch
    接口,或直接携带x402头发起请求(详见下方支付协议)

Services (4)

可用服务(共4项)

ServiceSlugDescriptionEndpointsPrice Range
Twitter API
twitter
Full Twitter API access - users, tweets, search, trends, and more via twitterapi.io17$0.005 - $0.02
AI Generation API
ai-gen
Run AI models for image, video, audio, and 3D generation1$0.01
x402 Test Service
test
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
exa
Semantic web search via Exa4$0.002 - $0.01
服务标识(Slug)描述端点数量价格范围
Twitter API
twitter
完整的Twitter API访问权限——通过twitterapi.io获取用户、推文、搜索、趋势等信息17$0.005 - $0.02
AI生成API
ai-gen
运行AI模型生成图像、视频、音频和3D内容1$0.01
x402测试服务
test
在Base Sepolia(EVM测试网)和Solana Devnet上测试x402支付流程。使用此服务验证您的x402客户端集成是否正常工作。2$0.001
Exa API
exa
通过Exa实现语义网络搜索4$0.002 - $0.01

Service Endpoints

服务端点

Each service lives at
https://registry.mcpay.tech/api/service/{slug}
and exposes:
EndpointDescription
GET /
Service info
GET /health
Health check
GET /docs
Interactive API docs
GET /openapi.json
OpenAPI 3.x spec
GET /skill.md
Agent-friendly documentation
每个服务都部署在
https://registry.mcpay.tech/api/service/{slug}
,并提供以下端点:
端点描述
GET /
服务信息
GET /health
健康检查
GET /docs
交互式API文档
GET /openapi.json
OpenAPI 3.x规范
GET /skill.md
面向Agent的友好文档

Pricing Details

定价详情

Twitter API (
twitter
)

Twitter API (
twitter
)

Base:
https://registry.mcpay.tech/api/service/twitter
| Docs | OpenAPI | Skill
EndpointPriceDescription
POST /api/user-info
$0.005Get user info by username
POST /api/user-tweets
$0.01Get user's recent tweets
POST /api/user-followers
$0.01Get user's followers
POST /api/user-following
$0.01Get users that user follows
POST /api/search-users
$0.01Search for users by keyword
POST /api/user-mentions
$0.01Get tweets mentioning a user
POST /api/check-follow
$0.005Check if one user follows another
POST /api/batch-users
$0.02Batch get users by IDs
POST /api/tweets-by-ids
$0.01Get tweets by their IDs
POST /api/tweet-replies
$0.01Get replies to a tweet
POST /api/search-tweets
$0.01Advanced tweet search with filters
POST /api/tweet-quotes
$0.01Get quote tweets of a tweet
POST /api/tweet-thread
$0.01Get tweet thread context
POST /api/list-tweets
$0.01Get tweets from a Twitter List
POST /api/trends
$0.01Get trending topics by location
POST /api/invoke
$0.01Search tweets (legacy, use /api/search-tweets)
POST /api/search
$0.01Search tweets (legacy, use /api/search-tweets)
基础地址:
https://registry.mcpay.tech/api/service/twitter
| 文档 | OpenAPI | Skill文档
端点价格描述
POST /api/user-info
$0.005通过用户名获取用户信息
POST /api/user-tweets
$0.01获取用户的近期推文
POST /api/user-followers
$0.01获取用户的关注者列表
POST /api/user-following
$0.01获取用户关注的用户列表
POST /api/search-users
$0.01通过关键词搜索用户
POST /api/user-mentions
$0.01获取提及该用户的推文
POST /api/check-follow
$0.005检查用户A是否关注用户B
POST /api/batch-users
$0.02批量通过ID获取用户信息
POST /api/tweets-by-ids
$0.01通过ID获取推文
POST /api/tweet-replies
$0.01获取某条推文的回复
POST /api/search-tweets
$0.01带筛选条件的高级推文搜索
POST /api/tweet-quotes
$0.01获取某条推文的引用推文
POST /api/tweet-thread
$0.01获取推文的完整线程上下文
POST /api/list-tweets
$0.01获取Twitter列表中的推文
POST /api/trends
$0.01获取指定地区的热门话题
POST /api/invoke
$0.01搜索推文(旧版接口,建议使用/api/search-tweets)
POST /api/search
$0.01搜索推文(旧版接口,建议使用/api/search-tweets)

AI Generation API (
ai-gen
)

AI生成API (
ai-gen
)

Base:
https://registry.mcpay.tech/api/service/ai-gen
| Docs | OpenAPI | Skill
EndpointPriceDescription
POST /api/invoke
$0.01Run AI model prediction (price varies by model)
基础地址:
https://registry.mcpay.tech/api/service/ai-gen
| 文档 | OpenAPI | Skill文档
端点价格描述
POST /api/invoke
$0.01运行AI模型预测(价格随模型不同而变化)

x402 Test Service (
test
)

x402测试服务 (
test
)

Base:
https://registry.mcpay.tech/api/service/test
| Docs | OpenAPI | Skill
EndpointPriceDescription
POST /api/invoke
$0.001Test x402 payment flow (Base Sepolia & Solana Devnet)
POST /api/echo
$0.001Echo data with payment verification
基础地址:
https://registry.mcpay.tech/api/service/test
| 文档 | OpenAPI | Skill文档
端点价格描述
POST /api/invoke
$0.001测试x402支付流程(Base Sepolia和Solana Devnet)
POST /api/echo
$0.001回传数据并验证支付

Exa API (
exa
)

Exa API (
exa
)

Base:
https://registry.mcpay.tech/api/service/exa
| Docs | OpenAPI | Skill
EndpointPriceDescription
POST /api/search
$0.01Semantic web search
POST /api/find-similar
$0.01Find similar pages
POST /api/contents
$0.002Extract URL contents
POST /api/answer
$0.01AI-powered answer
基础地址:
https://registry.mcpay.tech/api/service/exa
| 文档 | OpenAPI | Skill文档
端点价格描述
POST /api/search
$0.01语义网络搜索
POST /api/find-similar
$0.01查找相似页面
POST /api/contents
$0.002提取URL内容
POST /api/answer
$0.01AI驱动的问答

AI Model Pricing (
ai-gen
)

AI模型定价 (
ai-gen
)

Price is set dynamically based on the
model
field in the request body.
Image Models:
ModelPrice
flux/schnell
$0.004/image
flux/2-pro
$0.02
flux/kontext-pro
$0.05/image
bytedance/seedream-4
$0.04/image
google/nano-banana
$0.05/image
google/nano-banana-pro
$0.18/image
google/imagen-4-fast
$0.03/image
ideogram/v3-turbo
$0.04/image
prunaai/z-image-turbo
$0.006/image
prunaai/p-image
$0.006/image
fofr/sdxl-emoji
$0.01
qwen/qwen-image-edit-2511
$0.04/image
xai/grok-2-image
$0.09/image
openai/dall-e-3
$0.15/image
nightmareai/real-esrgan
$0.003/image
851-labs/background-remover
$0.002
Video Models:
ModelPrice
google/veo-3
$0.48/sec (audio), $0.24/sec (no audio)
google/veo-3-fast
$0.18/sec (audio), $0.12/sec (no audio)
google/veo-3.1
$0.48/sec (audio), $0.24/sec (no audio)
google/veo-3.1-fast
$0.18/sec (audio), $0.12/sec (no audio)
openai/sora-2
$0.12/sec
openai/sora-2-pro
$0.36/sec (720p), $0.60/sec (1080p)
kwaivgi/kling-v2.5-turbo-pro
$0.09/sec
kwaivgi/kling-v2.6
$0.09/sec
kwaivgi/kling-v2.6-motion-control
$0.09/sec (std), $0.15/sec (pro)
bytedance/seedance-1-pro
$0.04/sec (480p), $0.08/sec (720p), $0.18/sec (1080p)
bytedance/seedance-1-lite
$0.03/sec (480p), $0.05/sec (720p), $0.09/sec (1080p)
bytedance/seedance-1-pro-fast
$0.02/sec (480p), $0.03/sec (720p), $0.08/sec (1080p)
bytedance/seedance-1.5-pro
$0.04/sec (720p), $0.07/sec (720p+audio)
minimax/video-01
$0.60
wan-video/wan-2.2-t2v-fast
$0.12
wan-video/wan-2.2-i2v-fast
$0.07
wan-video/wan-2.5-i2v-fast
$0.09/sec (720p), $0.13/sec (1080p)
runwayml/gen4-turbo
$0.06/sec
runwayml/gen4-aleph
$0.22/sec
veed/fabric-1.0
$0.10/sec (480p), $0.18/sec (768p)
shreejalmaharjan-27/tiktok-short-captions
$0.002/sec
价格根据请求体中的
model
字段动态设定。
图像模型:
模型价格
flux/schnell
$0.004/张
flux/2-pro
$0.02/张
flux/kontext-pro
$0.05/张
bytedance/seedream-4
$0.04/张
google/nano-banana
$0.05/张
google/nano-banana-pro
$0.18/张
google/imagen-4-fast
$0.03/张
ideogram/v3-turbo
$0.04/张
prunaai/z-image-turbo
$0.006/张
prunaai/p-image
$0.006/张
fofr/sdxl-emoji
$0.01/张
qwen/qwen-image-edit-2511
$0.04/张
xai/grok-2-image
$0.09/张
openai/dall-e-3
$0.15/张
nightmareai/real-esrgan
$0.003/张
851-labs/background-remover
$0.002/张
视频模型:
模型价格
google/veo-3
$0.48/秒(带音频),$0.24/秒(无音频)
google/veo-3-fast
$0.18/秒(带音频),$0.12/秒(无音频)
google/veo-3.1
$0.48/秒(带音频),$0.24/秒(无音频)
google/veo-3.1-fast
$0.18/秒(带音频),$0.12/秒(无音频)
openai/sora-2
$0.12/秒
openai/sora-2-pro
$0.36/秒(720p),$0.60/秒(1080p)
kwaivgi/kling-v2.5-turbo-pro
$0.09/秒
kwaivgi/kling-v2.6
$0.09/秒
kwaivgi/kling-v2.6-motion-control
$0.09/秒(标准版),$0.15/秒(专业版)
bytedance/seedance-1-pro
$0.04/秒(480p),$0.08/秒(720p),$0.18/秒(1080p)
bytedance/seedance-1-lite
$0.03/秒(480p),$0.05/秒(720p),$0.09/秒(1080p)
bytedance/seedance-1-pro-fast
$0.02/秒(480p),$0.03/秒(720p),$0.08/秒(1080p)
bytedance/seedance-1.5-pro
$0.04/秒(720p),$0.07/秒(720p+音频)
minimax/video-01
$0.60/条
wan-video/wan-2.2-t2v-fast
$0.12/条
wan-video/wan-2.2-i2v-fast
$0.07/条
wan-video/wan-2.5-i2v-fast
$0.09/秒(720p),$0.13/秒(1080p)
runwayml/gen4-turbo
$0.06/秒
runwayml/gen4-aleph
$0.22/秒
veed/fabric-1.0
$0.10/秒(480p),$0.18/秒(768p)
shreejalmaharjan-27/tiktok-short-captions
$0.002/秒

Payment Protocol (x402)

支付协议(x402)

All paid endpoints use the x402 payment protocol. No API keys needed.
Flow:
  1. Call any paid endpoint without a payment header
  2. Receive
    402 Payment Required
    with a
    PAYMENT-REQUIRED
    header (Base64 JSON with price, network, payTo address)
  3. Sign a payment for the requested amount on your chosen network
  4. Retry the same request with the
    PAYMENT-SIGNATURE
    header
  5. Receive the response plus a
    PAYMENT-RESPONSE
    confirmation header
Failed requests are automatically refunded.
Supported Networks:
NetworkIDTypeEnvironment
Base
eip155:8453
EVMMainnet
Base Sepolia
eip155:84532
EVMTestnet
Solana
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
SolanaMainnet
Solana Devnet
solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1
SolanaDevnet
Accepted Tokens: USDC, USDT, CASH (availability varies by network)
所有付费端点均使用x402支付协议,无需API密钥。
流程:
  1. 在不携带支付头的情况下调用任意付费端点
  2. 收到
    402 Payment Required
    响应,其中包含
    PAYMENT-REQUIRED
    头(Base64编码的JSON,包含价格、网络、收款地址)
  3. 在您选择的网络上签署对应金额的支付授权
  4. 携带
    PAYMENT-SIGNATURE
    头重试同一请求
  5. 收到响应以及
    PAYMENT-RESPONSE
    确认头
失败的请求将自动退款。
支持的网络:
网络ID类型环境
Base
eip155:8453
EVM主网
Base Sepolia
eip155:84532
EVM测试网
Solana
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Solana主网
Solana Devnet
solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1
Solana测试网
接受的代币: USDC、USDT、CASH(可用性因网络而异)

Platform Endpoints (FREE)

平台端点(免费)

EndpointDescription
GET https://registry.mcpay.tech/api
Platform info and version
GET https://registry.mcpay.tech/api/services
List all services with metadata
GET https://registry.mcpay.tech/api/services/:slug
Single service details
GET https://registry.mcpay.tech/api/pricing
All pricing policies
GET https://registry.mcpay.tech/api/networks
Supported payment networks
GET https://registry.mcpay.tech/api/health
Health check
GET https://registry.mcpay.tech/api/packages
Skill/agent package catalog
GET https://registry.mcpay.tech/api/packages/:slug/bundle
Download package bundle
GET https://registry.mcpay.tech/.well-known/x402
x402 discovery document
GET https://registry.mcpay.tech/docs
Interactive docs (HTML)
端点描述
GET https://registry.mcpay.tech/api
平台信息和版本
GET https://registry.mcpay.tech/api/services
列出所有服务及其元数据
GET https://registry.mcpay.tech/api/services/:slug
单个服务详情
GET https://registry.mcpay.tech/api/pricing
所有定价政策
GET https://registry.mcpay.tech/api/networks
支持的支付网络
GET https://registry.mcpay.tech/api/health
健康检查
GET https://registry.mcpay.tech/api/packages
Skill/Agent包目录
GET https://registry.mcpay.tech/api/packages/:slug/bundle
下载包捆绑文件
GET https://registry.mcpay.tech/.well-known/x402
x402发现文档
GET https://registry.mcpay.tech/docs
交互式文档(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.
  1. Authenticate with AgentWallet (email OTP → API token)
  2. Fund your wallet with USDC on Base or Solana
  3. 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无需直接处理加密货币。
  1. 通过AgentWallet认证(邮箱OTP → API令牌)
  2. 在Base或Solana网络为您的钱包充值USDC
  3. 通过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.
  1. Make the request to the paid endpoint
  2. Parse the
    PAYMENT-REQUIRED
    header from the 402 response (Base64 JSON with price, network, payTo)
  3. Sign a payment authorization for the exact amount
  4. Retry with the
    PAYMENT-SIGNATURE
    header
需要一个充值了USDC的EVM或Solana钱包,并且具备签署EIP-3009或SPL转账的能力。
  1. 向付费端点发起请求
  2. 从402响应中解析
    PAYMENT-REQUIRED
    头(Base64编码的JSON,包含价格、网络、收款地址)
  3. 签署对应金额的支付授权
  4. 携带
    PAYMENT-SIGNATURE
    头重试请求