Covalent MCP. Analyze token balances and transaction history across 100+ chains.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Covalent MCP Server queries unified blockchain data. Get real-time and historical data on token balances, NFTs, and transactions across 100+ chains (Ethereum, Polygon, BSC, etc.).
Your agent handles complex queries like 'Show me the total value of my portfolio and list my recent transactions.'
What your AI agents can do
Get block details
Retrieves block hashes, parent hashes, timestamps, and transaction counts for a specific block height on a given chain.
Get chains status
Checks the block height lag and sync status across all supported blockchain networks.
Get dex pools
Lists liquidity pool addresses, token pairs, and reserve amounts for a specified DEX on a chain.
Retrieve token balances and NFT counts for any wallet address across multiple supported blockchains.
Pull detailed logs and event parameters for specific transactions or list a wallet's full transaction history.
Calculate a wallet's historical portfolio value, showing daily balances and asset valuations in USD over time.
Check the current sync status and block details for any supported blockchain network.
List and analyze liquidity pool addresses, token pairs, and reserve amounts for a given Decentralized Exchange (DEX).
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019d757dget block details
Retrieves block hashes, parent hashes, timestamps, and transaction counts for a specific block height on a given chain.
019d757dget chains status
Checks the block height lag and sync status across all supported blockchain networks.
019d757dget dex pools
Lists liquidity pool addresses, token pairs, and reserve amounts for a specified DEX on a chain.
019d757dget historical portfolio
Gets the daily portfolio value and asset valuation in USD for a specified wallet address.
019d757dget nft balances
Retrieves NFT balances, token IDs, and metadata URLs for a wallet address on a blockchain network.
019d757dget token balances
Gets the current token balances for a wallet address on a specific chain, listing contract addresses and raw balances.
019d757dget token transfers
Retrieves the sender, receiver, transfer values, and timestamps for a wallet's historical token transfers.
019d757dget transaction details
Provides raw log events, decoded parameters, and gas consumption metrics for a specific transaction hash.
019d757dget transactions
Gets a list of transaction hashes, block heights, timestamps, and log events for a wallet address.
019d757dlist supported chains
Lists all blockchain networks supported by Covalent, including their IDs and supported features.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Covalent, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You wanna track assets, check out transactions, or figure out what's going on with a whole network? This Covalent MCP Server lets your agent query unified blockchain data across over 100 chains, from Ethereum and Polygon to BSC. Your agent handles the heavy lifting, so you can just talk to it and get real-time or historical data on token balances, NFTs, and transactions.
Track Asset Holdings
To get token balances, you can run get_token_balances for a wallet address on a specific chain, which gives you the contract addresses and the raw balances. For NFT counts, get_nft_balances pulls the NFT balances, token IDs, and metadata URLs for a wallet on any network. If you need a full picture of a wallet's holdings, you can also use get_token_balances and get_nft_balances.
Analyze Transaction History
Need to know what happened with a wallet? You can use get_transactions to get a list of transaction hashes, block heights, timestamps, and log events for a wallet address. For the nitty-gritty on one specific move, get_transaction_details gives you the raw log events, decoded parameters, and gas consumption metrics for a specific transaction hash.
If you just want to see where tokens moved, get_token_transfers pulls the sender, receiver, transfer values, and timestamps for a wallet's history.
Model Portfolio Performance
You can check a wallet's historical portfolio value with get_historical_portfolio, which gets the daily portfolio value and asset valuation in USD for a specified wallet address.
Network Status & Liquidity Auditing
If you wanna monitor the network, get_chains_status checks the block height lag and sync status across every supported blockchain network. To check the details of a specific block, get_block_details retrieves the block hashes, parent hashes, timestamps, and transaction counts for a given block height on a chain. You can also use list_supported_chains to see every blockchain network the server supports, along with their IDs and supported features.
If you wanna check out the liquidity on a DEX, get_dex_pools lists the liquidity pool addresses, token pairs, and reserve amounts for a specified DEX on a chain.
How Covalent MCP Works
- 1 Connect the Covalent integration to your AI client and authorize it using your Covalent API Key.
- 2 Ask your agent a natural language question (e.g., 'What were my token balances last Tuesday?').
- 3 The agent calls the relevant tool (like
get_token_balancesorget_historical_portfolio), and the result is returned to you for analysis.
The bottom line is, your agent treats global blockchain data like a database query, letting you ask complex questions without writing raw API calls.
Who Is Covalent MCP For?
The crypto analyst who needs a unified view of assets across five different chains. The web3 developer who has to audit smart contracts manually. The investment manager tracking portfolio performance for multiple clients. If you deal with anything on-chain, this saves hours of switching dashboards.
Audits smart contract interactions and verifies transaction logs by calling get_transaction_details.
Tracks portfolio performance across multiple chains by using get_historical_portfolio.
Retrieves structured on-chain data, like all token transfers or NFT metadata, for reporting via chat.
What Changes When You Connect
- See a wallet's current holdings in one place.
get_token_balancesgives you the raw token counts and contract addresses for any address on any supported chain. - Track portfolio shifts over time. Use
get_historical_portfolioto see how a wallet's total USD value changed day by day, regardless of how many tokens it holds. - Audit specific movements.
get_transaction_detailsprovides the granular log events and gas consumption metrics you need for deep smart contract analysis. - Monitor network health.
get_chains_statustells you if a chain is lagging or if the API is currently available, so you know if your data is fresh. - Discover assets.
get_nft_balanceslists every NFT a wallet owns, providing metadata links and token IDs you can use for research. - Examine flow.
get_token_transfersmaps out a wallet's history of tokens moving in and out, showing the sender, receiver, and exact amount.
Real-World Use Cases
Checking a Client's Multi-Chain Assets
A financial analyst needs to know the total worth of a client's crypto portfolio across ETH, Polygon, and BSC. They prompt their agent: 'What is the historical value and current token balance for address 0x...?' The agent runs get_historical_portfolio and get_token_balances, giving the analyst a comprehensive, single-source report.
Investigating a Failed Smart Contract Call
A web3 developer runs into an issue with a specific transaction. Instead of searching forum threads, they ask their agent to use get_transaction_details with the transaction hash. The agent returns the raw log events and gas metrics, pinpointing the exact failure point.
Tracking a Specific NFT Collection's Ownership
A collector wants to list all NFTs owned by a wallet and see their metadata. They query: 'List all NFTs for 0x...' The agent calls get_nft_balances, providing a clean list of token IDs and metadata links.
Verifying an Asset's Liquidity
A DeFi researcher needs to know the trading depth for a specific token pair. They ask the agent to run get_dex_pools for that DEX, which returns the pool's reserve amounts and volume metrics, confirming the asset's liquidity status.
The Tradeoffs
Trying to query all data in one go
Asking the agent: 'Give me everything about 0x...' This forces the agent to guess which tools are relevant, often resulting in incomplete or irrelevant data that mixes balances with pool details.
→
Break the query down. Start by asking for the core state: 'What are the current token balances for 0x...?' Then, follow up with a specific action: 'Now, what were the transfers on that wallet last week?' Use get_token_balances followed by get_token_transfers.
Using old, incomplete data
Relying on a cached report that doesn't account for recent swaps or failed transactions. The data might show a balance, but not the reason for the dip.
→
Always verify recent activity. If you see a balance change, immediately check the logs using get_transactions or get_token_transfers to see the corresponding hashes and timestamps.
Ignoring network status
Running a complex report assuming all 100+ chains are fully indexed, only to find the data is stale or incomplete because of a network lag.
→
Always check the status first. Run get_chains_status at the start of your session to confirm the indexing status and API availability across all networks.
When It Fits, When It Doesn't
Use this if you need to query a wallet's state across multiple blockchains or need granular, historical context (e.g., 'What was my balance last Tuesday?'). It's essential for quantitative research, compliance auditing, or portfolio management. Don't use it if you only need a simple, single-chain balance check, as those tools might suffice. If your problem requires knowing why a balance changed, you must use get_transaction_details or get_token_transfers. If you are analyzing market depth, you need get_dex_pools. If you only need to know which chains are available, use list_supported_chains.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Covalent. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking assets across five different dashboards is a nightmare.
Right now, checking a portfolio means jumping between MetaMask, Etherscan, Polygonscan, and then figuring out where to check the NFTs. You copy-paste wallet addresses, open ten tabs, and spend twenty minutes cross-referencing dates and balances.
With the Covalent MCP Server, you just ask your agent: 'What's the full status of 0x...' The agent pulls token balances, NFT data, and transaction history from every chain you need, and presents it in a single, structured report.
Covalent MCP Server: Get full, unified blockchain data from chat.
You don't need to run separate queries for token balances, then another for NFT holdings, and a third for transaction logs. The agent handles the sequencing—it pulls the token balances using `get_token_balances`, then cross-references that data with the asset history via `get_transactions`.
It's not just faster; it's smarter. You get a single, comprehensive view of the entire asset lifecycle, letting you focus on the insight, not the API calls.
Common Questions About Covalent MCP
How do I use the get_token_balances tool with Covalent MCP Server? +
You ask your agent to 'Show the token balances for address 0x... on Polygon.' The agent executes get_token_balances and returns the current raw and formatted token count for that specific chain.
What is the best way to check historical portfolio value using get_historical_portfolio? +
Ask your agent for 'The historical portfolio value for 0x... for the last quarter.' The tool calculates and returns the daily asset valuation in USD, allowing you to spot trends.
Can I audit a specific transaction using get_transaction_details? +
Yes. Provide the transaction hash and ask the agent to 'Get full details for this transaction.' It returns the raw log events and gas consumption metrics.
Does Covalent MCP Server support all blockchain networks? +
It supports over 100 chains. To see which ones are available, simply ask the agent to run list_supported_chains.
How do I find all NFTs owned by a wallet using get_nft_balances? +
Ask the agent: 'What are the NFT holdings for 0x...?' The agent uses get_nft_balances to list the specific NFT contract names, token IDs, and metadata links.
How can I use the `get_transactions` tool to track a wallet's activity over time? +
The get_transactions tool retrieves a full list of transaction hashes, block heights, and timestamps for a given wallet. You can then use your AI client to filter this raw data by date range or specific interaction types.
What information does `get_token_transfers` provide about token movements? +
It provides the sender and receiver addresses, the exact transfer value, and the transaction timestamp. This lets you track exactly who moved tokens, how much, and when.
If I run `get_chains_status`, what does the output tell me about network reliability? +
The output shows the block height lag and the current sync status across supported networks. This lets you quickly check if a chain is indexing correctly or if there's a connectivity issue.
How do I get a Covalent API Key? +
Log in to your Covalent dashboard at covalenthq.com and generate an API Key. You can use the free tier to get started.
Which blockchains are supported? +
Covalent supports over 100 chains including Ethereum, Polygon, BSC, Avalanche, Fantom, and many Layer 2 solutions like Arbitrum and Optimism.
Can the agent send transactions? +
No, this integration is for querying data only. It provides high-granularity visibility into on-chain activities but cannot execute writes or sign transactions.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Amiibo
Search and filter the complete Amiibo database — access figures, cards, and series data directly from any AI agent.
Fauna (Serverless DB)
Execute FQL queries directly against your Fauna serverless database from any AI agent to manage collections, documents, and indexes.
SurrealDB
Manage SurrealDB instances — execute SurrealQL, query tables, and manage records directly from any AI agent.
You might also like
Foursquare Alternative
Manage your location data — audit places, photos, and tips via AI.
AfterShip
Track packages worldwide — create, manage, and monitor shipments via AI.
Netease Yunxin / 网易云信
Massive scale RTC and IM platform — manage user accounts, chat groups, and messaging via AI.