Evmscope

io.github.calintzy由 GitHub 账号 calintzy 发布v1.5.2更新于 Oct 25, 2026

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

已验证STDIO仅桌面数据库金融

概览

AI 生成的概览

本地 MCP 服务器,为助手提供只读的 EVM 链上数据:代币价格、Gas、钱包余额、DeFi 收益、兑换报价和骗局代币检测。

可以做什么
查询七条 EVM 链上的代币价格、代币元数据、ENS 名称和已标注地址,以及 Gas 价格与跨链 Gas 对比、区块与交易状态、交易解码与模拟、合约 ABI 和事件日志。查看钱包余额、完整投资组合、代币转账记录和代币持仓大户。查询 DeFi 数据:协议 TVL、收益率、兑换报价、跨链桥路由和治理提案。执行蜜罐代币检测和 ERC-20 授权状态等安全检查,并读取 NFT 余额和元数据。
适用场景
适合让助手在对话中直接回答链上问题或做加密资产调研:查看钱包、比较各链 Gas、在交互前审查代币,或查询 DeFi 收益和治理动态。
运行要求
以 npm 包形式通过 stdio 在本地运行,需要 Node.js 和 npx。无需 API 密钥,使用免费公共 API 即可工作。可选环境变量可配置自定义 RPC 节点和 API 密钥以获得更高调用限额。
安装前请注意
只读:不执行交易,无法转移资金。查询会发送给 CoinGecko、Etherscan、DefiLlama、ParaSwap、LI.FI、Honeypot.is 和 Snapshot 等第三方服务,因此你查询的地址和代币会传给这些提供方。可选 API 密钥通过环境变量传入。数据来自公开来源,可能过时或不完整;蜜罐和授权风险评级仅供参考。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Evmscope,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源:README.md,提交 99637f2

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.5.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分