t2000: Pay for x402 API Service

Status

Active — bundled with @t2000/cli (no separate install).

USDC payment is gasless. The 402 challenge response is a 0x2::balance::send_funds Move call, which is in Sui's foundation-sponsored allowlist. The wallet can pay even with 0 SUI in the gas reserve.

Purpose

Make a paid HTTP request to any x402-protected endpoint. Handles the 402 challenge, pays via Sui USDC, and returns the API response.

Service Discovery

Before calling t2 pay, discover available services:

# CLI — search by name / category / endpoint
t2 services search "image"           # find image-gen services
t2 services search "chat"            # find chat/completion endpoints
t2 services search ""                # list everything

# CLI — inspect a service or endpoint
t2 services inspect https://mpp.t2000.ai/openai
t2 services inspect https://mpp.t2000.ai/openai/v1/chat/completions

# MCP — full catalog JSON
t2000_services

All services are hosted at https://mpp.t2000.ai/. See the t2000-services skill for the full discovery workflow.

Command

t2 pay <url> [options]

Options

Available Services

The live catalog is the only source of truth for what's available and what it costs. Discover services and current per-endpoint prices with t2000_services (MCP) or GET https://mpp.t2000.ai/api/services. Inspect one with t2 services inspect <url>. Prices are NOT listed here on purpose — they would drift from the catalog. Resolve the real price at call time (the --max-price ceiling guards against overpaying), or run t2 pay <url> --dry-run to see what would be charged before paying.

The catalog spans every major AI + data API, grouped roughly as:

• AI models & reasoning — OpenAI, Anthropic (Claude), Google Gemini, DeepSeek, Groq, Together AI, Perplexity, Mistral, Cohere (chat, embeddings, rerank).
• Media & generation — OpenAI (images, text-to-speech), fal.ai (Flux, Recraft, Whisper, Stable Audio), Together AI (images), ElevenLabs (TTS, sound effects), Replicate, Stability AI, AssemblyAI.
• Search — Brave, Exa, Serper, SerpAPI, NewsAPI.
• Web & documents — Firecrawl (scrape / crawl / map / extract), Jina Reader, ScreenshotOne, PDFShift, QR Code.
• Data & finance — OpenWeather, Google Maps (geocode / places / directions), CoinGecko, Alpha Vantage, ExchangeRate.
• Translation — DeepL, Google Translate.
• Intelligence & security — Hunter.io, IPinfo, VirusTotal.
• Tools & utility — Judge0 (code exec), Resend (email), Pushover (push), Short.io (URL shortener), TinyPNG (image compression & resize).
• Commerce — Lob (postcards, letters, address verification).

This list is a capability map, not the exhaustive endpoint set — always discover via the catalog before calling.

Example Commands

Ask an AI model

t2 pay https://mpp.t2000.ai/openai/v1/chat/completions \
  --data '{"model":"gpt-4o","messages":[{"role":"user","content":"Explain quantum computing in 3 sentences"}]}'

Search the web

t2 pay https://mpp.t2000.ai/brave/v1/web/search \
  --data '{"q":"latest Sui blockchain news"}'

Generate an image

t2 pay https://mpp.t2000.ai/fal/fal-ai/flux/dev \
  --data '{"prompt":"a futuristic city at sunset, cyberpunk style"}'

Check weather

t2 pay https://mpp.t2000.ai/openweather/v1/weather \
  --data '{"q":"Tokyo"}'

Send an email

t2 pay https://mpp.t2000.ai/resend/v1/emails \
  --data '{"from":"[email protected]","to":"[email protected]","subject":"Hello","text":"Sent by an AI agent"}'

Execute code

t2 pay https://mpp.t2000.ai/judge0/v1/submissions \
  --data '{"source_code":"print(42)","language_id":71}'

Send physical mail

# Send a postcard
t2 pay https://mpp.t2000.ai/lob/v1/postcards \
  --max-price 2 \
  --data '{
    "to":{"name":"Jane Doe","address_line1":"123 Main St","address_city":"San Francisco","address_state":"CA","address_zip":"94105"},
    "from":{"name":"AI Agent","address_line1":"456 Oak Ave","address_city":"Palo Alto","address_state":"CA","address_zip":"94301"},
    "front":"https://example.com/front.png",
    "back":"https://example.com/back.png",
    "use_type":"operational"
  }'

# Send a letter
t2 pay https://mpp.t2000.ai/lob/v1/letters \
  --max-price 2 \
  --data '{
    "to":{"name":"Jane Doe","address_line1":"123 Main St","address_city":"San Francisco","address_state":"CA","address_zip":"94105"},
    "from":{"name":"AI Agent","address_line1":"456 Oak Ave","address_city":"Palo Alto","address_state":"CA","address_zip":"94301"},
    "file":"https://example.com/letter.pdf",
    "use_type":"operational",
    "color":false
  }'

# Verify a US address
t2 pay https://mpp.t2000.ai/lob/v1/verify \
  --data '{"primary_line":"123 Main St","city":"San Francisco","state":"CA","zip_code":"94105"}'

Get directions

t2 pay https://mpp.t2000.ai/googlemaps/v1/directions \
  --data '{"origin":"San Francisco, CA","destination":"Palo Alto, CA"}'

Get crypto prices

t2 pay https://mpp.t2000.ai/coingecko/v1/price \
  --data '{"ids":"sui,bitcoin,ethereum","vs_currencies":"usd"}'

Get a stock quote

t2 pay https://mpp.t2000.ai/alphavantage/v1/quote \
  --data '{"symbol":"AAPL"}'

Get breaking news

t2 pay https://mpp.t2000.ai/newsapi/v1/headlines \
  --data '{"country":"us","category":"technology"}'

Translate text

t2 pay https://mpp.t2000.ai/deepl/v1/translate \
  --data '{"text":["Hello, how are you?"],"target_lang":"ES"}'

Semantic search

t2 pay https://mpp.t2000.ai/exa/v1/search \
  --data '{"query":"best practices for AI agent payments","numResults":5}'

Read a URL as markdown

t2 pay https://mpp.t2000.ai/jina/v1/read \
  --data '{"url":"https://docs.sui.io/concepts/tokenomics"}'

Google search (structured)

t2 pay https://mpp.t2000.ai/serper/v1/search \
  --data '{"q":"Sui blockchain TVL 2026"}'

Screenshot a webpage

t2 pay https://mpp.t2000.ai/screenshot/v1/capture \
  --data '{"url":"https://example.com","format":"png","viewport_width":"1280"}'

Generate a QR code

t2 pay https://mpp.t2000.ai/qrcode/v1/generate \
  --data '{"data":"https://t2000.ai","size":"400x400"}'

Convert HTML to PDF

t2 pay https://mpp.t2000.ai/pdfshift/v1/convert \
  --data '{"source":"https://t2000.ai/docs"}'

Run a Replicate model

t2 pay https://mpp.t2000.ai/replicate/v1/predictions \
  --data '{"model":"meta/llama-3-70b-instruct","input":{"prompt":"Explain DeFi in 3 sentences"}}'

Find emails for a domain

t2 pay https://mpp.t2000.ai/hunter/v1/search \
  --data '{"domain":"mystenlabs.com"}'

Look up an IP address

t2 pay https://mpp.t2000.ai/ipinfo/v1/lookup \
  --data '{"ip":"8.8.8.8"}'

Search for flights

t2 pay https://mpp.t2000.ai/serpapi/v1/flights \
  --data '{"departure_id":"LAX","arrival_id":"NRT","outbound_date":"2026-05-01","type":"2"}'

Convert currency

t2 pay https://mpp.t2000.ai/exchangerate/v1/convert \
  --data '{"from":"USD","to":"EUR","amount":100}'

Scan a URL for malware

t2 pay https://mpp.t2000.ai/virustotal/v1/scan \
  --data '{"url":"https://suspicious-site.com"}'

Shorten a URL

t2 pay https://mpp.t2000.ai/shortio/v1/shorten \
  --data '{"url":"https://example.com/very/long/url/path"}'

Send a push notification

t2 pay https://mpp.t2000.ai/pushover/v1/push \
  --data '{"user":"USER_KEY","message":"Your agent has a message!"}'

Flow (automatic)

1. Makes initial HTTP request to the URL
2. If 402: reads x402 challenge for amount and terms
3. If price <= --max-price: pays via Sui USDC
4. Retries with credential header
5. Returns the API response body

Safety

• If requested price exceeds --max-price, payment is refused (no funds spent)
• Default max-price: $1.00 USDC per request
• For commerce (mail, merch), set --max-price higher
• Payment only broadcast after 402 terms are validated

Errors

• PRICE_EXCEEDS_LIMIT: API asking more than --max-price
• INSUFFICIENT_BALANCE: not enough available USDC
• UNSUPPORTED_NETWORK: x402 requires a network other than Sui
• PAYMENT_EXPIRED: payment challenge has expired
• DUPLICATE_PAYMENT: nonce already used on-chain

MCP

Via MCP: use t2000_services to discover services, then t2000_pay to call them.