# DeBank MCP for AI Agents AI Agent Connect > DeBank MCP connects your DeFi portfolio data to your AI agent. It pulls real-time balances, protocol positions, and token history across multiple chains. Instead of jumping between block explorers and dashboards, you can just ask your agent for a summary of your holdings, check gas prices, or audit your token authorizations. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_CfCF0g5WtiFZxWMG9UmtirGurhQoXVrN1ytgj8kr/ai-agent-connect - **Tags:** defi, wallet-tracker, portfolio-management, web3, on-chain-data ## Description Managing a DeFi portfolio usually means juggling a dozen tabs. You're constantly switching between different block explorers, checking gas prices on one chain, and trying to remember which protocols you actually have positions in. It's a lot of manual clicking just to see where your money is. This Connector changes that by bringing all that on-chain data directly into your chat interface. You can ask your agent to summarize your total balance across all chains or find out exactly how much you have in a specific lending pool. It handles the heavy lifting of querying complex protocol lists and fetching historical price data so you don't have to. Since Vinkius makes it easy to manage these connections in one place, you can get these insights running in minutes. It turns your AI into a dedicated crypto analyst that knows your history and your current exposure. ## Tools ### get_protocol Get information about a specific DeFi protocol. This is useful for checking the details of a lending or trading platform. ### get_token_history_price Fetch the historical price data for a specific token. Use this to see how an asset has performed over time. ### get_token Retrieve detailed information about a specific token. This gives you the basics of any on-chain asset. ### get_user_all_complex_protocol_list See every complex protocol position a user holds across all chains. This gives a full view of your multi-chain DeFi exposure. ### get_user_complex_protocol_list See complex protocol positions for a user on a single chain. This helps narrow down your exposure on a specific network. ### get_user_history_list View the full history of transactions for a specific user. Use this to audit past movements on the blockchain. ### get_user_nft_authorized_list See every NFT that has been granted authorization by a user. This is a key step for managing wallet permissions. ### get_user_protocol_positions Get a list of all current protocol positions for a user. Use this to see where your capital is currently deployed. ### get_user_token_authorized_list See all tokens that have been granted authorization by a user. Use this to check which dApps can spend your funds. ### get_user_token_list List all tokens held by a specific user. This gives you a quick inventory of your current holdings. ### get_user_used_chain_list See which chains a user has interacted with. This helps you identify where your activity is most concentrated. ### list_all_protocols Get a list of every protocol supported on all chains. Use this to discover new DeFi options. ### list_app_protocols Get a list of protocol information for a specific application. Use this to see which protocols are integrated with a dApp. ### list_chains See the full list of supported blockchain chains. This helps you understand the scope of the data available. ### list_protocols Get a list of protocol information for a specific area. Use this to filter protocols by category or use case. ### list_tokens_by_ids Get a list of token information based on specific IDs. This is useful for batch-querying multiple assets. ### pre_exec_tx Run a transaction pre-execution to see the estimated outcome. This lets you see what will happen before you sign. ### explain_tx Get a plain English explanation of what a specific transaction did. This removes the guesswork from reading hex data. ### get_account_units Check the usage of your API account units. Use this to monitor your data usage limits. ### get_chain Get the specific details and information for a blockchain chain. This provides context for a specific network. ### get_gas_market Check the current gas prices for different networks. Use this to time your transactions for the best price. ### get_pool Get detailed information about a specific liquidity pool. This is helpful for analyzing DEX positions. ### get_token_top_holders Identify the largest holders of a specific token. Use this to see the concentration of a token's supply. ### get_user_total_balance Get the total balance of a user's wallet across all chains. This provides a single view of your entire portfolio. ## Prompt Examples **Prompt:** ``` What's my total balance across all chains? ``` **Response:** ``` I've analyzed your wallet holdings across all connected networks. Here is your current summary: | Network | Total Balance (USD) | Primary Holdings | | :--- | :--- | :--- | | Ethereum | $45,230.50 | USDC, WETH | | Polygon | $12,400.00 | AAVE, MATIC | | Arbitrum | $8,150.25 | OP, GMX | **Total Portfolio Value: $65,780.75** Would you like to see a detailed token breakdown for any of these networks? ``` **Prompt:** ``` Explain this transaction: 0x123... (example) ``` **Response:** ``` I've analyzed that transaction for you. Here is what happened: * **Action:** Token Swap * **From:** 1.5 ETH * **To:** 3,200 USDC * **Protocol:** Uniswap V3 * **Status:** Success * **Gas Spent:** 0.0045 ETH Basically, you swapped your Ethereum for USDC on Uniswap. The transaction went through successfully with a standard gas fee. ``` **Prompt:** ``` Who owns the most of token 0x... (example)? ``` **Response:** ``` I've pulled the holder data for that token. Here are the top 5 holders (excluding known smart contracts): 1. **Wallet A...92**: 12.5% of supply 2. **Wallet B...12**: 8.2% of supply 3. **Wallet C...44**: 5.1% of supply 4. **Wallet D...01**: 4.8% of supply 5. **Wallet E...88**: 3.2% of supply Would you like me to check for any other tokens or analyze the distribution of a different asset? ``` ## Capabilities ### Get total balances across all chains See your entire portfolio value and token holdings in one summary. ### Fetch token history and price data Get historical price points and details for any specific asset. ### Identify top holders for any specific asset See who owns the largest portions of a token's supply. ### Explain complex on-chain transactions Get a human-readable breakdown of what a specific transaction actually did. ### List all authorized token and NFT permissions Audit which dApps or contracts have permission to interact with your wallet. ### Check real-time gas market prices See current network fees across different blockchains instantly. ### List all protocols on a specific chain Get a full list of supported DeFi protocols for a specific network. ## Use Cases ### Checking a portfolio summary A trader asks for their total balance and used chains to see where their capital is deployed without opening five different apps. ### Security auditing A user wants to know which tokens have permission to spend their funds and uses the authorized list tool to audit their wallet. ### Transaction debugging A developer wants to know what a specific contract interaction did and uses the transaction explanation tool to get a plain English summary. ### Protocol research A researcher asks for a list of all protocols on Polygon to compare lending options and see which ones are currently supported. ## Benefits - Stop jumping between block explorers. Use get_user_total_balance to see your entire portfolio in one glance. - Understand complex swaps easily. Use explain_tx to get a human-readable breakdown of any on-chain movement. - Audit your security quickly. Use get_user_token_authorized_list to see which dApps have permission to move your assets. - Predict transaction results. Use pre_exec_tx to see what will happen before you actually sign a transaction. - Research token distribution. Use get_token_top_holders to see who owns the majority of a specific asset. - Monitor network costs. Use get_gas_market to keep an eye on fees across different blockchain networks. ## How It Works The bottom line is you get a real-time DeFi dashboard powered by natural language instead of manual dashboard clicking. 1. Subscribe to the DeBank MCP on Vinkius. 2. Enter your DeBank Cloud Access Key in the configuration. 3. Start asking your AI client about your wallet balances or protocol positions. ## Frequently Asked Questions **Can the DeBank MCP show my balances on multiple chains?** Yes, it aggregates your balances across all supported chains so you can see your total portfolio value in one place. **How does the DeBank MCP help with DeFi security?** You can use it to audit your wallet by listing all authorized tokens and NFTs, showing you exactly which dApps have permission to interact with your assets. **Can I use the DeBank MCP to check gas prices?** Yes, it can pull real-time gas market data for various networks, helping you time your transactions for the best possible price. **What kind of DeFi protocols can the DeBank MCP track?** It can track a wide range of protocols across various chains, including lending platforms, DEXs, and other complex DeFi structures. **Can I see my transaction history with the DeBank MCP?** Yes, you can query your user history to see past movements and get plain English explanations for specific transactions. **How do I connect my DeBank data to my AI agent?** You just need to subscribe to the Connector on Vinkius and provide your DeBank Cloud Access Key to get started. **Can I check the total balance of a specific wallet address across all chains?** Yes! Use the `get_user_total_balance` tool with the wallet address. The agent will return the total USD value aggregated across all supported blockchain networks. **How do I see which DeFi protocols a user has active positions in?** You can use `get_user_protocol_positions` to see detailed positions for a specific protocol, or `get_user_all_complex_protocol_list` to get a comprehensive view of all DeFi interactions for that wallet. **Is it possible to monitor current gas prices on different networks?** Absolutely. Use the `get_gas_market` tool to retrieve real-time gas price data for various chains, helping you optimize your transaction timing.