# DeBank DeFi Wallet Tracker MCP for AI Agents MCP > DeBank (DeFi Wallet Tracker) gives your AI client deep access to complex DeFi data. Track total balances, analyze specific protocol positions, monitor token history across multiple chains, and review detailed transaction movements without opening a single block explorer. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** defi, wallet-tracker, portfolio-management, web3, on-chain-data ## Description This MCP connects your AI agent directly to the vast, live data of the decentralized finance ecosystem. Instead of manually jumping between dashboards or checking five different block explorers just to get an overview, your AI client handles the heavy lifting. You can ask it to pull total balances from any address, check historical token prices, or even estimate outcomes before you execute a transfer. It lets you analyze complex protocol positions and list all supported DeFi protocols—all through natural conversation. When you connect DeBank via Vinkius, your AI acts like having a personal crypto analyst on demand. You get instant visibility into everything from gas market fluctuations to user authorization lists, turning raw blockchain data into clear, actionable insights. ## Tools ### explain_tx Provides a plain English breakdown of what happened during a specific blockchain transaction. ### get_account_units Checks the current usage and limits for API account units. ### get_chain Fetches basic information about a specific blockchain network. ### get_gas_market Retrieves the current gas prices and market data for transaction fees. ### get_pool Gets detailed information about a specific liquidity pool in DeFi. ### get_protocol Retrieves comprehensive details and metrics for a single DeFi protocol. ### get_token_history_price Fetches the historical price data for any specified token over time. ### get_token Retrieves core information, including contract details, for a specific crypto token. ### get_token_top_holders Identifies and lists the wallet addresses that hold the largest amounts of a given token. ### get_user_all_complex_protocol_list Lists all complex protocol positions held by a user across every supported chain. ### get_user_complex_protocol_list Retrieves the list of complex protocols and positions for a user on a single, specified blockchain network. ### get_user_history_list Pulls a detailed chronological list of all transactions associated with a specific wallet address. ### get_user_nft_authorized_list Lists the NFT collections and smart contracts that have been granted spending permissions by the user's wallet. ### get_user_protocol_positions Shows the current, detailed positions a user holds within various DeFi protocols. ### get_user_token_authorized_list Displays which specific tokens have been granted authorization or spending rights to external contracts by the user. ### get_user_token_list Retrieves a complete list of all token types currently held in the user's wallet. ### get_user_total_balance Calculates and returns the aggregated total fiat-equivalent balance across all assets in the specified wallet. ### get_user_used_chain_list Determines which blockchain networks a user's wallet has actively transacted on. ### list_all_protocols Retrieves an exhaustive list of all supported DeFi protocols across every connected chain. ### list_app_protocols Gets a categorized list of application-specific DeFi protocol information. ### list_chains Provides a complete, current list of all blockchains supported by the MCP. ### list_protocols Retrieves general, non-user-specific information about available DeFi protocols. ### list_tokens_by_ids Lists detailed information for multiple crypto tokens using their contract IDs. ### pre_exec_tx Simulates a transaction before execution to estimate the final outcomes, costs, and state changes. ## Prompt Examples **Prompt:** ``` What was the largest token transfer to my wallet last month and how did it affect my overall balance? ``` **Response:** ``` **Wallet Activity Summary** The biggest movement was a deposit of 50 ETH on Ethereum. This transaction, recorded on Oct 12th, increased your total balance by $80,000 USD. * **Transaction Type:** Incoming Transfer (ETH) * **Amount:** 50 ETH * **Estimated Value (Oct 12):** ~$80,000 You can see a full list of all recent deposits and withdrawals by running the history report. ``` **Prompt:** ``` I want to send funds but I need to know if there are better protocols for this token on other chains. ``` **Response:** ``` **Token Analysis: USDC** USDC is widely supported. While you're currently focused on Ethereum, here are three major alternatives/protocols running it: 1. **Polygon:** Liquidity Pool (Get pool info available) 2. **Arbitrum:** Lending Platform (Aave V3 compatible) 3. **BSC:** Top Holder Concentration (Check top holders for risk assessment) It's smart to check multiple chains before committing assets. ``` **Prompt:** ``` What is the current gas price and what are my total holdings across all networks? ``` **Response:** ``` **Live Market & Portfolio Snapshot** * **Current Gas Price (Ethereum):** 25 Gwei (Source: get_gas_market) * **Total Wallet Balance:** $1.2M USD (Includes ETH, stablecoins, and staked assets). * **Active Chains Used:** Ethereum, Polygon, Arbitrum, Optimism Everything is indexed. Need a token breakdown for any specific chain? ``` ## Capabilities ### Analyze wallet balances and usage Retrieves the total value of an address's holdings and lists all chains that have been used for transactions. ### Map protocol positions Shows complex details about a user's involvement with specific DeFi protocols, listing their current collateralized positions. ### Track token price history Fetches historical pricing data for any given token to help analyze market movement and value changes over time. ### Explain blockchain transactions Takes a transaction hash and provides plain English explanations of exactly what happened on the chain, detailing all involved contracts and actions. ### List DeFi protocols on supported chains Retrieves comprehensive lists of known DeFi applications and protocols across various blockchain networks. ### Review wallet security permissions Lists all authorized tokens or NFTs that a wallet has granted permission to other smart contracts, helping manage exposure. ## Use Cases ### Auditing all active protocol positions A researcher needs to know if a wallet is over-leveraged. They ask their agent to run get_user_all_complex_protocol_list, instantly getting a cross-chain view of every DeFi position without needing specialized dashboard access. ### Verifying transaction costs and outcomes A trader wants to send funds but isn't sure about the gas cost or if the contract will fail. They use pre_exec_tx, which simulates the swap, providing an accurate estimate of the fees and final balance before they spend any money. ### Mapping token ownership concentration A quant wants to assess market risk for a new asset. They ask the agent to run get_token_top_holders, instantly identifying the largest wallets holding that token across all networks. ### Getting an overview of wallet activity An analyst needs a quick snapshot of where funds are. They prompt for 'total balance and used chains,' triggering get_user_total_balance and get_user_used_chain_list to deliver a single, cohesive report. ## Benefits - Understand your full crypto exposure instantly. Use get_user_total_balance to see the aggregated dollar value of a wallet across all supported chains, eliminating manual summation. - Gain deep protocol insights with get_user_protocol_positions. Instead of guessing where assets are locked up, you view precise details on collateralized positions within specific DeFi apps. - Analyze market risk by checking security permissions. Run get_user_token_authorized_list to audit exactly which tokens and NFTs have granted spending rights, managing potential exposure. - Understand transaction impacts before committing funds. Use pre_exec_tx to simulate a transfer or swap and see the estimated outcomes and gas costs without risking real capital. - Benchmark asset performance historically. Run get_token_history_price anytime you need to understand how an asset's value changed, making it perfect for research reports. - Simplify complex data retrieval. Use list_all_protocols to get a full directory of every supported DeFi app, helping you map out the entire market landscape. ## How It Works The bottom line is: you tell your AI what financial insight you need, and it executes complex, multi-step queries across the entire DeFi ecosystem for you. 1. First, subscribe to this MCP and provide your DeBank Cloud Access Key. 2. Next, direct any query—like 'What are the top holders of ETH on Polygon?'—to your AI client. 3. Finally, the MCP processes the request using its specialized tools and returns structured, analyzed data directly to your chat interface. ## Frequently Asked Questions **How does the DeBank DeFi Wallet Tracker help me see my total crypto balance?** It aggregates your holdings into one single number, regardless of which blockchain network or how many different protocols you use. It gives you a unified view of your entire portfolio value in USD. **Can the DeBank DeFi Wallet Tracker track my token positions across multiple chains?** Yes, it's designed for that. You can get detailed reports on where assets are staked or locked up by running complex protocol lists across every connected chain. **Is the DeBank DeFi Wallet Tracker good for checking transaction history?** It provides a structured, readable breakdown of your entire wallet history. Instead of raw block data, you get clear explanations of what each transaction actually accomplished on-chain. **Does this MCP help me understand crypto risk and security? (DeBank DeFi Wallet Tracker)** Absolutely. You can audit your wallet's permissions by listing authorized tokens or NFTs, letting you know exactly what smart contracts have permission to spend your assets. **What if I want to analyze token price changes over time?** You simply request a historical price check for any token. The MCP fetches the necessary data so you can graph its value, making it perfect for market research or tax reporting.