blockrun SKILL.md skillA

blockrun 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@v1

Pins v1 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/SKILL.md
Versions recorded
8
Latest version
v1, committed Oct 11, 2026
First version recorded
Aug 12, 2026
Size
10,941 bytes
Repository stars
391
License
MIT

Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on Base or Solana), or a BlockRun account API key. No subscriptions. Start here when you have the BlockRun MCP installed and need to know WHICH tool answers a question, how the wallet works, or how to make a first call for free. TOOLS: blockrun_chat, blockrun_image, blockrun_video, blockrun_music, blockrun_speech, blockrun_search, blockrun_exa, blockrun_markets…

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

# BlockRun

One wallet, pay-per-call, no API keys. Every paid tool below settles in USDC over x402 at the
moment of the call.

## Never quote a price from memory

There is no price table in this skill, and that is deliberate. Every flat per-call price
published in this repo drifted by exactly the per-transaction fee the last time that fee
changed, because each one was a typed copy. Read prices from a live source instead:

| Need | Where |
|------|-------|
| Per-token model pricing | `blockrun_models` |
| What a call will actually cost | the `402` response — it carries the real amount |
| Full endpoint catalog with prices | <https://blockrun.ai/llms.txt> (Base) · <https://sol.blockrun.ai/llms.txt> (Solana) |

The tool descriptions in the MCP server carry the published base prices too; they are typed by hand and verified against live 402 quotes by `npm run verify:prices`, and the 402 header is what actually gets charged.

## The two chains are not the same gateway

`blockrun.ai` and `sol.blockrun.ai` are separate deployments, and
`blockrun_wallet action: "chain"` switches between them mid-session. Two consequences,
both easy to miss because nothing announces the switch:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add blockrunai/blockrun-mcp/blockrun@sha256:5a1ee0ce8876d0c3

The line at the top of this page pins the label v1, 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_eqpmjcllpr5eggaf.svg)](https://markdownregistry.com/a/art_eqpmjcllpr5eggaf)

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

Versions

The registry has recorded 8 versions of this file, between Aug 12, 2026 and Oct 11, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
v1 latest2026-10-11 5cc7b5e 10,941 BA view · diff
v12026-10-11 9a6fdf2 10,938 BA view · diff
v12026-10-07 abaafb2 10,938 BA view · diff
v12026-09-20 cdfe831 10,936 BA view · diff
v12026-09-15 f9480ad 10,740 BA view · diff
v12026-09-09 c091b8d 10,735 BA view · diff
v12026-09-05 a549756 10,521 BA view · diff
v12026-08-12 66dc81a 10,521 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 (10941 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_eqpmjcllpr5eggaf
GET https://markdownregistry.com/api/v1/resolve?ref=blockrunai/blockrun-mcp/blockrun
GET https://markdownregistry.com/api/v1/blob/5a1ee0ce8876d0c361e913b4e484f24c8301ea940633168506e97e9f66800636

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
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

Other files named blockrun

blockrun SKILL.md skill
aicodedecode/awesome-muse-skills · skills-imported/blockrun/SKILL.md · Use when user needs capabilities Claude lacks (image generation, real-time X/Twitter data) or explicitly requests…
git:20260927.806f3e1 · audit A · 25 stars

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