Frames Registry

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.

Base URL

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.

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
```
/x402/fetch
```
or directly with x402 headers (see Payment Protocol below)

Services (4)

Service	Slug	Description	Endpoints	Price Range
Twitter API	`twitter`	Full Twitter API access - users, tweets, search, trends, and more via twitterapi.io	17	$0.005 - $0.02
AI Generation API	`ai-gen`	Run AI models for image, video, audio, and 3D generation	1	$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 Exa	4	$0.002 - $0.01

Service Endpoints

Each service lives at

https://registry.mcpay.tech/api/service/{slug}

and exposes:

Endpoint	Description
`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

Pricing Details

Twitter API (

twitter

)

Base:

https://registry.mcpay.tech/api/service/twitter

| Docs | OpenAPI | Skill

Endpoint	Price	Description
`POST /api/user-info`	$0.005	Get user info by username
`POST /api/user-tweets`	$0.01	Get user's recent tweets
`POST /api/user-followers`	$0.01	Get user's followers
`POST /api/user-following`	$0.01	Get users that user follows
`POST /api/search-users`	$0.01	Search for users by keyword
`POST /api/user-mentions`	$0.01	Get tweets mentioning a user
`POST /api/check-follow`	$0.005	Check if one user follows another
`POST /api/batch-users`	$0.02	Batch get users by IDs
`POST /api/tweets-by-ids`	$0.01	Get tweets by their IDs
`POST /api/tweet-replies`	$0.01	Get replies to a tweet
`POST /api/search-tweets`	$0.01	Advanced tweet search with filters
`POST /api/tweet-quotes`	$0.01	Get quote tweets of a tweet
`POST /api/tweet-thread`	$0.01	Get tweet thread context
`POST /api/list-tweets`	$0.01	Get tweets from a Twitter List
`POST /api/trends`	$0.01	Get trending topics by location
`POST /api/invoke`	$0.01	Search tweets (legacy, use /api/search-tweets)
`POST /api/search`	$0.01	Search tweets (legacy, use /api/search-tweets)

AI Generation API (

ai-gen

)

Base:

https://registry.mcpay.tech/api/service/ai-gen

| Docs | OpenAPI | Skill

Endpoint	Price	Description
`POST /api/invoke`	$0.01	Run AI model prediction (price varies by model)

x402 Test Service (

test

)

Base:

https://registry.mcpay.tech/api/service/test

| Docs | OpenAPI | Skill

Endpoint	Price	Description
`POST /api/invoke`	$0.001	Test x402 payment flow (Base Sepolia & Solana Devnet)
`POST /api/echo`	$0.001	Echo data with payment verification

Exa API (

exa

)

Base:

https://registry.mcpay.tech/api/service/exa

| Docs | OpenAPI | Skill

Endpoint	Price	Description
`POST /api/search`	$0.01	Semantic web search
`POST /api/find-similar`	$0.01	Find similar pages
`POST /api/contents`	$0.002	Extract URL contents
`POST /api/answer`	$0.01	AI-powered answer

AI Model Pricing (

ai-gen

)

Price is set dynamically based on the

model

field in the request body.

Image Models:

Model	Price
`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:

Model	Price
`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

Payment Protocol (x402)

All paid endpoints use the x402 payment protocol. No API keys needed.

Flow:

Call any paid endpoint without a payment header
Receive
```
402 Payment Required
```
with a
```
PAYMENT-REQUIRED
```
header (Base64 JSON with price, network, payTo address)
Sign a payment for the requested amount on your chosen network
Retry the same request with the
```
PAYMENT-SIGNATURE
```
header
Receive the response plus a
```
PAYMENT-RESPONSE
```
confirmation header

Failed requests are automatically refunded.

Supported Networks:

Network	ID	Type	Environment
Base	`eip155:8453`	EVM	Mainnet
Base Sepolia	`eip155:84532`	EVM	Testnet
Solana	`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`	Solana	Mainnet
Solana Devnet	`solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1`	Solana	Devnet

Accepted Tokens: USDC, USDT, CASH (availability varies by network)

Platform Endpoints (FREE)

Endpoint	Description
`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)

Agent Integration

With AgentWallet (recommended)

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.

Direct x402 (self-managed wallet)

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
```
PAYMENT-REQUIRED
```
header from the 402 response (Base64 JSON with price, network, payTo)
Sign a payment authorization for the exact amount
Retry with the
```
PAYMENT-SIGNATURE
```
header

registry

NPX Install

Tags

SKILL.md Content

Frames Registry

Base URL

Prerequisites

Quick Start

Services (4)

Service Endpoints

Pricing Details

Twitter API (
`twitter`
)

AI Generation API (
`ai-gen`
)

x402 Test Service (
`test`
)

Exa API (
`exa`
)

AI Model Pricing (
`ai-gen`
)

Payment Protocol (x402)

Platform Endpoints (FREE)

Agent Integration

With AgentWallet (recommended)

Direct x402 (self-managed wallet)

registry

NPX Install

Tags

SKILL.md Content

Frames Registry

Base URL

Prerequisites

Quick Start

Services (4)

Service Endpoints

Pricing Details

Twitter API (twitter)

AI Generation API (ai-gen)

x402 Test Service (test)

Exa API (exa)

AI Model Pricing (ai-gen)

Payment Protocol (x402)

Platform Endpoints (FREE)

Agent Integration

With AgentWallet (recommended)

Direct x402 (self-managed wallet)

Twitter API (
`twitter`
)

AI Generation API (
`ai-gen`
)

x402 Test Service (
`test`
)

Exa API (
`exa`
)

AI Model Pricing (
`ai-gen`
)