Surf

Pay-per-use API gateway for AI agents. Inference, Twitter data, Reddit data, and web crawling - no API keys, no subscriptions. Pay per request via x402 (USDC on Solana/Base) or MPP (Tempo).

Live at surf.cascade.fyi

Services

All endpoints live under surf.cascade.fyi. Unified MCP server at /mcp.

Quick start

Test any endpoint with x402-proxy:

# Twitter user profile + recent tweets ($0.005)
npx x402-proxy https://surf.cascade.fyi/api/v1/twitter/user/cascade_fyi

# Chat with Kimi K2.5 ($0.004)
npx x402-proxy -X POST -H "Content-Type: application/json" \
  -d '{"model":"moonshotai/kimi-k2.5","messages":[{"role":"user","content":"Hello"}]}' \
  https://surf.cascade.fyi/api/v1/inference/v1/chat/completions

Or integrate directly with @x402/fetch:

import { wrapFetch } from "@x402/fetch";

const x402Fetch = wrapFetch(fetch, walletClient);

const res = await x402Fetch(
  "https://surf.cascade.fyi/api/v1/inference/v1/chat/completions",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      model: "moonshotai/kimi-k2.5",
      messages: [{ role: "user", content: "Hello!" }],
    }),
  },
);

const data = await res.json();

MCP Server

Unified MCP server with 9 tools. Supports tool filtering via ?tools= query param.

npx x402-proxy mcp add surf https://surf.cascade.fyi/mcp

Or add a filtered subset:

npx x402-proxy mcp add surf "https://surf.cascade.fyi/mcp?tools=surf_twitter_search,surf_web_crawl"

Claude Code skills

Surf ships Claude Code skills that teach the agent how to call each API:

npx skills add cascade-protocol/surf -g

Installs the unified surf skill with references for each service.

Development

pnpm install
pnpm dev        # Start dev server
pnpm check      # Type-check + lint

License

Apache-2.0