What is blockscout-analysis?

Mandatory instructions for analysing blockchain activity and writing software that queries blockchain data through the Blockscout MCP server, a service agents can call for supported networks.

Use it before making Blockscout data queries, analysing on-chain activity, or building blockchain scripts and applications.

It sets the required data-access method and explains how to choose networks, call tools, validate responses, and use the REST API in scripts.

blockscout-analysis — Skill for Claude Code and Codex by blockscout

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.

Any agent

npx skills add blockscout/agent-skills --skill blockscout-analysis

Clone the repo

git clone --depth 1 https://github.com/blockscout/agent-skills

Made for: Claude Code, Codex.

Its marketplace also offers this one on its own, as the plugin blockscout-analysis — /plugin install blockscout-analysis after adding the marketplace above.

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/skills/blockscout/agent-skills/blockscout-analysis.svg)](https://agentmods.dev/skills/blockscout/agent-skills/blockscout-analysis)

Your own site

<a href="https://agentmods.dev/skills/blockscout/agent-skills/blockscout-analysis"><img src="https://agentmods.dev/badge/skills/blockscout/agent-skills/blockscout-analysis.svg" alt="Measured on agentmods" height="20"></a>

Per session 131 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 6,451 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found 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.1	$0.00131	$0.06451
Opus 5	$0.00066	$0.03225
Sonnet 5	$0.00026	$0.01290
Haiku 4.5	$0.00013	$0.00645

Measured 7d ago against content hash 61b1d0879e78, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

blockscout-analysis scanned grade A with 1 finding 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 7d 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

Chainscout (`https://chains.blockscout.com/api`) is a separate service for resolving a chain ID to its Blockscout explorer URL. Access it via direct HTTP requests (e.g., WebFetch, curl, or from a script) — **not** via `d

blockscout-analysis/SKILL.md · 301 lines

How it starts

The opening of the file, as written. The whole thing — 301 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Blockscout Analysis

Analyze blockchain activity and build scripts, tools, and applications that query on-chain data. All data access goes through the Blockscout MCP Server — via native MCP tool calls, the MCP REST API, or both.

Infrastructure

Blockscout MCP Server

The server is the sole runtime data source. It is multichain — almost all tools accept a chain_id parameter. Use get_chains_list to discover supported chains. Always pass its query parameter — a case-insensitive substring match by chain name, ecosystem, or native currency — so the call returns only the relevant chains instead of the full registry. Fall back to a no-argument call only when a query returns no matches.

Access method	URL	Use case
Native MCP	`https://mcp.blockscout.com/mcp`	Direct tool calls from the agent
REST API	`https://mcp.blockscout.com/v1/{tool_name}?params`	HTTP GET calls from scripts

Response format equivalence: Native MCP tool calls and REST API calls to the same tool return identical JSON response structures. When writing scripts targeting the REST API, use native MCP tool calls to probe and validate the expected response shape.

Available tools (16): unlock_blockchain_analysis, get_chains_list, get_address_info, get_address_by_ens_name, get_tokens_by_address, nft_tokens_by_address, get_transactions_by_address, get_token_transfers_by_address, get_block_info, get_block_number, get_transaction_info, get_contract_abi, inspect_contract_code, read_contract, lookup_token_by_symbol, direct_api_call.

Dedicated MCP tools return LLM-friendly, enriched responses (pre-filtered, with guidance for next steps). The exception is direct_api_call, which proxies raw Blockscout API responses without optimization or filtering. direct_api_call enforces a 100,000-character response size limit (413 error when exceeded). Native MCP calls strictly enforce this limit. REST API callers can bypass it with the X-Blockscout-Allow-Large-Response: true header — but scripts using this bypass must still apply response transformation.

Read the full file on GitHub · 301 lines

Files

What ships with it

22 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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.

7d ago First seen · 301 lines · 131 tokens per session scan A 61b1d0879e78

Subscribe to this mod's changes

blockscout-analysis is a skill published in the GitHub repository blockscout/agent-skills (35 stars, last pushed 2mo ago), licensed MIT. It adds 131 tokens to every session and 6,451 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Web3 and blockchain

signature-replay

Signature replay attacks — missing nonces, missing chain ID, ecrecover zero address, signature malleability, cross-chain replay.

PurpleAILAB/Decepticon · 31 tokens

official-sui-skills

Pointer to the official Mysten Labs skills for building on Sui — language fundamentals, object model, PTBs, SDKs, publishing, upgrades, frontend integration, accessing on-chain data. Maintained upstream at github.com/MystenLabs/skills; pinned to the same ref the audit catalog derives from (see…

MystenLabs/sui · 116 tokens

crypto-market-rank

Crypto market rankings and leaderboards. Query trending tokens, top searched tokens, Binance Alpha tokens, tokenized stocks, social hype sentiment ranks, smart money inflow token rankings, top meme token rankings from Pulse launchpad, and top trader PnL leaderboards. Use this skill when users ask about token rankings…

tradecatlabs/tradecat-public · 85 tokens

trading-signal

Subscribe and retrieve on-chain Smart Money signals. Monitor trading activities of smart money addresses, including buy/sell signals, trigger price, current price, max gain, and exit rate. Use this skill when users are looking for investment opportunities — smart money signals can serve as valuable references for…

tradecatlabs/tradecat-public · 64 tokens