surf

Solid

Use when the user wants crypto data — token prices, on-chain SQL, prediction-market positions, CEX order books, wallet labels/net-worth, social mindshare, news, or a Surf-1.5 chat answer with citations. 84 endpoints across exchange, on-chain, wallet, social, prediction, news, search, and chat — one API, pay-per-call in USDC via x402. Settles directly to Surf's Base treasury; no Surf account needed.

AI & Automation 465 stars 50 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 94/100

Stars 20%
89
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Surf — Crypto Data via BlockRun Surf (asksurf.ai) aggregates **84 crypto data endpoints** across CEX market data, on-chain SQL (13 chains, 80+ ClickHouse tables), 100M+ labeled wallets, prediction markets (Polymarket + Kalshi side-by-side), social/CT intelligence, news, unified search, and Surf-1.5 chat with citations. BlockRun is Surf's x402 payment rail — every call settles **directly to Surf's Base treasury**. You hold the wallet, BlockRun holds the Surf key, Surf holds the data. No Surf account, no API key, no monthly minimum. ## How to Call from MCP One tool, three params. The MCP tool auto-routes method (POST when `body` is set, GET otherwise) and auto-validates required params before settling: ```ts blockrun_surf({ path: "market/price", params: { symbol: "BTC" } }) blockrun_surf({ path: "onchain/sql", body: { sql: "SELECT token_address, count() FROM ethereum.dex_trades WHERE block_time > now() - INTERVAL 1 DAY GROUP BY 1 ORDER BY 2 DESC LIMIT 10" }}) blockrun_surf({ path: "chat/completions", body: { model: "surf/surf-1.5", messages: [{ role: "user", content: "What's the Polymarket consensus for the 2028 US election?" }], }}) ``` ## Three Pricing Tiers | Tier | Price | Used by | |------|-------|---------| | 1 | $0.001 | prices, rankings, lists, news, profiles, simple reads (~50 endpoints) | | 2 | $0.005 | order books, candles, search, wallet detail, social aggregates (~30 endpoints) | | 3 | $0.020 | raw on-chain SQL, structured queries, surf-1.5 chat (3...

Details

Author
BlockRunAI
Repository
BlockRunAI/blockrun-mcp
Created
5 months ago
Last Updated
2 days ago
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

last30days-surf

Research what people actually said about any topic over the last 30 days across Reddit, X/Twitter, YouTube, GitHub, Hacker News, Polymarket, Bluesky, TikTok, Instagram, Threads, and the open web. One surf API key replaces the seven keys upstream needed (xAI, ScrapeCreators, Brave, OpenRouter, Apify, X cookies, yt-dlp install). Use when the user runs /last30days-surf <topic>, /l30, asks 'what's new with X', 'what are people saying about Y', 'last 30 days of Z', wants 'X vs Y' comparison, asks for competitors of a brand, prepares for a meeting/launch/trip, asks 'is X any good lately', or wants engagement-ranked discussion (upvotes, likes, dollar-backed odds) instead of SEO-ranked editorial content. Triggers: /last30days-surf, /l30, last 30 days, past month, past 30 days, recent discussion, what's new with, what are people saying about, vs mode, competitor comparison, before a meeting, before a launch, before a trip.

29 Updated yesterday
tenequm
AI & Automation Listed

deep-research-surf

Conducts deep, multi-angle research using Surf MCP tools and parallel subagents. Use for deep research, competitive landscape analysis, strategic intelligence, or /deep-research-surf [topic]. Triggers - deep research, deep dive on, competitive landscape, strategic intelligence, multi-source synthesis.

29 Updated yesterday
tenequm
AI & Automation Solid

rpc

Use when the user needs raw blockchain JSON-RPC access — contract reads (eth_call), native balances, blocks, transactions, logs, gas estimates, or any chain-native RPC method across 40+ chains. One endpoint per chain via BlockRun's Tatum-backed gateway, $0.002 per call, no node, no API key. Prefer blockrun_price / blockrun_dex / blockrun_surf when they already cover the question.

465 Updated 2 days ago
BlockRunAI