# Alchemy MCP MCP

> Alchemy MCP lets your AI client audit and query complex web3 data directly through natural language. You can instantly check wallet balances for native ETH or specific ERC-20 tokens, track NFT ownership by address, and get detailed receipts for any transaction hash—all without opening a block explorer. This is deep blockchain data analysis built into your workflow.

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

## Description

Need to know what happened on the chain? You don't have time to manually copy hashes and paste them into various block explorers. This MCP changes that. It lets your AI agent act like a real-time crypto analyst, giving you direct access to decentralized ledger data.

Your agent can retrieve high-resolution balances for any address. Want to know if an NFT collection is popular? You can audit the ownership records. Need to verify a transaction's outcome? Just give it the hash. The system pulls the full receipt and status immediately. It’s all about turning complex RPC queries into simple conversation.

When you connect this MCP via Vinkius, your agent becomes a dedicated blockchain research tool. Whether you’re an investor checking portfolio value or a developer tracking smart contract events, the data is precise and up-to-the-minute.

## Tools

### check_api_status
Confirms whether the underlying Alchemy service connection is currently working.

### get_latest_block_number
Retrieves the number of the most recent block on the connected blockchain network.

### get_owned_nfts
Lists all Non-Fungible Tokens belonging to a specified wallet address.

### get_token_balances
Provides the balance for any specific ERC-20 token type linked to an address.

### get_transaction_receipt
Retrieves the complete details and status of a transaction using its unique hash ID.

### get_wallet_balance
Gets the primary currency balance (ETH) for an Ethereum address in wei units.

## Prompt Examples

**Prompt:** 
```
What is the balance of Ethereum address '0x123...' using Alchemy?
```

**Response:** 
```
I've retrieved the balance for that address! The current balance is 1.5 ETH (represented in wei). I can assist you with the ERC-20 token balances for this wallet if you'd like.
```

**Prompt:** 
```
Show all NFTs owned by '0x456...'.
```

**Response:** 
```
I've identified 5 NFTs in that wallet! Notable items include an 'Art Blocks' piece and a 'CryptoPunk'. I can provide the full token ID and collection metadata for each if you'd like.
```

**Prompt:** 
```
What is the latest block number on 'eth-mainnet'?
```

**Response:** 
```
I've retrieved the latest block number for Ethereum Mainnet! It is currently identified as block #19,250,000 (hex: 0x125B9A0). I can assist you with a specific transaction audit from this block if needed.
```

## Capabilities

### Audit wallet holdings
Retrieves current balances for both native currency (ETH) and specific ERC-20 tokens linked to an address.

### Track NFT ownership
Lists every Non-Fungible Token belonging to a specified wallet address, along with collection details.

### Inspect transaction outcomes
Provides the full status and data payload for any specific blockchain transaction hash you provide.

### Monitor network health
Checks if the connection to the underlying blockchain service is operational and gets the latest block number.

## Use Cases

### Auditing a new investor's portfolio
An analyst needs to know the total value of an address. They ask their agent, and it runs `get_wallet_balance` for ETH, then calls `get_token_balances` for all known ERC-20 tokens and finally uses `get_owned_nfts` to count digital collectibles.

### Verifying a suspicious fund transfer
A security researcher suspects an address was drained. They provide the transaction hash, and the agent immediately runs `get_transaction_receipt`, showing exactly what happened with the funds in real time.

### Checking development readiness
A developer needs to know if their data source is live before running a script. They first call `check_api_status` and then use `get_latest_block_number` to confirm the network is active and current.

### Tracking asset lifecycles
A product manager needs to map out an owner's assets. They ask about a specific wallet, and the agent uses `get_owned_nfts` combined with `get_token_balances` to provide both physical and digital inventory counts.

## Benefits

- Know the current state instantly. You can check `get_wallet_balance` to get native ETH holdings, or use `get_token_balances` to see how many specific ERC-20 tokens an address owns—all in one go.
- Keep tabs on digital assets without manual searches. The `get_owned_nfts` tool quickly lists all NFTs for a given wallet ID, giving you instant visibility into collections.
- Debugging transactions is painless. Instead of guessing what happened after a send, running the `get_transaction_receipt` tool provides the full outcome and status for any hash.
- Always know where you stand. You can check `get_latest_block_number` to ensure your data is based on the absolute latest network information.
- Automate monitoring workflows. By using these tools, you let your agent handle complex cross-functional data gathering that used to require multiple developer calls.

## How It Works

The bottom line is you stop dealing with complex API calls and just start asking questions.

1. Subscribe to this MCP, then input your required Alchemy API Key and select your target network.
2. Connect your preferred agent (Claude, Cursor, etc.) via Vinkius using the dedicated connection flow.
3. Ask your agent a question in natural language; it will run the necessary tool calls against the blockchain data.

## Frequently Asked Questions

**How do I check if my blockchain data is correct using get_api_status?**
Running `check_api_status` confirms that the connection to Alchemy is currently active and operational. If this tool fails, any other query you run will likely fail too, so check this first.

**What are the differences between get_wallet_balance and get_token_balances?**
The `get_wallet_balance` tool gets the primary currency balance (ETH) in wei. The `get_token_balances` tool is used to check balances for specific, unique ERC-20 tokens.

**How can I find out all the NFTs owned by an address using get_owned_nfts?**
You provide the wallet address, and the agent uses `get_owned_nfts` to pull a list of every NFT associated with that address. This is much faster than checking collection sites manually.

**If I have a transaction hash, which tool should I use? Should I use get_transaction_receipt?**
Use `get_transaction_receipt`. This tool takes the unique hash and pulls all associated data, giving you the full story of what happened with the funds or contract interaction.

**When I use `get_wallet_balance`, how do I interpret the raw numbers?**
The balance is returned in 'wei,' which is the smallest unit of Ether. You must divide that raw number by ten to the power of eighteen (10^18) to get the actual ETH amount. This is a common step when working with blockchain data.

**What should I do if my agent gets blocked due to too many requests?**
If your calls fail because of rate limits, check `check_api_status` first. Your workflow needs to implement an exponential backoff strategy in your client logic before retrying the failed query.

**Can I use `get_latest_block_number` for networks other than Ethereum?**
You specify the network when setting up your MCP connection. As long as it's a compatible chain supported by Alchemy, you can retrieve the most recent block number for that specific network.

**How do I use `get_transaction_receipt` if I don't know the transaction hash?**
You first need to find the transaction hash using other methods or by querying relevant data. The `get_transaction_receipt` tool requires a specific, confirmed hash to pull up the detailed receipt information.