# Covalent MCP for AI Agents MCP

> Covalent gives your AI agent access to unified blockchain data. It lets you query real-time and historical information—including token balances, NFT metadata, transactions, and block status—across more than 100 supported chains in a single conversation.

## Overview
- **Category:** databases
- **Price:** Free
- **Tags:** web3, blockchain-data, nft, wallet-tracking, token-balances, api-query

## Description

Working with decentralized finance or Web3 means dealing with endless, disparate datasets across dozens of blockchains. Covalent solves that headache by providing one unified API for all your blockchain needs. You can talk to it using natural language and get answers about wallets, tokens, and smart contracts without ever needing to write complex queries. Whether you're checking a portfolio value or auditing transaction logs, this MCP surfaces the data in plain English. You connect Covalent through Vinkius, giving any compatible AI client immediate access to global blockchain intelligence. It’s built for anyone who needs real-time visibility into anything happening on-chain.

## Tools

### get_token_balances
Gets the current and raw token balances for a specific wallet address on any connected blockchain.

### get_block_details
Retrieves technical details, including block hashes and timestamps, for a specified block height on a chain.

### get_chains_status
Checks the indexing status of all supported blockchains to ensure data is current and available.

### get_dex_pools
Lists liquidity pools for a given Decentralized Exchange (DEX), showing token pairs and reserve amounts.

### get_nft_balances
Retrieves the count and metadata links for Non-Fungible Tokens held by a wallet address.

### get_historical_portfolio
Calculates the daily portfolio value in USD for a wallet, providing an overview of historical asset changes.

### get_token_transfers
Pulls a history of token transfers, detailing sender/receiver addresses and transfer values over time.

### get_transaction_details
Gathers raw log events and decoded parameters for a specific transaction hash to deep-dive into activity.

### get_transactions
Fetches the full, time-stamped history of transactions associated with a wallet address on a chain.

### list_supported_chains
Lists all blockchain networks that Covalent currently monitors and supports for data querying.

## Prompt Examples

**Prompt:** 
```
Show me my token holdings for 0x123... on Polygon.
```

**Response:** 
```
**Wallet Token Summary: 🟢**

*   **ETH:** 0.5 (Value: $1,800)
*   **USDC:** 5,000 (Value: $5,000)
*   **MATIC:** 12,000 (Value: $1,200)

Total Estimated Value: **$8,000**.

Would you like to see the historical value trend for this wallet?
```

**Prompt:** 
```
What were my transfers last week?
```

**Response:** 
```
**Transaction History (Last 7 Days)**

| Date | Type | From Address | To Address | Amount |
| :--- | :--- | :--- | :--- | :--- |
| Jun 10 | Transfer | Wallet A | Exchange X | 5 ETH |
| Jun 12 | Withdrawal | Wallet A | DeFi Protocol | 3,000 USDC |

*Analysis: High activity involving both exchange deposits and decentralized finance interactions.*
```

**Prompt:** 
```
How did my portfolio value change over the last quarter?
```

**Response:** 
```
**Historical Portfolio Value (USD)**

| Date | Total Asset Value |
| :--- | :--- |
| 2024-03-01 | $5,120 |
| 2024-04-01 | $6,890 |
| 2024-05-01 | $7,210 |

*The portfolio showed steady growth over the quarter. The largest gain was noted in early April.*
```

## Capabilities

### Determine current token holdings
Get a comprehensive list of all tokens and their balances held by any specified wallet address across supported chains.

### Track historical portfolio performance
Retrieve daily asset valuations in USD for a given wallet, showing how its total value changed over time.

### Audit transaction history
Pull the full list of transactions for an address, including timestamps and amounts transferred, to track activity patterns.

### Identify NFT assets
List all Non-Fungible Tokens (NFTs) held by a wallet, along with their metadata and contract details.

### Monitor network health
Check the current syncing status and block height lag across multiple supported blockchain networks.

## Use Cases

### Investigating a suspicious transfer
A user notices an unusual outgoing transaction. They ask their agent to check the `get_transaction_details` for that hash, instantly pulling raw log events and gas consumption metrics to determine if it was malicious or legitimate.

### Building a comparative market report
A researcher needs to compare NFT ownership across Ethereum and Polygon. They ask the agent to run `get_nft_balances` on both chains, getting comparable metadata lists for reporting purposes.

### Reviewing past investment performance
An investor wants to know how their seed funding performed in Q3. They use `get_historical_portfolio`, which returns a timeline of daily asset valuations, proving the exact growth trajectory over time.

### Auditing token movement patterns
A compliance officer needs to track all funds leaving an institutional wallet. Asking for `get_token_transfers` provides a clean list of every sender/receiver pair and the exact transfer value.

## Benefits

- Stop manually checking ten different block explorers. Covalent centralizes data from over 100 chains, giving your agent a single source of truth for all asset movements.
- Track portfolio value changes easily using `get_historical_portfolio`. You get daily USD valuations without having to calculate every price point yourself.
- Dive deep into activity with `get_transaction_details`. This lets you look past the summary and read the actual log events of a transaction hash.
- Monitor market liquidity by listing DEX pools using `get_dex_pools`, giving analysts instant insight into token pairs and reserve sizes.
- Quickly verify asset ownership or activity with `get_token_balances` for any wallet, making initial due diligence much faster.

## How It Works

The bottom line is that you ask a question in plain English, and Covalent translates it into complex multi-chain data retrieval.

1. Connect Covalent to your AI client through Vinkius. You'll need an API key from your Covalent dashboard.
2. Your agent receives the query (e.g., 'What was this wallet's value last month?').
3. The MCP executes the required blockchain data calls and returns structured, readable results to your AI client.

## Frequently Asked Questions

**Can Covalent help me track assets across different blockchains?**
Yes, it's built for multi-chain analysis. You can query token balances and NFT metadata from over 100 supported networks using a single conversation with your agent.

**What kind of data does Covalent provide about transactions?**
Covalent gives you full transaction history, including the raw log events and decoded parameters. This detail lets you understand exactly what happened within a smart contract call.

**Does Covalent help me track my overall portfolio value?**
Absolutely. You can use it to pull historical portfolio data, getting daily asset valuations in USD for any wallet address over time. This is crucial for performance tracking.

**Is this MCP only for Ethereum-based assets?**
No. Covalent supports a massive number of networks beyond just Ethereum, including Polygon and Binance Smart Chain. You can query data across many different blockchains.

**Can I list all the supported chains with this MCP?**
Yes, it provides a tool that lists every single blockchain network Covalent monitors, letting you know exactly where your agent can look for data.