upgrade-blockscout-api
Upgrade Blockscout API
Refresh the blockscout-analysis skill's API reference files to match the latest Blockscout backend release. The upgrade runs a 5-step sequential pipeline that downloads new swagger definitions, regenerates endpoint documentation, and applies patches.
Prerequisites
- Python >= 3.9 with
pyyamlandrequestspackages installed - Network access to GitHub API (
api.github.com,raw.githubusercontent.com) and Blockscout MCP (mcp.blockscout.com) - Working directory must be the repository root (parent of
blockscout-analysis/)
Pipeline
Run every step in order. Each step depends on the output of the previous one. If a script fails, fix the issue before proceeding to the next step.
Step 1 — Swagger Acquisition
Download swagger files for the latest Blockscout backend and Stats service releases.
More from blockscout/agent-skills
blockscout-analysis
MANDATORY — invoke this skill BEFORE making any Blockscout MCP tool calls or writing any blockchain data scripts, even when the Blockscout MCP server is already configured. Provides architectural rules, execution-strategy decisions, MCP REST API conventions for scripts, endpoint reference files, response transformation requirements, and output conventions that are not available from MCP tool descriptions alone. Use when the user asks about on-chain data, blockchain analysis, wallet balances, token transfers, contract interactions, on-chain metrics, wants to use the Blockscout API, or needs to build software that retrieves blockchain data via Blockscout. Covers all EVM chains.
25web3-dev
Build web3 applications, scripts, CLIs, bots, mobile apps, and desktop apps that need blockchain data via the Blockscout PRO API — a single HTTP API spanning 100+ EVM chains. Invoke this skill whenever the user wants to read blockchain data over HTTP (transactions, blocks, addresses, tokens, NFTs, logs, contract context, internal txs, account abstraction, etc.) and is building software that calls an API directly. Trigger on direct mentions of `Blockscout PRO API`, `pro-api`, `proapi_`, `Blockscout API`, `block explorer API`, `api.blockscout.com`, or on broader phrasing like \"build a web3 app\", \"index/query on-chain data\", \"wallet history\", \"NFT inventory\", \"transaction logs across chains\", \"how much does the Blockscout API cost\", \"chain IDs supported by Blockscout\". Use this skill for direct HTTP integrations; the sibling `blockscout-analysis` skill covers the Blockscout MCP Server.
4bump-skill-version
Bump the blockscout-analysis skill version number across all files. Use after the API reference files have been updated and you are ready to tag a new release. Pass the new version as an argument (e.g., '0.4.0').
1