# Alchemy MCP for AI Agents MCP

> Alchemy MCP lets your AI client audit and analyze any blockchain data—from wallet balances to NFT ownership and complex transaction histories. Instead of navigating block explorers, you ask your agent questions, and it instantly queries Ethereum and compatible networks for real-time asset intelligence.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Tags:** web3, rpc-querying, nft-data, wallet-tracking, blockchain-infrastructure, transaction-history

## Description

Blockchain analysis used to mean endless clicking through web interfaces. You'd copy addresses, paste them into a dozen different tabs, and piece together the puzzle yourself. This MCP changes that. It lets you talk to your data instead of digging through it.

With this connector, your AI agent acts as an instant Web3 analyst. You can ask complex questions—like 'Show me all assets owned by these addresses' or 'Did this specific smart contract interaction succeed?'—and get immediate, actionable answers. Your agent pulls real-time data on native currency holdings, ERC-20 tokens, and full NFT portfolios across multiple networks.

When you connect to the Vinkius catalog, your AI client gains access to this intelligence layer. You don't need to know RPC querying; you just need to ask a question. It’s about making blockchain data conversational.

## Tools

### check_api_status
Confirms if the Alchemy service connection is currently working and operational for querying data.

### get_wallet_balance
Retrieves the current native currency balance (in wei) for any specified Ethereum address.

### get_latest_block_number
Returns the number of the most recent block published on the network.

### get_owned_nfts
Lists all Non-Fungible Tokens owned by a specific wallet address.

### get_token_balances
Gets the balance of every ERC-20 token associated with an address.

### get_transaction_receipt
Provides a full, detailed receipt for any specific transaction using its unique hash.

## Prompt Examples

**Prompt:** 
```
What's the total value of all assets for '0xabc...'?
```

**Response:** 
```
**💰 Wallet Summary Report**

*   **ETH Balance:** 12.5 ETH (Current Value: $4,875)
*   **ERC-20 Tokens:**
    *   USDC: 5,000 USDC ($5,000)
    *   AAVE: 20 AAVE ($320)
*   **NFTs Owned:** 6 (Total Collection Value Estimate: $15,000+)

*Analysis Complete.* The wallet holds a strong diversified portfolio across native tokens and major assets.
```

**Prompt:** 
```
Show me all the NFTs owned by this address.
```

**Response:** 
```
**💎 NFT Portfolio Dump**

Found 7 unique digital assets:

*   🖼️ Art Blocks Genesis #14 (Metadata Link: /art/genesis-14)
*   🐒 Bored Ape Yacht Club #9021
*   👾 CryptoPunk #5678
*   ... and 4 others.

Need the full metadata for any of these collections? Just ask.
```

**Prompt:** 
```
What happened with transaction hash 0x...?
```

**Response:** 
```
**✅ Transaction Audit: Success**

| Detail | Value |
| :--- | :--- |
| **Status:** | Successful |
| **From:** | 0xabc... |
| **To:** | smart-contract-xyz.eth |
| **Value Transferred:** | 5 ETH |
| **Gas Used:** | 120,000 units |

The transaction successfully executed the contract logic and transferred funds as intended.
```

## Capabilities

### Check Token Holdings
Retrieves the native currency balance and all specific ERC-20 token balances for any given Ethereum address.

### Audit NFT Collections
Scans a specified wallet to list every unique digital asset (NFT) it owns, including collection metadata.

### Review Transaction History
Pulls the detailed receipt for any transaction hash, showing its final status and outcome on the chain.

### Track Latest Network Status
Gets the most recent block number to confirm the current state of the blockchain network.

### Monitor Service Health
Verifies whether the Alchemy service is currently operational and ready for querying.

## Use Cases

### Investigating suspicious funds transfers
A security analyst wants to know how funds moved. They ask their agent, and it uses `get_transaction_receipt` to pull the full history of a transaction hash, revealing exactly which contracts were called and if any part failed.

### Valuing an NFT portfolio
A client needs an asset summary. The agent runs three commands: `get_owned_nfts` to list the assets, then checks the overall wallet balance using `get_wallet_balance`, giving a complete picture of the user's wealth.

### Checking DeFi protocol status
A developer building a monitoring tool needs confirmation that all necessary data is available. They call `check_api_status` first, ensuring their automated workflow runs against an active endpoint before querying balances or transactions.

### Mapping token movements across addresses
A researcher wants to track a specific asset type. The agent uses `get_token_balances` for multiple related addresses in one query, mapping the flow of ERC-20 tokens and identifying potential leakage points.

## Benefits

- Audit NFT collections instantly. Instead of browsing a collection page, you can use `get_owned_nfts` to list every digital asset owned by an address in seconds.
- Consolidate all token data. Combining the results from `get_wallet_balance` and `get_token_balances` gives you a single view of total crypto exposure for any wallet.
- Understand transaction outcomes. Use `get_transaction_receipt` to verify if a complex smart contract call completed successfully or failed midway, saving hours of manual investigation.
- Stay current on the network. Running `get_latest_block_number` confirms you are operating with the most up-to-date data available across supported networks.
- Reliable data access. The ability to check API status first ensures that your deep research workflow doesn't fail because of a temporary service outage.

## How It Works

The bottom line is you get real-time, deep web3 insights without manually querying any block explorer or API endpoint.

1. Start by connecting your preferred AI client to this MCP within Vinkius.
2. Provide a clear prompt, asking your agent to perform a specific blockchain task (e.g., 'What are the token balances for address X?').
3. The agent executes the necessary queries and returns the structured data directly in your chat interface.

## Frequently Asked Questions

**How does the Alchemy MCP help me track my crypto holdings?**
It provides a single, comprehensive view of all your digital assets. You don't just see ETH; you get separate balances for every ERC-20 token and a list of owned NFTs, giving you a true picture of your portfolio value.

**Can I use the Alchemy MCP to audit smart contract interactions?**
Yes. By querying transaction receipts using this MCP, you can review the full execution details of any smart contract call. You'll see if it succeeded, failed, or transferred funds as expected.

**I need to know the latest blockchain state; how does Alchemy help?**
You simply ask your agent for the latest block number. This confirms that all data you are analyzing is based on the most current and validated state of the network, preventing stale research.

**What if I need to check balances across multiple addresses?**
The MCP lets your agent handle multiple address lookups in a single workflow. You can ask it to audit several wallets at once to compare asset distributions or track ownership changes across different parties.

**Is this suitable for developing DeFi monitoring tools?**
Absolutely. It gives developers reliable, real-time access to core blockchain data—from token movements to transaction history—making it perfect for building robust automation.