What is blockrun-mcp CLAUDE.md?

A project guide for BlockRun MCP, a server that gives Claude access to live market, research, social-media, and cryptocurrency data through paid USDC calls. It lists its commands, files, dependencies, and setup for Claude Code.

Use it when modifying MCP tools, data handlers, payment integration, types, utilities, builds, or Claude Code installation instructions.

It helps an AI assistant build and run the server using the project's expected TypeScript, Node.js, MCP, and payment conventions.

blockrun-mcp CLAUDE.md — Instructions file for coding agents by BlockRunAI: A project guide for BlockRun MCP, a server that…

Install

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.

agentmods

npx agentmods add instructions/blockrunai/blockrun-mcp/claude-md

Clone the repo

git clone --depth 1 https://github.com/BlockRunAI/blockrun-mcp

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

README.md

[![agentmods](https://agentmods.dev/badge/instructions/blockrunai/blockrun-mcp/claude-md.svg)](https://agentmods.dev/instructions/blockrunai/blockrun-mcp/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/blockrunai/blockrun-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/blockrunai/blockrun-mcp/claude-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 284 This file is loaded in full into every session.

When invoked 284 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin 88% copy Near-identical to another mod in the catalogue.

Token cost

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.00284	$0.00284
Opus 5	$0.00142	$0.00142
Sonnet 5	$0.00057	$0.00057
Haiku 4.5	$0.00028	$0.00028

Measured 4d ago against content hash eb888d12bca9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

blockrun-mcp CLAUDE.md 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 4d 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.

Origin

This is a copy

88% identical to blockrun-mcp AGENTS.md — 6 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 47 lines

What it actually says

BlockRun MCP

MCP server giving Claude real-time data — markets, research, X/Twitter, crypto. Pay per call with USDC.

Commands

npm install              # install dependencies
npm run build            # compile with tsup
npm run dev              # watch mode (tsx)
npm start                # start MCP server
npm run typecheck        # type checking

Project structure

src/
├── index.ts             # MCP server entry point
├── mcp-handler.ts       # MCP protocol handler
├── tools/               # MCP tool implementations
├── types.ts             # Type definitions
└── utils/               # Shared utilities

Key dependencies

@blockrun/llm — LLM gateway SDK (x402 payments)
@modelcontextprotocol/sdk — MCP protocol SDK
zod — Schema validation
viem — Ethereum interaction
qrcode — Wallet QR code display

Install in Claude Code

claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest

Conventions

TypeScript, ESM
Build with tsup
Node >= 20.19
MIT license
npm registry: @blockrun/mcp

Changes

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.

4d ago First seen · 47 lines · 284 tokens per session scan A eb888d12bca9

Subscribe to this mod's changes

blockrun-mcp CLAUDE.md is an instructions file published in the GitHub repository BlockRunAI/blockrun-mcp (393 stars, last pushed yesterday), licensed MIT. It adds 284 tokens to every session, about $0.0014 per session on Opus 5. A static security scan graded it A with 0 findings. It is 88% identical to blockrun-mcp AGENTS.md, differing in 6 lines, and is treated as a copy.

LLM ai claude-code mcp mcp-server x402

GhidrAssistMCP CLAUDE.md

Claude Code instructions for symgraph/GhidrAssistMCP, covering claude.md, build and development commands, building the extension, set ghidrainstalldir environment variable first and build the extension.

symgraph/GhidrAssistMCP · 1,019 tokens

pbi-context CLAUDE.md

Instructions for Osc2405/pbi-context, covering estado actual (actualizado 2026-07-15), actualización 2026-08-03 — rename pbi-docs → pbi-context, 0. contexto del proyecto (no re-investigar, ya validado), 1. feature obligatoria: soporte .pbip / tmdl and por qué es obligatoria (contexto de mercado, no opinable).

Osc2405/pbi-context · 16,088 tokens

blockrun-mcp CLAUDE.md