Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EVMSCOPE_DEBUG | No | Enable debug logging (set to '1'). Default: Disabled | |
| EVMSCOPE_RPC_URL | No | Custom RPC endpoint (all chains). Default: Public RPC | |
| EVMSCOPE_LIFI_KEY | No | LI.FI API key (bridge routes). Default: Public access | |
| EVMSCOPE_ARBISCAN_KEY | No | Arbiscan API key. Falls back to ETHERSCAN_KEY | |
| EVMSCOPE_BASESCAN_KEY | No | Basescan API key. Falls back to ETHERSCAN_KEY | |
| EVMSCOPE_RPC_URL_BASE | No | Base-specific RPC endpoint. Falls back to RPC_URL | |
| EVMSCOPE_COINGECKO_KEY | No | CoinGecko API key (higher rate limits). Default: Free tier | |
| EVMSCOPE_ETHERSCAN_KEY | No | Etherscan API key (higher rate limits). Default: Free tier | |
| EVMSCOPE_ETHPLORER_KEY | No | Ethplorer API key (token holders) | freekey |
| EVMSCOPE_OPTIMISTIC_KEY | No | Optimistic Etherscan API key. Falls back to ETHERSCAN_KEY | |
| EVMSCOPE_POLYGONSCAN_KEY | No | Polygonscan API key. Falls back to ETHERSCAN_KEY | |
| EVMSCOPE_RPC_URL_POLYGON | No | Polygon-specific RPC endpoint. Falls back to RPC_URL | |
| EVMSCOPE_RPC_URL_ARBITRUM | No | Arbitrum-specific RPC endpoint. Falls back to RPC_URL | |
| EVMSCOPE_RPC_URL_ETHEREUM | No | Ethereum-specific RPC endpoint. Falls back to RPC_URL | |
| EVMSCOPE_RPC_URL_OPTIMISM | No | Optimism-specific RPC endpoint. Falls back to RPC_URL |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| getTokenPrice | 토큰의 현재 가격(USD)과 24시간 변동률, 시가총액, 거래량을 조회합니다 |
| getGasPrice | 현재 가스비를 slow/normal/fast 3단계로 조회합니다 (Gwei + USD 예상 비용) |
| getBalance | 지갑 주소의 네이티브 토큰 + ERC-20 토큰 잔고를 조회합니다 (USD 환산 포함) |
| getTokenInfo | ERC-20 토큰의 메타데이터(이름, 심볼, 소수점, 총공급량)를 조회합니다 |
| resolveENS | ENS 이름 ↔ 이더리움 주소를 양방향으로 해석합니다 (Ethereum mainnet 전용) |
| getTxStatus | 트랜잭션 상태를 조회합니다 (pending/success/failed, confirmations, gas 사용량) |
| decodeTx | 트랜잭션을 구조화된 JSON으로 해석합니다 (함수명, 파라미터, 이벤트 로그, 가스 정보) |
| getContractABI | 컨트랙트 ABI를 조회합니다 (Etherscan → Sourcify 폴백, verified contract 필요) |
| identifyAddress | 주소를 식별합니다 (거래소, DeFi 프로토콜, 고래 지갑, 컨트랙트/EOA 분류) |
| compareGas | 5개 EVM 체인의 가스비를 한 번에 비교합니다 (최저가 순 정렬, USD 예상 비용 포함) |
| getApprovalStatus | ERC-20 토큰 승인(allowance) 상태를 조회합니다. 주요 프로토콜 자동 체크, 리스크 레벨 판정 |
| getProtocolTVL | DeFi 프로토콜의 TVL(Total Value Locked)을 조회합니다 (DefiLlama 기반, 체인별 분포, 24h/7d 변동률) |
| getWhaleMovements | 대규모 토큰 전송(고래 이동)을 추적합니다. 거래소 입출금 방향 판정, 요약 통계 포함 |
| getSwapQuote | DEX 스왑 견적을 조회합니다 (ParaSwap 기반, 최적 경로, 가스비 포함, ETH→WETH 자동 치환) |
| getYieldRates | DeFi 수익률(APY)을 조회합니다 (DefiLlama 기반, 프로토콜/체인별 필터, TVL 기준 상위 10개 풀) |
| getContractEvents | 컨트랙트 이벤트 로그를 조회합니다 (ABI 자동 디코딩, 최근 1000블록 기본, 블록 범위 지정 가능) |
| getTokenHolders | 토큰의 상위 홀더를 조회합니다 (Ethereum: Ethplorer, 기타 체인: Etherscan 집계, 주소/점유율/잔고) |
| simulateTx | 트랜잭션을 시뮬레이션합니다 (eth_call + estimateGas, 가스비 USD 환산, revert reason 디코딩) |
| checkHoneypot | 토큰의 허니팟(사기) 여부를 탐지합니다 (매수/매도 세금, 위험도, 플래그, Honeypot.is 기반) |
| getBridgeRoutes | 크로스체인 브릿지 경로를 조회합니다 (LI.FI 기반, 비용/시간/경로 비교, 최적 경로 추천) |
| getNFTInfo | 특정 컨트랙트에서 지갑 주소가 보유한 ERC-721 NFT 목록과 tokenURI를 조회합니다 |
| getNFTMetadata | ERC-721 NFT의 메타데이터(이름, 설명, 이미지, 속성)를 조회합니다. IPFS URI 자동 변환 지원 |
| getGovernanceProposals | Snapshot 기반 DeFi 프로토콜 거버넌스 프로포절을 조회합니다 (상태 필터, 투표 결과 포함) |
| getTokenTransfers | 지갑 주소의 최근 ERC-20 토큰 전송 내역(입금/출금, 토큰명, 수량)을 조회합니다 |
| getPortfolio | 지갑의 전체 자산 포트폴리오(네이티브 + ERC-20 토큰, USD 가치, 비율)를 한 번에 조회합니다 |
| getBlockInfo | 블록 번호 또는 'latest'로 블록 상세 정보(타임스탬프, 트랜잭션 수, gas 사용량, 검증자)를 조회합니다 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |