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.
npx agentmods add skills/blockrunai/blockrun-mcp/surfnpx skills add BlockRunAI/blockrun-mcp --skill surfgit clone --depth 1 https://github.com/BlockRunAI/blockrun-mcpWrote 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.
[](https://agentmods.dev/skills/blockrunai/blockrun-mcp/surf)<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>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.
| Model | Per session | Once 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 |
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.
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.
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.
- 5d ago First seen · 285 lines · 92 tokens per session scan A 39d42c40fd86
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.
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…
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…
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.
x402-payments
Quote and settle OpenMesha x402 paywalled services (USDC on Base). Use when metering tool calls, outcome fees, or agent-to-agent settlement.
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…
evm
Read-only EVM client: wallets, tokens, gas across 8 chains.