Agent skill

Blockrun

by BlockRunAI in BlockRunAI/blockrun-mcp

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.

MITAuto-check passedMedia & Creative

Install Blockrun

skills CLI
$ npx skills add BlockRunAI/blockrun-mcp --skill blockrun -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BlockRunAI/blockrun-mcp blockrun --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BlockRunAI/blockrun-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/blockrun .claude/skills/blockrun && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
blockrun
GitHub stars
392
Token cost
~2.7k tokens
SKILL.md length
1,413 words
Files
2
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Works in 3 steps: blockrun_wallet action: "setup" prints… → To fund with a card, blockrun_wallet… → Or send USDC to the address on Base or…
  • Tasks that involve Crypto and DeFi analysis
  • SKILL.md covers Never quote a price from memory, The two chains are not the…, Getting a first call working and Which tool, plus 4 more sections
  • Calls npm and curl

What it does

Blockrun is an agent skill from BlockRunAI/blockrun-mcp. 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: blockrunchat, blockrunimage, blockrunvideo, blockrunmusic, blockrunspeech, blockrunsearch, blockrunexa, blockrunmarkets, blockrunpolymarketread, blockrunpolymarket…

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `rules/wallet-and-payment.md`).

It sits in Media & Creative, covering Crypto and DeFi analysis, Web search and Smart contracts. It works with Solana, x402, Model Context Protocol and Polymarket. The repository describes itself as: Live data for AI agents — search, research, markets, crypto, X/Twitter. Pay-per-call via x402 micropayments. The licence is MIT.

When your agent uses it

  • Tasks that involve Crypto and DeFi analysis
  • Tasks that involve Web search
  • Tasks that involve Smart contracts

Example prompts

  • “/blockrun”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. blockrun_wallet action: "setup" prints the address and a funding QR.
  2. To fund with a card, blockrun_wallet action: "deposit" mints a one-time Coinbase Onramp
  3. Or send USDC to the address on Base or Solana.

What it can do on your machine

Read from SKILL.md and the folder at commit a7a9b3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • blockrun.ai
    • sol.blockrun.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Blockrun loads about 2.7k tokens when it runs. Until then it costs about 238 tokens; SKILL.md has 1,413 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~238
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BlockRunAI/blockrun-mcp at commit a7a9b3c, republished under its MIT licence (© BlockRunAI). 1,413 words, ~2,720 tokens.

Download SKILL.mdSave it as .claude/skills/blockrun/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
blockrun
description
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, blockrun_polymarket_read, blockrun_polymarket, blockrun_price, blockrun_dex, blockrun_defi, blockrun_rpc, blockrun_phone, blockrun_realface, blockrun_modal, blockrun_models, blockrun_wallet. TRIGGERS: blockrun, x402, use grok, use gpt, use deepseek, compare models, generate image, generate video, generate music, text to speech, web search, news search, prediction market, crypto price, on-chain data, blockchain rpc, phone call, run code remotely, pay per call
homepage
https://blockrun.ai
metadata.version
1

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:

NeedWhere
Per-token model pricingblockrun_models
What a call will actually costthe 402 response — it carries the real amount
Full endpoint catalog with priceshttps://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:

Prices differ, on purpose. Every figure in these skills is the Base price. Base adds a flat per-transaction fee; Solana deliberately adds none — the ~$0.001-per-call gap is pricing policy (an incentive to settle on Solana), not drift, so do not expect it to be "fixed". Each gateway's own llms.txt quotes its own convention — read the one for the chain you are on, or just read the 402.

Some tools do not exist on Solana at all. Verified against both gateways 2026-08-07:

ToolOn SolanaWhat you get
blockrun_defi✗ not served404 — reads like a bad path, but the path is fine
blockrun_modal✗ not served503 on all four sandbox actions — reads like an outage
everything else✓~$0.001 cheaper than the figure printed here

Both tools now refuse before the round trip and tell you to switch, so you should never see the raw 404/503 through the MCP. If you are calling the HTTP API directly you will, and neither status says "wrong chain" — check the chain first.

The same applies to counts. Where a number has a canonical source it is wrapped in a br: HTML-comment marker in this file, regenerated from brand-numbers.json by scripts/sync-brand-numbers.mjs and enforced in CI by --check. Add the marker rather than the digits — an unmarked number is invisible to that check, which is exactly how the prices drifted.

Getting a first call working

Free, no wallet, no key. <!-- br:models.free -->6<!-- /br:models.free --> open-weight chat models cost nothing. Use blockrun_chat with mode: "free" — the parameter is mode, not routing, and an unrecognised key is silently dropped, which lands you on the paid balanced tier instead. Calling the HTTP API directly, a free model needs no wallet and no X-PAYMENT header at all; it returns 200 on the first request rather than a 402.

Do this first whenever a language model is all the task needs — it is the shortest path to something working, and it costs nothing if it turns out to be the wrong approach.

When you need the paid catalog, check the balance with blockrun_wallet (action: "status"). If it is zero:

  1. blockrun_wallet action: "setup" prints the address and a funding QR.
  2. To fund with a card, blockrun_wallet action: "deposit" mints a one-time Coinbase Onramp link and opens it. The call itself is free. Base only — on Solana it returns address and QR guidance instead, so fund Solana by transfer.
  3. Or send USDC to the address on Base or Solana.

Do not fund a wallet inside an ephemeral sandbox (Claude Cowork / Desktop / Web). The key lives in ~/.blockrun/ on whatever filesystem you are on, and if that is a throwaway VM the USDC goes with it. In a sandbox, use the free models or hand the user the command to run locally.

Deeper wallet, budget and x402 mechanics — including calling the HTTP API directly — are in rules/wallet-and-payment.md.

Which tool

The questionToolNotes
Anything a language model can answerblockrun_chatSee routing modes below
Make an imageblockrun_imageAlso /edit for changes to an existing image
Make a videoblockrun_videoAsync — submit, then poll
Video of one specific real personblockrun_realfaceEnroll a face, then pass real_face_asset_id to blockrun_video
Make musicblockrun_musicFull-length tracks
Speak text aloudblockrun_speechAlso sound effects
"What just happened" — news, live webblockrun_searchFreshest; priced per source
Research, papers, competitors, page contentsblockrun_exaSemantic, not keyword
Event odds, betting marketsblockrun_marketsReading only
Polymarket positions, open orders, order previewblockrun_polymarket_readReads and previews only — structurally cannot sign
Actually place a Polymarket betblockrun_polymarketReal money — confirm-gated. Setup and funds-affecting actions only
Token / FX / commodity priceblockrun_priceCrypto, FX and commodities are free
DEX pairs and liquidityblockrun_dexFree
DeFi TVL, yieldsblockrun_defi
Raw JSON-RPC against a chainblockrun_rpc<!-- br:chains.rpc -->40<!-- /br:chains.rpc --> chains, one gateway
Phone lookup, buy a number, make an AI callblockrun_phoneBuy the number first
Run code in a remote container / on a GPUblockrun_modalPrefer local for normal repo work
Which models exist, and what they costblockrun_models
Balance, funding, spend capsblockrun_wallet
A fixed yes/no, choice or score over many items, free(no tool) — curl api.blockrun.ai/v1/decideNeeds a free key; see the decide skill. You are the better one-off judge

The crypto tools overlap heavily. Prefer the free ones (blockrun_price, blockrun_dex) when they already answer the question, and reach for blockrun_defi or blockrun_markets only when they do not. On-chain SQL, wallet labels and social mindshare came from blockrun_surf, which was removed in 0.49.0 — the gateway retired Surf on 2026-09-06 and there is no replacement yet.

Show full SKILL.md (492 more words)Show less

Picking a chat model

blockrun_chat takes a mode instead of a model id. Default to balanced — it is what an omitted mode resolves to anyway, and it is the right answer for most requests.

modeReach for it whenSpeed
balancedThe default. General work, code, analysisMedium
fastLatency matters more than depth — classification, extraction, short repliesFastest
powerfulFrontier models. Hard reasoning, work you would not want to redoSlowest
reasoningMulti-step logic, maths, proofsSlow
codingCode generation and refactors specificallyMedium
glmCheap and strong at codeFast
cheapHigh volume, low stakesFast
freeAnything where "good enough and free" winsFast

Two things to know about free: it routes to the open-weight tier only, and that path caps very long inputs. Through the MCP the truncation is reported — the response carries a note saying roughly what fraction of the prompt never reached the model — but a direct HTTP call gets no such warning, so do not send a large document over the free tier and assume the answer covered all of it. mode is ignored entirely when you pass an explicit model.

Name a specific model only when the user names one, or when a task genuinely needs that model's quirk. Otherwise a mode is both cheaper and more robust to the catalog moving.

For media, the picking advice lives with the generation tools, and blockrun_models is authoritative — this list would go stale within a release.

Cost discipline

  • Failed requests are not charged. Settlement happens on success only, so a non-2xx costs nothing and retrying after an upstream error is free. Do not let a failure stop you retrying.
  • Check the balance before an expensive call. Video generation is the priciest category by a wide margin — a single call can cost more than a thousand chat calls.
  • Free before paid. blockrun_price (crypto/FX/commodities), blockrun_dex, and the free chat tier cost nothing. Reach for them before their paid equivalents.
  • Set a cap for unattended work. blockrun_wallet action: "budget" sets a session spend ceiling; action: "delegate" gives a sub-agent its own allowance.

Troubleshooting

SymptomWhat it means
402 Payment Required came back twiceThe signature did not verify. Check the wallet has a key and the chain matches the requirements.
"Insufficient balance"blockrun_wallet action: "status", then fund — or switch to a free model.
Balance funded but still zeroWait for network confirmation and re-check; Base finality is seconds, not instant.
A model id 404sIt was delisted. blockrun_models for the live list; some ids redirect, some are gone.
Video job never finishesVideo is async by design. Poll the job id; minutes, not seconds.
Price does not match what you expectedRead the 402, not a remembered figure. Prices move.
Per-call cap refused to signThat is a client-side spending hook, not BlockRun rejecting the call.

Install from the same marketplace for depth on one area: search, exa-research, crypto-data, surf, rpc, prediction-markets, polymarket-trading, image-prompting, phone, modal, decide.

bash
/plugin marketplace add BlockRunAI/blockrun-mcp

© BlockRunAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/blockrun of BlockRunAI/blockrun-mcp.

  • SKILL.md
  • rules/wallet-and-payment.md

Open the folder on GitHubat commit a7a9b3c

Compare with similar skills

Blockrun next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Blockrun compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Blockrun this skillBlockRunAI/blockrun-mcp392—~2.7kAutomated safety check: PassMIT
Mmx CLIagentscope-ai/OpenJudge8671 repos~655Automated safety check: PassApache-2.0
Finance District MCPaeonfun/aeon767—~1.1kAutomated safety check: PassMIT
Agent SoulLeoYeAI/openclaw-master-skills2.2k—~5.2kAutomated safety check: PassMIT
Alchemy Agentic Gatewaymoonpay/skills113—~2.1kAutomated safety check: NotesMIT
AlchemyBankrBot/skills1.2k—~3.5kAutomated safety check: PassMIT

Similar skills

  • Mmx CLI

    agentscope-ai/OpenJudge

    Generate text, images, video, speech, and music via the MiniMax AI platform.

    867 GitHub starsUsed in 1 repo~655 tokens
    Media & CreativeAuto-check passed
  • Multichain non-custodial agent wallet via Finance District - check balances, prices, and best DeFi yields, move funds, swap, and make x402 paid API calls across EVM, Solana, Bitcoin, and Sui.

    767 GitHub stars~1.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Agent Soul

    LeoYeAI/openclaw-master-skills

    Create AI art, mint NFTs, and trade on the Agent Soul marketplace.

    2.2k GitHub stars~5.2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • A skill your agent uses when accessing Alchemy APIs for RPC calls, token balances, NFT metadata, asset transfers, transaction simulation, or Alchemy-specific features.

    113 GitHub stars~2.1k tokensUpdated 27 days ago
    Backend & APIsAuto-check: notes
  • Alchemy

    BankrBot/skills

    Blockchain API access via Alchemy. An agent skill from BankrBot/skills.

    1.2k GitHub stars~3.5k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Zerion Wallet Data

    moonpay/skills

    A skill your agent uses when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs.

    113 GitHub stars~1.7k tokensUpdated 27 days ago
    Business, Finance & HRAuto-check passed

More from BlockRunAI/blockrun-mcp

All 17 skills in this repo
  • Signal To Trade Demo

    BlockRunAI/blockrun-mcp

    Prepare or run a polished BlockRun trading demo that discovers a current Polymarket market, combines live price, probability history, smart-money, and liquidity evidence into a balanced signal…

    392 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Debug

    BlockRunAI/blockrun-mcp

    A skill your agent uses when the BlockRun MCP server (@blockrun/mcp) is installed but misbehaving — 'Failed to connect', spawn npx ENOENT, blockrun missing from claude mcp list, HTTP 402 /…

    392 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Setup

    BlockRunAI/blockrun-mcp

    A skill your agent uses 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…

    392 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Upgrade

    BlockRunAI/blockrun-mcp

    A skill your agent uses when the BlockRun MCP server prints 'Update available', when asked to upgrade, update, or pin @blockrun/mcp, when a fix 'should be in the new version' but the client still…

    392 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Crypto Data

    BlockRunAI/blockrun-mcp

    A skill your agent uses for any crypto data question — token/coin prices, FX, commodities, stocks, OHLC history, DEX pairs and liquidity, DeFi TVL, yield/APY pools, or raw JSON-RPC against a chain…

    392 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Decide

    BlockRunAI/blockrun-mcp

    A skill your agent uses when the user wants to try BlockRun's free typed-judgment endpoint (POST api.blockrun.ai/v1/decide, served by OpenJev) on their own data from Claude Code — yes/no, labelled…

    392 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed

Questions about Blockrun

What does Blockrun do?

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. Blockrun is an agent skill from BlockRunAI/blockrun-mcp. 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.

When should I use Blockrun?

Blockrun fits situations like: tasks that involve Crypto and DeFi analysis; tasks that involve Web search; tasks that involve Smart contracts.

How do I install Blockrun in Claude Code?

Run `npx skills add BlockRunAI/blockrun-mcp --skill blockrun -a claude-code`. Or copy the skill folder (skills/blockrun in BlockRunAI/blockrun-mcp) into .claude/skills/blockrun in your project. Claude Code loads it when a task matches its description.

How do I install Blockrun in Codex?

Run `npx skills add BlockRunAI/blockrun-mcp --skill blockrun -a codex`. Or copy the skill folder (skills/blockrun in BlockRunAI/blockrun-mcp) into .agents/skills/blockrun in your project. Codex loads it when a task matches its description.

Can I use Blockrun in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BlockRunAI/blockrun-mcp --skill blockrun -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/blockrun, .gemini/skills/blockrun, .github/skills/blockrun and .opencode/skills/blockrun in your project.

What does Blockrun need to run?

Going by SKILL.md and its folder, Blockrun needs the command-line tools its instructions call (npm and curl).

Does Blockrun access the network?

SKILL.md names 2 domains. As links in the text: blockrun.ai and sol.blockrun.ai. This is read from the text; nothing was executed.

Is Blockrun safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Blockrun use?

Blockrun is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Blockrun use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Blockrun?

Skills that share tags, products or a category with Blockrun: Mmx CLI (agentscope-ai/OpenJudge, 867 stars), Finance District MCP (aeonfun/aeon, 767 stars), Agent Soul (LeoYeAI/openclaw-master-skills, 2.2k stars) and Alchemy Agentic Gateway (moonpay/skills, 113 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Blockrun?

BlockRunAI (a GitHub organization) maintains it in BlockRunAI/blockrun-mcp, which has 392 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

Source: BlockRunAI/blockrun-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.