surf

surf is a skill for Claude Code, Codex from BlockRunAI/blockrun-mcp. It costs 92 tokens per session (3,874 once invoked), scanned A, original, MIT.

A single service for retrieving cryptocurrency information from exchanges, blockchains, wallets, prediction markets, social sources, and news. On-chain SQL means querying blockchain data with database-style commands.

In plain words
What is it for?
Checking token prices and exchange order books, querying blockchain activity, identifying wallet labels and net worth, comparing prediction-market positions, and searching crypto social posts or news.
Why use it?
It brings several kinds of crypto research into one interface instead of requiring separate data services for prices, wallets, chains, markets, and news.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/blockrunai/blockrun-mcp/surf
Any agent
npx skills add BlockRunAI/blockrun-mcp --skill surf
Clone the repo
git clone --depth 1 https://github.com/BlockRunAI/blockrun-mcp

Made for: Claude Code, Codex.

Its marketplace also offers this one on its own, as the plugin surf/plugin install surf after adding the marketplace above.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for surf

README.md
[![agentmods](https://agentmods.dev/badge/skills/blockrunai/blockrun-mcp/surf.svg)](https://agentmods.dev/skills/blockrunai/blockrun-mcp/surf)
Your own site
<a href="https://agentmods.dev/skills/blockrunai/blockrun-mcp/surf"><img src="https://agentmods.dev/badge/skills/blockrunai/blockrun-mcp/surf.svg" alt="Measured on agentmods" height="20"></a>
Per session 92 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,874 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00092 $0.03874
Opus 5 $0.00046 $0.01937
Sonnet 5 $0.00018 $0.00775
Haiku 4.5 $0.00009 $0.00387

Measured 5d ago against content hash 39d42c40fd86, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

surf scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/surf/SKILL.md · 285 lines

How it starts

The opening of the file, as written. The whole thing — 285 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Surf — Crypto Data via BlockRun

Surf (asksurf.ai) aggregates 83 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 and unified search.

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:

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: "wallet/labels/batch", params: { addresses: "0xabc,0xdef" } })

Pricing — one flat rate

$0.0085 per call. Every endpoint, no tiers, including raw on-chain SQL.

Verified against the gateway's own payment-required header, which is free to request — send any call with no payment header and it quotes the exact charge. All of market/price, wallet/labels/batch, social/mindshare, news/feed, exchange/klines, search/web and onchain/sql return the same $0.0085 (SURF_TIER_1/2/3_PRICE are all identical upstream).

Ignore any "premium tier" pricing you may have seen — SQL used to cost more and no longer does.

Wrong / missing required params return HTTP 400 without charging — pre-validation runs before settlement.

Do NOT use Surf for prediction markets

Surf carries 17 prediction-market/* endpoints (Polymarket + Kalshi). Use blockrun_markets (Predexon) instead — same data, same price, and far deeper.

Predexon used to be 7.5× cheaper; since 2026-07-15 both bill the same flat rate, so the choice is now purely about coverage — and Predexon still wins on coverage by a wide margin.

Read the full file on GitHub · 285 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 285 lines · 92 tokens per session scan A 39d42c40fd86

Subscribe to this mod's changes

surf is a skill published in the GitHub repository BlockRunAI/blockrun-mcp (393 stars, last pushed 2d ago), licensed MIT. It adds 92 tokens to every session and 3,874 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

x402-list

Discover x402 payment services and on-chain-verified facilitator settlement volume via the x402-list directory. Use when a user or agent needs to find an API/service that accepts x402 (HTTP 402 stablecoin) payments, compare services by reliability and price, check service uptime/health, see whether a service has…

mcccsm/x402-list-mcp · 99 tokens

x402

HTTP 402 payment protocol for AI agent commerce — three-actor model (Client, Resource Server, Facilitator), ERC-3009 transferWithAuthorization, server middleware (@x402/express), client patterns in TypeScript and Python, facilitator integration, agent-to-agent payments, pricing strategies, and replay protection. Works…

aomi-labs/skills · 84 tokens

bridgenode

BridgeNode MCP wrapper — stdio MCP server proxying to remote streamable-HTTP endpoint with automatic x402 payment on Solana USDC. No API keys. Use when an agent needs LLM inference through MCP (Claude Code, Cursor, etc.) and has no provider API key.

bridgenode-ai/bridgenode-mcp · 62 tokens

x402-payments

Quote and settle OpenMesha x402 paywalled services (USDC on Base). Use when metering tool calls, outcome fees, or agent-to-agent settlement.

ANAMIZED/OpenMesha · 39 tokens

onesource-report-bug

Report a bug or unexpected error in OneSource MCP to the OneSource team using the 1sreportbug tool. Use when a 1s blockchain tool returns an unexpected error, or when the user explicitly asks to report a problem. Free, no payment required. Do NOT report 402 (payment/auth) or 403 (subscription) responses — those are…

blockparty-global/1s-mcp · 87 tokens

evm

Read-only EVM client: wallets, tokens, gas across 8 chains.

NousResearch/hermes-agent · 19 tokens