surf SKILL.md skillA

surf from blockrunai/blockrun-mcp is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add blockrunai/blockrun-mcp/surf@git:20261007.abaafb2

Pins git:20261007.abaafb2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
blockrunai/blockrun-mcp
Path
skills/surf/SKILL.md
Versions recorded
6
Latest version
git:20261007.abaafb2, committed Oct 7, 2026
First version recorded
Jul 15, 2026
Size
6,822 bytes
Repository stars
391
License
MIT

Surf (asksurf.ai) is RETIRED on BlockRun and the blockrun_surf tool was REMOVED in 0.49.0 — the gateway has answered every /v1/surf/* path with HTTP 410 endpoint_retired since 2026-09-06. Use this skill to route a former Surf question (on-chain SQL, wallet labels and net worth, CEX order books, social mindshare, news) to the tool that still serves it, and to say plainly what has no replacement yet.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Surf — retired on BlockRun (2026-09-06)

Surf (asksurf.ai) is no longer served through BlockRun. Since **2026-09-06** the
gateway answers every `/v1/surf/*` path with:

```
HTTP 410
{"error":{"code":"endpoint_retired","message":"The Surf data endpoints are retired. We are looking for a new vendor in this space and expect to publish a replacement under /api/v1/."},
 "retired_on":"2026-09-06",
 "alternatives":[{"for":"crypto, equity, FX and commodity prices","endpoint":"/api/v1/crypto/price"},
                 {"for":"protocol TVL and yields","endpoint":"/api/v1/defillama/*"},
                 {"for":"prediction markets","endpoint":"/api/v1/pm/*"},
                 {"for":"DEX quotes and swaps","endpoint":"/api/v1/zerox/*"}]}
```

Verified live 2026-09-08 with an unauthenticated GET (a 410 is free to fetch).
`sol.blockrun.ai` answers 404 on the same paths, and `/api/openapi` no longer
lists any Surf route. **No 402 is ever issued, so no payment can be made.**

`blockrun_surf` was **removed from the server in 0.49.0** and is no longer one of
the <!-- br:mcp.tools -->19<!-- /br:mcp.tools --> tools: a tool that can only
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add blockrunai/blockrun-mcp/surf@sha256:4a1629efcdd5e066

The line at the top of this page pins the label git:20261007.abaafb2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nnohjmayr67azj5q.svg)](https://markdownregistry.com/a/art_nnohjmayr67azj5q)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Jul 15, 2026 and Oct 7, 2026, about one every 17 days.

versioncommittedcommitsizeaudit
git:20261007.abaafb2 latest2026-10-07 abaafb2 6,822 BA view · diff
git:20260909.c091b8d2026-09-09 c091b8d 6,828 BA view · diff
git:20260808.b00dcdb2026-08-08 b00dcdb 13,405 BA view · diff
git:20260716.2985b232026-07-16 2985b23 13,412 BA view · diff
git:20260716.8af6baf2026-07-16 8af6baf 13,499 BA view · diff
git:20260715.ff32cb42026-07-15 ff32cb4 13,515 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6822 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

blockrunai/blockrun-mcp · 391 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nnohjmayr67azj5q
GET https://markdownregistry.com/api/v1/resolve?ref=blockrunai/blockrun-mcp/surf
GET https://markdownregistry.com/api/v1/blob/4a1629efcdd5e066a63c15e6952bdf620292a1e71cd1a502c0f56158395a590c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from blockrunai/blockrun-mcp

AGENTS.md AGENTS.md file
blockrunai/blockrun-mcp · AGENTS.md
git:20260915.f9480ad · audit A · 391 stars
CLAUDE.md CLAUDE.md file
blockrunai/blockrun-mcp · CLAUDE.md
git:20260915.f9480ad · audit A · 391 stars
blockrun-debug SKILL.md skill
blockrunai/blockrun-mcp · skills/blockrun-debug/SKILL.md · Use when the BlockRun MCP server (@blockrun/mcp) is installed but misbehaving — 'Failed to connect', spawn npx ENOENT…
git:20260915.c39cc81 · audit B · 391 stars
blockrun-setup SKILL.md skill
blockrunai/blockrun-mcp · skills/blockrun-setup/SKILL.md · Use when asked to install, add, configure, or set up the BlockRun MCP server (@blockrun/mcp) in Claude Code, Claude…
git:20260920.cdfe831 · audit A · 391 stars
blockrun-upgrade SKILL.md skill
blockrunai/blockrun-mcp · skills/blockrun-upgrade/SKILL.md · Use when the BlockRun MCP server prints 'Update available', when asked to upgrade, update, or pin @blockrun/mcp, when a…
git:20260830.d848115 · audit B · 391 stars
blockrun SKILL.md skill
blockrunai/blockrun-mcp · skills/blockrun/SKILL.md · Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on…
v1 · audit A · 391 stars
crypto-data SKILL.md skill
blockrunai/blockrun-mcp · skills/crypto-data/SKILL.md · Use for any crypto data question — token/coin prices, FX, commodities, stocks, OHLC history, DEX pairs and liquidity…
git:20260909.c091b8d · audit A · 391 stars
decide SKILL.md skill
blockrunai/blockrun-mcp · skills/decide/SKILL.md · Use when the user wants typed judgments over their own data from Claude Code — yes/no probabilities, a labelled choice…
git:20261011.5cc7b5e · audit A · 391 stars
exa-research SKILL.md skill
blockrunai/blockrun-mcp · skills/exa-research/SKILL.md · Use when researching products, finding academic papers, discovering competitors, reading webpage content, or getting…
git:20260808.b00dcdb · audit A · 391 stars
gentech-blockrun SKILL.md skill
blockrunai/blockrun-mcp · skills/gentech-blockrun/SKILL.md · GenTech Labs' integration patterns for BlockRun MCP from Hermes Agent. Covers daily usage patterns, cost-optimized…
git:20261020.af250db · audit A · 391 stars
image-prompting SKILL.md skill
blockrunai/blockrun-mcp · skills/image-prompting/SKILL.md · Use when generating or editing images via `blockrun_image` — especially with GPT Image 2, Nano Banana, or Grok Imagine…
git:20261020.af250db · audit A · 391 stars
modal SKILL.md skill
blockrunai/blockrun-mcp · skills/modal/SKILL.md · Use when the user needs to run isolated code remotely — a disposable container, optional GPU access (T4 → H100), or a…
git:20260905.a5f248d · audit A · 391 stars

Every file in blockrunai/blockrun-mcp

Other files named surf

surf SKILL.md skill
blockrunai/clawrouter · skills/surf/SKILL.md · Use this skill — NOT browser or web_fetch — for ALL Surf crypto-data calls. 83 endpoints at localhost:8402/v1/surf/*…
git:20260905.bf927f1 · audit B · 6,630 stars
surf SKILL.md skill
devskale/skale-skills · skills/surf/SKILL.md · Bash skill — drive the user's real, logged-in Chrome on macOS (AppleScript, no debug port). Use when the user wants to…
v1.6.1 · audit A · 3 stars

Browse by kind, by grade A, or by owner.