Add it to Claude Code
claude mcp add evmscope -- npx -y evmscopeMake your agent remember this setup
evmscope's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Access to 26 on-chain tools including price, gas, balances, and DeFi yields
- Support for 7 EVM chains: Ethereum, Polygon, Arbitrum, Base, Optimism, Avalanche, and BSC
- Zero configuration required with no API keys needed
- Read-only access ensuring zero risk of fund loss
- Dual mode operation as a CLI tool or an MCP server for AI agents
Tools 5
getTokenPriceGet current token price, 24h change, market cap, and volume.getGasPriceGet current gas prices in slow/normal/fast tiers with USD estimates.getBalanceGet native token and ERC-20 token balances with USD values.getTokenInfoGet ERC-20 token metadata including name, symbol, decimals, and total supply.resolveENSResolve ENS names to addresses and vice versa.Try it
Original README from calintzy/evmscope
evmscope
한국어 | 中文 | 日本語 | Español | Русский
EVM blockchain intelligence toolkit. 26 tools across 7 chains — use as a CLI or MCP server. Token prices, gas comparison, swap quotes, yield rates, honeypot detection, bridge routes, tx simulation, NFT lookup, governance proposals, portfolio tracking, and more.
Why evmscope?
AI agents like Claude and GPT cannot access real-time blockchain data. Ask "What's the ETH price?" or "Show me this wallet's balance" and you'll get "I can't access real-time data."
evmscope solves this by giving AI agents direct access to 26 on-chain tools via the MCP protocol — token prices, wallet balances, DeFi yields, whale tracking, honeypot detection, and more. No API keys, no setup, just connect and go.
Who is it for?
| User | Use Case |
|---|---|
| AI agent developers | Connect as MCP server to give AI on-chain analysis capabilities |
| Crypto traders & researchers | Query tokens, wallets, and protocols directly from the terminal |
| DeFi users | Safety tools — honeypot detection, approval status checks, whale tracking |
Features
- 26 tools — Price, gas compare, swap quote, yield rates, honeypot detection, bridge routes, tx simulation, event logs, token holders, approval status, TVL, whale tracking, balance, token info, ENS, tx status, tx decode, ABI lookup, address ID, NFT info, NFT metadata, governance proposals, block info, token transfers, portfolio
- 7 EVM chains — Ethereum, Polygon, Arbitrum, Base, Optimism, Avalanche, BSC
- 49 built-in tokens — ETH, USDC, USDT, WETH, LINK, UNI, AAVE, ARB, OP, PEPE, and more
- 30+ labeled addresses — Exchanges, DeFi protocols, bridges, whale wallets
- Zero config — No API keys required. Works out of the box with free public APIs
- Read-only — No transaction execution. Zero risk of fund loss
- Dual mode — CLI for direct terminal use, MCP server for AI agent integration
Quick Start
CLI
npx evmscope price ETH
npx evmscope gas
npx evmscope balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
npx evmscope portfolio 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
npx evmscope compare-gas
npx evmscope tvl Aave
npx evmscope swap ETH USDC 1.0
npx evmscope block latest
npx evmscope transfers 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
npx evmscope honeypot 0x...
Run npx evmscope --help to see all 22 commands. Add --json for raw JSON output.
MCP Server
Start as an MCP server (no arguments):
npx evmscope
Claude Code
claude mcp add evmscope -- npx -y evmscope
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"evmscope": {
"command": "npx",
"args": ["-y", "evmscope"]
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"evmscope": {
"command": "npx",
"args": ["-y", "evmscope"]
}
}
}
Tools
getTokenPrice
Get current token price, 24h change, market cap, and volume.
// Input
{ "token": "ETH", "chain": "ethereum" }
// Output
{
"success": true,
"data": {
"symbol": "ETH",
"name": "Ethereum",
"priceUsd": 1929.20,
"change24h": -2.34,
"marketCap": 232000000000,
"volume24h": 12500000000
}
}
getGasPrice
Get current gas prices in slow/normal/fast tiers with USD estimates.
// Input
{ "chain": "ethereum" }
// Output
{
"success": true,
"data": {
"slow": { "maxFeePerGas": "18.5", "maxPriorityFeePerGas": "1.2", "estimatedCostUsd": 0.75 },
"normal": { "maxFeePerGas": "20.0", "maxPriorityFeePerGas": "1.5", "estimatedCostUsd": 0.81 },
"fast": { "maxFeePerGas": "22.5", "maxPriorityFeePerGas": "2.25", "estimatedCostUsd": 0.91 },
"baseFee": "17.3",
"lastBlock": 19234567
}
}
getBalance
Get native token + ERC-20 token balances with USD values.
// Input
{ "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum" }
// Output
{
"success": true,
"data": {
"address": "0xd8dA...",
"nativeBalance": { "symbol": "ETH", "balanceFormatted": "1.234", "valueUsd": 2382.50 },
"tokenBalances": [
{ "symbol": "USDC", "balanceFormatted": "1.0", "valueUsd": 1.00 }
],
"totalValueUsd": 2383.50
}
}
getTokenInfo
Get ERC-20 token metadata (name, symbol, decimals, total supply).
// Input
{ "token": "USDC", "chain": "ethereum" }
// Output
{
"success": true,
"data": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"name": "USD Coin",
"symbol": "USDC",
"decimals": 6,
"totalSupply": "26000000000"
}
}
resolveENS
Resolve ENS names to addresses and vice versa (Ethereum mainnet only).
// Input
{ "nameOrAddress": "vitalik.eth" }
// Output
{
"success": true,
"data": {
"name": "vitalik.eth",
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"avatar"