blockrun-setup SKILL.md skillA

blockrun-setup 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/blockrun-setup@git:20260920.cdfe831

Pins git:20260920.cdfe831 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/blockrun-setup/SKILL.md
Versions recorded
5
Latest version
git:20260920.cdfe831, committed Sep 20, 2026
First version recorded
Sep 5, 2026
Size
8,065 bytes
Repository stars
391
License
MIT

Use when asked to install, add, configure, or set up the BlockRun MCP server (@blockrun/mcp) in Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Grok or another MCP client — including first-run wallet creation, funding with USDC, choosing a tool profile, and proving the install works. Also use when a fresh install 'doesn't show up' or a user asks how to pay for calls.

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

# Installing BlockRun MCP

One command per client, then one tool call to see the wallet. Do it in this order; the
PATH step is the one people skip and then spend an hour on.

## 1. Check Node first

```bash
node -v      # must print v20.19 or newer
which npx
```

If `node` is from **nvm, Homebrew, fnm, volta or asdf**, assume the client's launcher
will NOT find it. GUI-launched apps and Claude Code's MCP spawner do not source your
shell profile. The fix is to pass your shell's PATH through at install time — not to
pin `nvm alias default`, not to edit `.zshrc`, not to symlink node into `/usr/local/bin`.

## 2. Install — pick the client

**Claude Code** (recommended; `-s user` = every project):

```bash
claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest
```

The `--` matters: it stops `-y` being parsed by `claude mcp add`. The `-e PATH="$PATH"`
is the nvm/Homebrew fix from step 1; it is harmless on a system Node, so always include it.

**Codex CLI** (`--env` is Codex's equivalent of `-e`; config lands in `~/.codex/config.toml`):

```bash
codex mcp add blockrun --env PATH="$PATH" -- npx -y @blockrun/mcp@latest
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add blockrunai/blockrun-mcp/blockrun-setup@sha256:07e3305671150bfd

The line at the top of this page pins the label git:20260920.cdfe831, 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_nahx7sy34haaiddo.svg)](https://markdownregistry.com/a/art_nahx7sy34haaiddo)

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

Versions

The registry has recorded 5 versions of this file, between Sep 5, 2026 and Sep 20, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20260920.cdfe831 latest2026-09-20 cdfe831 8,065 BA view · diff
git:20260915.c39cc812026-09-15 c39cc81 8,065 BA view · diff
git:20260909.6d4afd42026-09-09 6d4afd4 7,829 BA view · diff
git:20260909.c091b8d2026-09-09 c091b8d 6,992 BA view · diff
git:20260905.a5f248d2026-09-05 a5f248d 6,949 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 (8065 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_nahx7sy34haaiddo
GET https://markdownregistry.com/api/v1/resolve?ref=blockrunai/blockrun-mcp/blockrun-setup
GET https://markdownregistry.com/api/v1/blob/07e3305671150bfdd04444f70162a580e4f0a602f9e76bb5e33a01a235515082

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-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
phone SKILL.md skill
blockrunai/blockrun-mcp · skills/phone/SKILL.md · Use when the user wants phone-number intelligence (lookup, carrier, line type, SIM-swap / call-forwarding fraud…
git:20260909.c091b8d · audit A · 391 stars

Every file in blockrunai/blockrun-mcp

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