🦸 SUPAH Agent API

Intelligence Oracle for AI Agents on Base

Endpoints

$0.001

Starting Price

USDC

x402 Payments

Base

Network

🎮 Try Demo 📡 Endpoints ⚡ How It Works 🔧 Integration 🤖 MCP 📋 JSON API

⚡ How x402 Payments Work

No API keys. No subscriptions. Just pay-per-call with USDC on Base.

📡

1. Call Endpoint

Make a GET request to any paid endpoint

💰

2. Get 402

Server returns HTTP 402 with payment details

🔐

3. Sign & Pay

Your agent signs a USDC payment on Base

📊

4. Get Data

Resend request with payment proof → get intelligence

🎮 Free Demo — Try It Now

These endpoints are completely free. No payment, no signup. Click "Try It" to see live data.

📡 All Paid Endpoints

🔧 Integration Guide

Python (with x402-python)

from x402.client import X402Client

client = X402Client(
    private_key="your_base_wallet_private_key",
    network="base"
)

# Get token safety score — costs $0.01 USDC
result = client.get("https://api.supah.ai/agent/v1/safety/0x...")
print(result.json())

Node.js (with @coinbase/x402)

import { payForRequest } from '@coinbase/x402';

const url = 'https://api.supah.ai/agent/v1/safety/0x...';
const res = await fetch(url);

if (res.status === 402) {
  // Sign USDC payment and retry with proof
  const paid = await payForRequest(url, res, wallet);
  const data = await paid.json();
  console.log(data);
}

cURL (Demo — Free)

# Free demo endpoints — no payment needed
curl -s https://api.supah.ai/agent/v1/demo/safety/0x40ba...5838 | jq .
curl -s https://api.supah.ai/agent/v1/demo/price/0x40ba...5838 | jq .
curl -s https://api.supah.ai/agent/v1/demo/trending | jq .

Payment Details

# Payment Info
Network:  Base mainnet (eip155:8453)
Currency: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
PayTo:    0xD3B2eCfe77780bFfDFA356B70DC190C914521761
Protocol: x402 (https://www.x402.org)

🤖 MCP Integration

Connect your AI agent (Claude, Cursor, etc.) to SUPAH via the Model Context Protocol. Discover endpoints, check pricing, and try demos — all from your agent's tool interface.

Add to Claude Desktop / Cursor

Add this to your MCP config file (claude_desktop_config.json or .cursor/mcp.json):

{
  "mcpServers": {
    "supah-agent-api": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.supah.ai/mcp"]
    }
  }
}

Available MCP Tools

# Tools your agent can use:
search_endpoints  — Search API catalog by keyword
get_pricing       — Full pricing table
demo_safety       — Live safety score (free)
demo_price        — Live token price (free)
demo_trending     — Trending tokens (free)

Discovery Endpoint

curl -s https://api.supah.ai/mcp | jq .