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 分