Satring MCP Server

 ___  __ _| |_ _ __(_)_ __   __ _
/ __|/ _` | __| '__| | '_ \ / _` |
\__ \ (_| | |_| |  | | | | | (_| |
|___/\__,_|\__|_|  |_|_| |_|\__, |
                             |___/  ⚡ L402 + x402

satring.com — the best curated L402 + x402 API directory. Find, rate, and connect to paid APIs via Lightning (L402) or USDC on Base (x402).

Satring helps AI agents and developers discover paid API services that accept payments via the L402 protocol (Bitcoin Lightning) or the x402 protocol (USDC on Base). Browse the curated directory, submit your service, and let agents find you.

▶ Watch the 3-minute demo

Why

AI agents can now pay for APIs autonomously using Lightning. But there's no good way to discover what's available. Satring is the best curated directory for L402 and x402 paid APIs.

Features

• Browse, search, and filter paid APIs by category, status, and protocol
• Dual-protocol payments: L402 (Bitcoin Lightning) and x402 (USDC on Base) supported side by side
• Submit services with payment gate (anti-spam), payable via either protocol
• Ratings and reputation system (also payment-gated)
• Edit your listing with secure edit tokens
• Recover lost edit tokens via domain verification (.well-known/satring-verify)
• Shared edit tokens across same-domain services; one token manages all your listings
• JSON API for programmatic access and agent queries
• Premium endpoints (bulk export, analytics, reputation) gated via L402 or x402
• Per-service health analytics: uptime percentage, average latency, probe history
• Health probing with automatic protocol detection (L402, x402, or both)
• Service status tracking (live / confirmed / dead)

Quick Start

git clone https://github.com/toadlyBroodle/satring.git
cd satring
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # configure wallet keys, or leave defaults for test mode
uvicorn app.main:app --reload

Open http://localhost:8000

In test mode (AUTH_ROOT_KEY=test-mode), all payment gates are bypassed.

API

Full interactive docs at satring.com/docs.

Free endpoints

# List services (paginated, filterable by category, status, and protocol)
curl "https://satring.com/api/v1/services?category=search&status=live&protocol=L402&page=1&page_size=20"

# Search (also filterable by status and protocol)
curl "https://satring.com/api/v1/search?q=satring&protocol=X402"

# Service details
curl https://satring.com/api/v1/services/my-service

# List ratings
curl https://satring.com/api/v1/services/my-service/ratings

# List categories (use IDs in category_ids when submitting)
curl https://satring.com/api/v1/categories

Payment-gated endpoints

These require payment via L402 or x402. Without auth headers, the server returns 402 with challenges for both protocols.

Each service requires 1 to 2 category_ids: 1=ai/ml, 2=data, 3=finance, 4=identity, 5=media, 6=social, 7=search, 8=storage, 9=tools.

Option A: L402 (Lightning)

# Submit a service via L402
curl -X POST https://satring.com/api/v1/services \
  -H "Authorization: L402 <macaroon>:" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My API",
    "url": "https://api.example.com",
    "pricing_sats": 10,
    "pricing_model": "per-request",
    "protocol": "L402",
    "category_ids": [1, 2]
  }'

Option B: x402 (USDC on Base)

# Submit a service via x402
curl -X POST https://satring.com/api/v1/services \
  -H "PAYMENT-SIGNATURE: <base64-encoded-payment-json>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My API",
    "url": "https://api.example.com",
    "pricing_usd": "0.50",
    "pricing_model": "per-request",
    "protocol": "x402",
    "x402_network": "eip155:8453",
    "x402_asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "x402_pay_to": "0xYourWalletAddress",
    "category_ids": [1, 2]
  }'

Dual-protocol listing (L402+x402)

A single service can support both payment rails. Set "protocol": "L402+x402" and include both sat pricing and x402 fields:

curl -X POST https://satring.com/api/v1/services \
  -H "Authorization: L402 <macaroon>:" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Dual API",
    "url": "https://api.example.com",
    "pricing_sats": 10,
    "pricing_model": "per-request",
    "protocol": "L402+x402",
    "x402_network": "eip155:8453",
    "x402_asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "x402_pay_to": "0xYourWalletAddress",
    "pricing_usd": "0.50",
    "category_ids": [1, 2]
  }'

Dual-protocol services