Evmscope

io.github.calintzyPublished by GitHub account calintzyv1.5.2Updated Oct 25, 2026

EVM blockchain intelligence toolkit for AI agents. 20 tools across 5 chains. Zero config.

VerifiedSTDIODesktop onlyDatabasesFinance

Overview

AI-generated overview

A local MCP server that gives an assistant read-only EVM blockchain data: token prices, gas, wallet balances, DeFi yields, swap quotes and scam-token checks.

What you can do
Look up token prices, token metadata, ENS names and labeled addresses across seven EVM chains, plus gas prices and cross-chain gas comparison, block and transaction status, decoding and simulation, and contract ABIs and event logs. Check wallet balances, full portfolios, token transfers and top token holders. Query DeFi data: protocol TVL, yield rates, swap quotes, bridge routes and governance proposals. Run safety checks such as honeypot detection and ERC-20 approval status, and read NFT balances and metadata.
When to use it
Useful when you want an assistant to answer on-chain questions or do crypto research without leaving the chat: checking a wallet, comparing gas across chains, vetting a token before interacting with it, or looking up DeFi yields and governance activity.
Requirements
Runs locally as an npm package over stdio, so Node.js and npx are needed. No API keys are required; it works on free public APIs. Optional environment variables allow custom RPC endpoints and API keys for higher rate limits.
Before you install
Read-only: it does not execute transactions, so it cannot move funds. It sends queries to third-party services such as CoinGecko, Etherscan, DefiLlama, ParaSwap, LI.FI, Honeypot.is and Snapshot, so the addresses and tokens you query go to those providers. Optional API keys are passed as environment variables. Data comes from public sources and may be stale or incomplete; honeypot and approval risk ratings are advisory only.

Installation

In SourceWeft

  1. Open Evmscope in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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?

UserUse Case
AI agent developersConnect as MCP server to give AI on-chain analysis capabilities
Crypto traders & researchersQuery tokens, wallets, and protocols directly from the terminal
DeFi usersSafety 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

bash
npx evmscope price ETHnpx evmscope gasnpx evmscope balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045npx evmscope portfolio 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045npx evmscope compare-gasnpx evmscope tvl Aavenpx evmscope swap ETH USDC 1.0npx evmscope block latestnpx evmscope transfers 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045npx 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):

bash
npx evmscope

Claude Code

bash
claude mcp add evmscope -- npx -y evmscope

Claude Desktop

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "evmscope": {      "command": "npx",      "args": ["-y", "evmscope"]    }  }}

Cursor

Add to .cursor/mcp.json:

json
{  "mcpServers": {    "evmscope": {      "command": "npx",      "args": ["-y", "evmscope"]    }  }}

Tools

getTokenPrice

Get current token price, 24h change, market cap, and volume.

json
// 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.

json
// 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.

json
// 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).

json
// 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).

json
// Input{ "nameOrAddress": "vitalik.eth" }
// Output{  "success": true,  "data": {    "name": "vitalik.eth",    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",    "avatar": "https://...",    "resolved": "name_to_address"  }}

getTxStatus

Get transaction status, receipt, confirmations, and gas usage.

json
// Input{ "txHash": "0xabc...def", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "hash": "0xabc...def",    "status": "success",    "blockNumber": 19234567,    "confirmations": 42,    "from": "0x1234...",    "to": "0x5678...",    "value": "1.5",    "gasUsed": "21000",    "effectiveGasPrice": "20.0",    "timestamp": 1741521600  }}

decodeTx

Decode a transaction into structured JSON — function name, parameters, event logs.

json
// Input{ "txHash": "0xabc...def", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "hash": "0xabc...def",    "from": "0x1234...",    "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",    "value": "1.0",    "status": "success",    "function": {      "name": "swapExactETHForTokens",      "signature": "swapExactETHForTokens(uint256,address[],address,uint256)",      "args": { "amountOutMin": "1000000", "path": ["0xC02a...", "0xA0b8..."] }    },    "events": [      { "name": "Transfer", "address": "0xA0b8...", "args": { "from": "0x...", "to": "0x...", "value": "1000000" } }    ],    "gasUsed": "150000",    "gasPrice": "20.0"  }}

getContractABI

Look up a verified contract's ABI (Etherscan → Sourcify fallback).

json
// Input{ "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "address": "0xA0b8...",    "abi": [...],    "source": "etherscan",    "contractName": "FiatTokenV2_2",    "isContract": true,    "functionCount": 42,    "eventCount": 8  }}

identifyAddress

Identify an address — exchange, DeFi protocol, whale wallet, or EOA.

json
// Input{ "address": "0x28C6c06298d514Db089934071355E5743bf21d60", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "address": "0x28C6...",    "label": "Binance Hot Wallet",    "category": "exchange",    "protocol": null,    "isContract": false,    "tags": ["cex", "binance"]  }}

compareGas

Compare gas fees across all 7 EVM chains at once, sorted by lowest cost.

json
// Input{}
// Output{  "success": true,  "data": {    "chains": [      { "chain": "base", "baseFeeGwei": "0.01", "estimatedCostUsd": 0.0001 },      { "chain": "arbitrum", "baseFeeGwei": "0.1", "estimatedCostUsd": 0.004 },      { "chain": "optimism", "baseFeeGwei": "0.05", "estimatedCostUsd": 0.002 },      { "chain": "polygon", "baseFeeGwei": "30.0", "estimatedCostUsd": 0.01 },      { "chain": "ethereum", "baseFeeGwei": "20.0", "estimatedCostUsd": 0.81 }    ],    "cheapest": "base",    "mostExpensive": "ethereum"  }}

getApprovalStatus

Check ERC-20 token approval (allowance) status. Auto-checks major DeFi protocols with risk level assessment.

json
// Input{ "owner": "0xd8dA...", "token": "USDC", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "owner": "0xd8dA...",    "token": "USDC",    "tokenAddress": "0xA0b8...",    "approvals": [      { "protocol": "Uniswap V3 (router)", "spender": "0xE592...", "allowance": "unlimited", "isUnlimited": true }    ],    "riskLevel": "moderate"  }}

getProtocolTVL

Get DeFi protocol TVL (Total Value Locked) via DefiLlama — chain breakdown, 24h/7d changes.

json
// Input{ "protocol": "Aave" }
// Output{  "success": true,  "data": {    "protocol": "Aave",    "slug": "aave",    "totalTvlUsd": 12000000000,    "change24h": 1.5,    "change7d": -3.2,    "chainBreakdown": [      { "chain": "Ethereum", "tvlUsd": 8000000000, "percentage": 66.67 },      { "chain": "Polygon", "tvlUsd": 2000000000, "percentage": 16.67 }    ]  }}

getWhaleMovements

Track large token transfers (whale movements). Classifies exchange deposit/withdrawal direction.

json
// Input{ "token": "USDC", "chain": "ethereum", "minValueUsd": 100000, "limit": 10 }
// Output{  "success": true,  "data": {    "token": "USDC",    "tokenAddress": "0xA0b8...",    "movements": [      { "txHash": "0xabc...", "from": "0x1234...", "to": "0x28C6...", "fromLabel": null, "toLabel": "Binance Hot Wallet", "value": "500000.00", "valueUsd": 500000, "direction": "exchange_deposit", "timestamp": 1710000000 }    ],    "summary": { "totalMovements": 1, "totalValueUsd": 500000, "netExchangeFlow": 500000 }  }}

getSwapQuote

Get DEX swap quotes via ParaSwap — optimal route, gas cost, auto ETH→WETH conversion.

json
// Input{ "tokenIn": "ETH", "tokenOut": "USDC", "amountIn": "1.0", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "tokenIn": { "symbol": "ETH", "address": "0xEeee...", "amount": "1.000000" },    "tokenOut": { "symbol": "USDC", "address": "0xA0b8...", "amount": "1929.200000" },    "exchangeRate": 1929.2,    "priceImpact": null,    "source": "UniswapV3",    "estimatedGasUsd": "3.50"  }}

getYieldRates

Get DeFi yield rates (APY) from DefiLlama. Filter by protocol, chain, minimum TVL.

json
// Input{ "protocol": "aave-v3", "chain": "Ethereum", "minTvl": 1000000 }
// Output{  "success": true,  "data": {    "pools": [      { "project": "aave-v3", "symbol": "USDC", "chain": "Ethereum", "apy": 5.2, "tvlUsd": 500000000, "stablecoin": true }    ],    "count": 10  }}

getContractEvents

Get contract event logs with automatic ABI decoding.

json
// Input{ "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chain": "ethereum", "limit": 5 }
// Output{  "success": true,  "data": {    "events": [      { "name": "Transfer", "args": { "from": "0x...", "to": "0x...", "value": "1000000" }, "txHash": "0x...", "blockNumber": 19234567 }    ],    "count": 5,    "fromBlock": 19233567,    "toBlock": 19234567  }}

getTokenHolders

Get top token holders. Ethereum uses Ethplorer, other chains aggregate from Etherscan transfers.

json
// Input{ "token": "USDC", "chain": "ethereum", "limit": 10 }
// Output{  "success": true,  "data": {    "token": "0xA0b8...",    "holders": [      { "address": "0x...", "balance": "1000000", "share": 15.5 }    ],    "totalHolders": 12345  }}

simulateTx

Simulate a transaction via eth_call + estimateGas. Returns gas estimate in USD and revert reason on failure.

json
// Input{ "from": "0x1234...", "to": "0x5678...", "data": "0xa9059cbb...", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "success": true,    "gasEstimate": "65000",    "gasEstimateUsd": 2.50,    "returnData": "0x0000...0001",    "error": null  }}

checkHoneypot

Detect honeypot (scam) tokens via Honeypot.is. Returns buy/sell tax, risk level, and flags.

json
// Input{ "token": "0x...", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "isHoneypot": false,    "riskLevel": "safe",    "buyTax": 0,    "sellTax": 0,    "flags": [],    "tokenName": "USD Coin",    "tokenSymbol": "USDC"  }}

getBridgeRoutes

Get cross-chain bridge routes via LI.FI. Compares fees, time, and output amount.

json
// Input{ "fromChain": "ethereum", "toChain": "arbitrum", "token": "USDC", "amount": "100" }
// Output{  "success": true,  "data": {    "routes": [      { "bridge": "Stargate", "estimatedTime": 60, "feeUsd": 0.50, "gasCostUsd": 2.10, "amountOut": "99.50", "amountOutUsd": 99.50 }    ],    "bestRoute": { "bridge": "Stargate", "..." : "..." }  }}

getNFTInfo

Get ERC-721 NFT balance and token list for a wallet.

json
// Input{ "address": "0xd8dA...", "contractAddress": "0x...", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "chain": "ethereum",    "contractAddress": "0x...",    "owner": "0xd8dA...",    "totalBalance": 3,    "nfts": [      { "tokenId": "1234", "tokenURI": "ipfs://..." }    ]  }}

getNFTMetadata

Get metadata for a specific NFT token (name, image, attributes).

json
// Input{ "contractAddress": "0x...", "tokenId": "1234", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "contractAddress": "0x...",    "tokenId": "1234",    "tokenURI": "ipfs://...",    "metadata": {      "name": "Cool NFT #1234",      "description": "A very cool NFT",      "image": "ipfs://...",      "attributes": [        { "trait_type": "Background", "value": "Blue" }      ]    }  }}

getGovernanceProposals

Get governance proposals from Snapshot (active, closed, or all).

json
// Input{ "protocol": "uniswap", "state": "active" }
// Output{  "success": true,  "data": {    "space": "uniswapgovernance.eth",    "state": "active",    "proposals": [      {        "title": "Proposal Title",        "state": "active",        "author": "0x1234...",        "start": "2025-01-01",        "end": "2025-01-07",        "votes": 1500,        "quorum": 1000,        "choices": ["For", "Against"],        "scores": [75.5, 24.5]      }    ]  }}

getBlockInfo

Block details (timestamp, gas, transactions, validator) by number or latest.

json
// Input{ "blockNumber": 19234567, "chain": "ethereum" }
// Output{  "success": true,  "data": {    "number": 19234567,    "timestamp": 1741521600,    "gasUsed": "12345678",    "gasLimit": "30000000",    "baseFeePerGas": "20.0",    "transactionCount": 150,    "miner": "0x1234..."  }}

getTokenTransfers

Recent ERC-20 token transfer history for a wallet address.

json
// Input{ "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum", "limit": 5 }
// Output{  "success": true,  "data": {    "transfers": [      { "token": "USDC", "from": "0x1234...", "to": "0xd8dA...", "value": "1000.00", "direction": "in", "txHash": "0xabc...", "timestamp": 1741521600 }    ],    "count": 5  }}

getPortfolio

Complete wallet portfolio with native + ERC-20 balances and USD values.

json
// Input{ "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chain": "ethereum" }
// Output{  "success": true,  "data": {    "address": "0xd8dA...",    "native": { "symbol": "ETH", "balance": "1.234", "valueUsd": 2382.50 },    "tokens": [      { "symbol": "USDC", "balance": "1000.00", "valueUsd": 1000.00, "percentage": 29.6 }    ],    "totalValueUsd": 3382.50  }}

Supported Chains

ChainChain IDNative Token
Ethereum1ETH
Polygon137POL
Arbitrum42161ETH
Base8453ETH
Optimism10ETH
Avalanche43114AVAX
BSC56BNB

Environment Variables (Optional)

All environment variables are optional. evmscope works without any configuration.

VariablePurposeDefault
EVMSCOPE_RPC_URLCustom RPC endpoint (all chains)Public RPC
EVMSCOPE_RPC_URL_ETHEREUMEthereum-specific RPC endpointFalls back to RPC_URL
EVMSCOPE_RPC_URL_POLYGONPolygon-specific RPC endpointFalls back to RPC_URL
EVMSCOPE_RPC_URL_ARBITRUMArbitrum-specific RPC endpointFalls back to RPC_URL
EVMSCOPE_RPC_URL_BASEBase-specific RPC endpointFalls back to RPC_URL
EVMSCOPE_RPC_URL_OPTIMISMOptimism-specific RPC endpointFalls back to RPC_URL
EVMSCOPE_RPC_URL_AVALANCHEAvalanche-specific RPC endpointFalls back to RPC_URL
EVMSCOPE_RPC_URL_BSCBSC-specific RPC endpointFalls back to RPC_URL
EVMSCOPE_COINGECKO_KEYCoinGecko API key (higher rate limits)Free tier
EVMSCOPE_ETHERSCAN_KEYEtherscan API key (higher rate limits)Free tier
EVMSCOPE_POLYGONSCAN_KEYPolygonscan API keyFalls back to ETHERSCAN_KEY
EVMSCOPE_ARBISCAN_KEYArbiscan API keyFalls back to ETHERSCAN_KEY
EVMSCOPE_BASESCAN_KEYBasescan API keyFalls back to ETHERSCAN_KEY
EVMSCOPE_OPTIMISTIC_KEYOptimistic Etherscan API keyFalls back to ETHERSCAN_KEY
EVMSCOPE_SNOWTRACE_KEYSnowtrace API key (Avalanche)Falls back to ETHERSCAN_KEY
EVMSCOPE_BSCSCAN_KEYBscScan API key (BSC)Falls back to ETHERSCAN_KEY
EVMSCOPE_ETHPLORER_KEYEthplorer API key (token holders)freekey
EVMSCOPE_LIFI_KEYLI.FI API key (bridge routes)Public access
EVMSCOPE_DEBUGEnable debug logging (set to 1)Disabled

Built-in Databases

DatabaseContents
tokens.json49 major tokens with multi-chain addresses and CoinGecko IDs
signatures.json36 common function signatures (ERC-20, DEX, lending, NFT)
labels.json30 labeled addresses (exchanges, bridges, whale wallets)
protocols.json10 DeFi protocols with multi-chain contract addresses

Roadmap

  • v0.1 (done) — 5 tools: price, transaction fees, balance, token info, ENS
  • v0.5 (done) — +4 tools: decodeTx, getTxStatus, getContractABI, identifyAddress
  • v1.0 (done) — +5 tools: compareGas, getApprovalStatus, getProtocolTVL, getWhaleMovements, getSwapQuote
  • v1.5 (done) — +6 tools: simulateTx, getYieldRates, getTokenHolders, getContractEvents, checkHoneypot, getBridgeRoutes
  • v1.5.1 (done) — Code quality + security refactoring: 7 new shared modules, per-chain RPC URLs, cache size limits, unified address validation, CLI modularization
  • v1.6.0 (done) — +3 tools: getNFTInfo, getNFTMetadata, getGovernanceProposals. +2 chains: Avalanche, BSC
  • v1.7.0 (done) — +3 tools: getBlockInfo, getTokenTransfers, getPortfolio. Security hardening (v1.6.1)

License

MIT

Source: README.md at commit 99637f2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.5.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts