A high-performance interface for onchain investigation, providing deep access to Ethereum blockchain data via the Etherscan MCP.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install etherscan-mcp-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install etherscan-mcp-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Etherscan MCP Skill?
This skill provides a streamlined interface for the Etherscan Model Context Protocol (MCP) using the uxc command-line tool. It enables developers and analysts to perform complex blockchain investigations, including address balance checks, historical token analysis, and contract source code inspection directly from their terminal or AI agent workflows. By integrating with Openclaw Skills, this tool simplifies the authentication and execution lifecycle of Ethereum data retrieval.
Users can leverage the Etherscan MCP Skill to automate data extraction for smart contract audits, security research, and decentralized finance (DeFi) analytics. The skill is designed with a help-first philosophy, ensuring users can inspect schemas and verify permissions before executing high-volume or tier-gated API calls.
Etherscan MCP Skill Use Cases
- Verifying Ethereum address balances and ERC-20 token holdings.
- Investigating transaction history and internal transfers for specific wallets.
- Analyzing token holder concentration and historical distribution.
- Retrieving smart contract ABIs and verified source code for audits.
- Checking the creation details and metadata of specific blockchain contracts.
How Etherscan MCP Skill Works
- Probe the Etherscan MCP endpoint using uxc to confirm protocol compatibility and connectivity.
- Configure bearer-token authentication using your Etherscan API key to enable authorized requests.
- Create a persistent command alias (etherscan-mcp-cli) to simplify subsequent tool execution.
- Inspect specific tool schemas (e.g., balance or tokenTopHolders) to understand required input parameters.
- Execute read-first operations to gather onchain data, followed by automated parsing of the JSON response.
Etherscan MCP Skill Setup
Ensure you have an Etherscan API key and the uxc tool installed. Follow these steps to initialize the skill within Openclaw Skills:
# Configure authentication
uxc auth credential set etherscan-mcp --auth-type bearer --secret-env ETHERSCAN_API_KEY
# Add the auth binding
uxc auth binding add --id etherscan-mcp --host mcp.etherscan.io --path-prefix /mcp --scheme https --credential etherscan-mcp --priority 100
# Link the command for easy access
uxc link etherscan-mcp-cli https://mcp.etherscan.io/mcp
Etherscan MCP Skill Data Schema & Taxonomy
The skill interacts with the Etherscan MCP endpoint, returning structured JSON envelopes. The schema focuses on predictable fields for easier integration into automated Openclaw Skills workflows.
| Field | Description |
|---|---|
| ok | Boolean indicating request success |
| kind | The type of protocol response |
| protocol | MCP versioning information |
| data | The primary payload containing blockchain records |
| error | Detailed error messaging if 'ok' is false |
Specific tools like balanceERC20 return arrays of token data, while getContractAbi provides raw ABI strings.
Etherscan MCP Skill Advanced Features
- Tier-aware handling: Dynamically detects and reports Etherscan API tier limitations such as Pro features.
- Multi-chain support: Extensible to various Etherscan-supported networks by adjusting host endpoints.
- Write-action guardrails: Built-in safety checks for operations like source code verification to prevent unintended actions.
- Schema introspection: Real-time support for the -h flag to prevent command errors as the Etherscan MCP evolves independently.
SKILL.md
Loading
Related Openclaw Skills
Dune MCP Skill
A powerful tool for AI agents to discover, query, and visualize blockchain data directly from Dune Analytics.
DeepWiki MCP Skill
A powerful tool to interact with GitHub repository documentation and get AI-grounded answers about codebases.
Context7 MCP Skill
A high-performance bridge for AI agents to query live, version-accurate documentation for virtually any software library.
CPA Update
A comprehensive maintenance tool for the CLI Proxy API designed to handle secure image upgrades, configuration changes, and robust rollback procedures.
Linear GraphQL Skill
A robust interface for AI agents to interact with Linear's GraphQL API for issue management and team collaboration.
Notion MCP Skill
A secure interface for AI agents to interact with Notion workspaces using the Model Context Protocol and UXC CLI.
Featured*
