
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.
概览
本地 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 密钥以获得更高调用限额。
安装
在 SourceWeft 中
- 打开 控制台中的 Evmscope,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
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?
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
Run npx evmscope --help to see all 22 commands. Add --json for raw JSON output.
MCP Server
Start as an MCP server (no arguments):
Claude Code
Claude Desktop
Add to claude_desktop_config.json:
Cursor
Add to .cursor/mcp.json:
Tools
getTokenPrice
Get current token price, 24h change, market cap, and volume.
getGasPrice
Get current gas prices in slow/normal/fast tiers with USD estimates.
getBalance
Get native token + ERC-20 token balances with USD values.
getTokenInfo
Get ERC-20 token metadata (name, symbol, decimals, total supply).
resolveENS
Resolve ENS names to addresses and vice versa (Ethereum mainnet only).
getTxStatus
Get transaction status, receipt, confirmations, and gas usage.
decodeTx
Decode a transaction into structured JSON — function name, parameters, event logs.
getContractABI
Look up a verified contract's ABI (Etherscan → Sourcify fallback).
identifyAddress
Identify an address — exchange, DeFi protocol, whale wallet, or EOA.
compareGas
Compare gas fees across all 7 EVM chains at once, sorted by lowest cost.
getApprovalStatus
Check ERC-20 token approval (allowance) status. Auto-checks major DeFi protocols with risk level assessment.
getProtocolTVL
Get DeFi protocol TVL (Total Value Locked) via DefiLlama — chain breakdown, 24h/7d changes.
getWhaleMovements
Track large token transfers (whale movements). Classifies exchange deposit/withdrawal direction.
getSwapQuote
Get DEX swap quotes via ParaSwap — optimal route, gas cost, auto ETH→WETH conversion.
getYieldRates
Get DeFi yield rates (APY) from DefiLlama. Filter by protocol, chain, minimum TVL.
getContractEvents
Get contract event logs with automatic ABI decoding.
getTokenHolders
Get top token holders. Ethereum uses Ethplorer, other chains aggregate from Etherscan transfers.
simulateTx
Simulate a transaction via eth_call + estimateGas. Returns gas estimate in USD and revert reason on failure.
checkHoneypot
Detect honeypot (scam) tokens via Honeypot.is. Returns buy/sell tax, risk level, and flags.
getBridgeRoutes
Get cross-chain bridge routes via LI.FI. Compares fees, time, and output amount.
getNFTInfo
Get ERC-721 NFT balance and token list for a wallet.
getNFTMetadata
Get metadata for a specific NFT token (name, image, attributes).
getGovernanceProposals
Get governance proposals from Snapshot (active, closed, or all).
getBlockInfo
Block details (timestamp, gas, transactions, validator) by number or latest.
getTokenTransfers
Recent ERC-20 token transfer history for a wallet address.
getPortfolio
Complete wallet portfolio with native + ERC-20 balances and USD values.
Supported Chains
Environment Variables (Optional)
All environment variables are optional. evmscope works without any configuration.
Built-in Databases
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
来源:README.md,提交 99637f2
工具
0版本历史
1- v1.5.2最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分