# Zerion (DeFi Portfolio) MCP

> Zerion (DeFi Portfolio) MCP connects your agent to real-time Web3 data, letting you track total net worth and asset distribution across hundreds of protocols and multiple blockchains. It pulls complex information—including NFT values and DeFi positions—into one place so you don't have to jump between block explorers.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** defi, web3, portfolio-tracking, nft-valuation, blockchain-data, crypto-assets

## Description

Need a single source for your crypto holdings? This MCP lets your agent pull deep, real-time analytics from any Web3 wallet address. Instead of opening ten different tabs to check ETH balances, NFT values, and staking yields across multiple chains, you ask your client once. Your agent then aggregates the total net worth, maps out asset distribution (like 60% in DeFi liquidity pools, 25% in stablecoins), and pulls human-readable transaction logs for everything that's happened.

It’s built to handle complexity: it figures out individual token balances, complex DeFi positions, and the value of your NFTs. Because this involves tracking financial assets across multiple chains, data integrity matters. That’s where Vinkius helps; every call generates a cryptographically signed audit trail, meaning you know exactly what data flowed through and when. This makes analyzing multi-wallet setups reliable for serious finance work.

Your AI client acts like a personal crypto analyst, giving instant data on any wallet's health and history without you having to manually query block explorers.

## Tools

### list_chains
Lists all supported blockchains and includes relevant technical metadata.

### list_dapps
Provides metadata for decentralized applications (dApps) that interact with the wallet.

### get_fungible
Retrieves token metadata, current prices, and charts for specific fungible tokens.

### list_gas_prices
Checks current real-time estimates for gas fees across various connected chains.

### get_nft
Looks up detailed information about a single NFT using its reference ID.

### get_swap_quotes
Gets estimated pricing for swapping tokens on the same chain or bridging across different chains.

### get_wallet_nft_collections
Retrieves all NFT holdings within a wallet, grouped by the specific collection they belong to.

### get_wallet_nft_portfolio
Provides a summary of total value for NFTs held in a single wallet address.

### get_wallet_nft_positions
Lists every individual NFT token owned by the wallet, including metadata.

### get_wallet_pnl
Calculates both realized and unrealized gains (PnL) for a single wallet address.

### get_wallet_portfolio
Gets the total value and asset distribution breakdown for one specific wallet.

### get_wallet_positions
Lists all fungible tokens and DeFi positions held by a single wallet address.

### get_wallet_set_portfolio
Calculates the aggregated total value and distribution across multiple specified wallets.

### get_wallet_set_positions
Gets a consolidated list of all tokens and DeFi positions held by a group of wallets.

### get_wallet_set_transactions
Retrieves an aggregated log of transactions for multiple wallet addresses at once.

### get_wallet_transactions
Pulls a human-readable history of all on-chain activity for one specific wallet.

## Prompt Examples

**Prompt:** 
```
What is the total portfolio value and asset distribution for wallet 0x71C7656EC7ab88b098defB751B7401B5f6d8976F?
```

**Response:** 
```
I've analyzed the wallet. The total net worth is approximately $42,500. The distribution is 60% ETH, 25% USDC, and 15% in various DeFi positions like Uniswap V3 liquidity pools.
```

**Prompt:** 
```
Show me the last 5 transactions for address 0x123... and explain what happened.
```

**Response:** 
```
Fetching transaction history... In the last 5 activities: you swapped 1 ETH for 2,500 DAI on 1inch, received 500 MATIC from an external wallet, and paid gas for a minting transaction on OpenSea. Would you like details on the gas fees for these?
```

**Prompt:** 
```
What is the current PnL for wallet 0xabc... in USD?
```

**Response:** 
```
The wallet currently shows a total PnL of +$12,400. This includes $8,000 in realized gains from past sales and $4,400 in unrealized gains from your current ETH and AAVE holdings.
```

## Capabilities

### Calculate total portfolio value
Get the combined net worth and asset breakdown for one or multiple wallet addresses.

### Inspect specific DeFi positions
Examine individual token balances, liquidity pools, and complex lending arrangements within a wallet.

### Review transaction history
Retrieve easy-to-read logs of past on-chain activity for any given wallet.

### Analyze investment performance (PnL)
Calculate both realized and unrealized gains to track how an investment has performed over time.

### Map NFT holdings by collection
Summarize the total value of NFTs in a wallet, grouping them by their originating collection.

## Use Cases

### Auditing client funds
A financial analyst needs to check the total holdings for five different clients. Instead of running five separate queries, they use a single workflow calling `get_wallet_set_portfolio` and `get_wallet_set_positions`, getting all data in one go.

### Calculating investment returns
An investor wants to know if their last DeFi position was profitable. They run a check using `get_wallet_pnl` and then cross-reference the gas fees with `list_gas_prices` to account for costs.

### Building a dashboard widget
A developer needs a real-time total value feed. They use `get_wallet_portfolio` to pull the core data, and then use `get_fungible` to enrich specific token metadata for display.

### Researching cross-chain movements
A researcher wants to see if a wallet recently received funds. They check the aggregated history using `get_wallet_set_transactions` and then verify the source chain by running `list_chains`.

## Benefits

- You get a full picture of your net worth instantly. Instead of checking individual balances, calling `get_wallet_portfolio` gives you one consolidated view of the assets in any single wallet.
- Audit complex holdings easily. Use multi-address functions like `get_wallet_set_portfolio` to aggregate data from an entire group of wallets at once.
- Track performance over time. Call `get_wallet_pnl` to calculate realized and unrealized gains, letting you know exactly where your investment stands without opening a separate ledger.
- Understand every transaction. Use `get_wallet_transactions` or `get_wallet_set_transactions` to pull clean, human-readable logs of all past activity.
- Visualize NFT depth. You can get both the total value (`get_wallet_nft_portfolio`) and a detailed list of every single token using `get_wallet_nft_positions`.

## How It Works

The bottom line is you get a single, clean output of complex on-chain financial data without writing complicated query logic yourself.

1. Provide your agent with an address or a set of addresses to check.
2. The MCP connects using your API key and pulls raw data across all supported chains.
3. Your agent receives the processed, aggregated financial metrics (net worth, PnL, etc.) ready for you to read.

## Frequently Asked Questions

**How do I check the PnL for multiple wallets using get_wallet_pnl?**
You use `get_wallet_set_portfolio` (or similar set tools). This allows you to pass a list of addresses and receive calculated gains/losses for every wallet in one go.

**Can I get the NFT value using get_nft?**
The `get_nft` tool looks up specific NFTs by reference, giving you its data. For a summary of all your holdings, use `get_wallet_nft_portfolio`.

**What does list_gas_prices do for my portfolio?**
`list_gas_prices` checks the current gas cost estimates across different chains. This helps you budget and understand transaction costs before running any analysis that might involve fees.

**How do I see all token types in one place? Use get_wallet_positions.**
The `get_wallet_positions` tool provides a comprehensive list of every fungible and DeFi position associated with a single wallet address.

**How do I get the total portfolio value across multiple wallets using get_wallet_set_portfolio?**
It returns a single aggregated view of assets. You pass a list of wallet addresses to calculate the overall net worth and asset distribution for every specified account simultaneously.

**If I need an audit trail, how does get_wallet_set_transactions pull data from several addresses?**
It gathers transaction logs across all provided wallets. This is perfect for tracing movement or auditing activity across a group of related accounts in one place.

**Before I trade, how can I use get_swap_quotes to see potential cross-chain swaps?**
It provides real-time quotes for token exchanges. You specify the source and destination assets or chains, getting immediate price estimates without actually executing a transaction.

**Where can I find a list of all supported decentralized applications using list_dapps?**
It provides metadata for active dApps on various blockchains. This lets your agent understand the entire ecosystem and interact with specific smart contract functionalities.

**Can I track the total value of multiple wallets at once?**
Yes! Use the `get_wallet_set_portfolio` tool by providing a comma-separated list of addresses. The agent will return an aggregated summary of the total net worth across all specified wallets.

**Does this server show my profit and loss (PnL) for specific tokens?**
Absolutely. The `get_wallet_pnl` tool fetches both realized and unrealized gains for a wallet, allowing your AI to explain your investment performance in detail.

**Can I see the estimated value of my NFT collection?**
Yes. You can use `get_wallet_nft_portfolio` for a high-level summary or `get_wallet_nft_collections` to see your holdings grouped by their respective collections with valuation data.