# SimpleHash MCP for AI Agents AI Agent Connect

> SimpleHash (Multi-chain NFT API). Access NFT data across 50+ chains. Query wallet holdings, metadata, collection details, and transfer history across networks like Ethereum, Polygon, and Solana in one place.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_a6jiKIAdWxE2IcN5Xc6leNrAaONvfKT7GluxprV2/ai-agent-connect
- **Tags:** nft, web3, ethereum, solana, blockchain-data

## Description

SimpleHash gives your agent a direct line to NFT data across dozens of blockchains like Ethereum, Polygon, and Solana. Instead of jumping between different block explorers or hunting for specific metadata on various websites, you can just ask your agent to pull that info for you in one go. It handles the heavy lifting of fetching high-res images, trait data, and floor prices. Whether you're trying to audit a large portfolio or figure out the history of a specific contract, this Connector brings that data into your chat or coding window. Since Vinkius hosts this in their catalog, you can get started quickly without worrying about managing multiple individual connections. It turns complex blockchain queries into simple conversations about your assets. You can check what's in a wallet, find specific items by contract, and see where assets have moved over time. This takes the friction out of data gathering, allowing you to focus on the analysis rather than the manual search. It's a way to turn messy, decentralized data into a structured view that your agent can actually use to help you make decisions. By providing a unified way to query these assets, it makes it much easier to stay on top of market moves and portfolio health.

## Tools

### get_collection_details
Get specific details about an NFT collection. It pulls descriptions and social links.

### get_collections_by_wallet
See every collection a specific wallet owns. This helps map out a user's entire portfolio.

### get_nft_details
Fetch metadata and ownership info for a single NFT. Use this to see traits and high-res images.

### get_nft_transfers_by_contract
View the full transfer history for a specific contract. It's great for auditing project movements.

### get_nft_transfers_by_wallet
Track every time an NFT moves out of or into a specific wallet. This provides a clear audit trail.

### get_nfts_by_contract
List every NFT minted under a specific smart contract. Use this to see the full scope of a project.

### get_nfts_by_wallet
Find all NFTs owned by a wallet across multiple chains. This is the fastest way to see a multi-chain portfolio.

## Prompt Examples

**Prompt:** 
```
What's in this wallet: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?
```

**Response:** 
```
I've checked that wallet across our supported chains. Here is the current inventory:

| Chain | Asset | Details |
| :--- | :--- | :--- |
| **Ethereum** | 2x Bored Ape Yacht Club | High-value assets |
| **Polygon** | 5x Gaming Assets | Active gaming items |
| **Solana** | 1x Art Piece | Unique collectible |

Would you like me to pull the specific metadata or floor prices for any of these?
```

**Prompt:** 
```
Give me the traits for BAYC #123 in contract 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.
```

**Response:** 
```
Fetching details for BAYC #123...

Here are the attributes for this NFT:
*   **Eyes:** Robot Eyes
*   **Fur:** Blue Fur
*   **Background:** Space

I also have the high-resolution image URL ready if you'd like to see it.
```

**Prompt:** 
```
Show me the history of this contract: 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d.
```

**Response:** 
```
I've pulled the transfer history for that contract. Here are the most recent movements:

*   **Transfer 1:** Moved to 0x123... (Sale on OpenSea)
*   **Transfer 2:** Moved to 0x456... (Direct Transfer)
*   **Transfer 3:** Moved to 0x789... (Sale on OpenSea)

There have been over 500 total transfers. Would you like a deeper breakdown of any specific event?
```

## Capabilities

### Pull multi-chain holdings
Get a full list of NFTs owned by a specific wallet across dozens of different blockchains.

### Fetch high-res metadata
Retrieve trait data and high-resolution image URLs for any individual NFT.

### Track transfer history
See the complete movement history for specific wallets or smart contracts.

### Audit contract mints
List every NFT minted under a specific contract to see the full scope of a project.

### Monitor collection stats
Get real-time floor prices, social links, and descriptions for NFT collections.

## Use Cases

### Multi-chain Portfolio Auditing
A trader asks for all NFTs in a wallet across 50 chains. The agent uses get_nfts_by_wallet to list them.

### Metadata Extraction for Web3 Apps
A dev needs to pull traits for a new site. The agent uses get_nft_details to get the JSON and image URLs.

### Project Movement Tracking
An analyst wants to see how many times a specific contract moved. The agent uses get_nft_transfers_by_contract.

### Floor Price Monitoring
A collector wants to know the floor price of a project. The agent uses get_collection_details for real-time data.

## Benefits

- Stop switching between block explorers. Use get_nfts_by_wallet to see everything in one place.
- Get high-res assets instantly. get_nft_details pulls images and traits for your agent to describe.
- Audit movements easily. get_nft_transfers_by_wallet tracks every transaction without manual searching.
- Analyze project scope quickly. get_nfts_by_contract shows every mint under a specific contract.
- Track market trends. get_collection_details provides floor prices and social links for easy monitoring.

## How It Works

The bottom line is you get real-time multi-chain NFT data without having to switch tabs or write custom scrapers.

1. Subscribe to the SimpleHash MCP on the Vinkius catalog.
2. Add your SimpleHash API key to your client configuration.
3. Ask your agent to pull NFT metadata, wallet holdings, or transfer history.

## Frequently Asked Questions

**Can SimpleHash MCP see NFTs on Solana?**
Yes. This Connector connects to over 50 chains, including Solana, so you can query assets across the entire ecosystem in one place.

**Does SimpleHash MCP pull high-res images?**
Yes, it retrieves high-resolution image URLs along with the metadata, making it easy for your agent to describe the assets to you.

**Can I use SimpleHash MCP to track floor prices?**
Yes. It pulls collection-level data including current floor prices, which helps you stay updated on market trends without manual searching.

**Does SimpleHash MCP support Bitcoin Ordinals?**
Yes, it includes data for Bitcoin Ordinals, allowing you to manage and query those assets alongside your other multi-chain NFTs.

**Is SimpleHash MCP good for auditing wallets?**
It is excellent for auditing. You can pull the full transfer history for any wallet to see exactly where assets have moved over time.

**How many blockchains does SimpleHash MCP support?**
It supports over 50 different chains, giving you a unified way to query data from networks like Ethereum, Polygon, Solana, and more.

**How do I check all NFTs owned by a specific wallet address?**
Use the `get_nfts_by_wallet` tool. You'll need to provide the wallet address and the chains you want to search (e.g., 'ethereum,polygon').

**Can I get the floor price of a specific NFT collection?**
Yes! The `get_collection_details` tool returns comprehensive metadata for a collection, including its current floor price on various marketplaces.

**Is it possible to see the history of an NFT's movement?**
Absolutely. You can use `get_nft_transfers_by_wallet` to see transfers involving a specific user, or `get_nft_transfers_by_contract` to see all transfers within a specific collection or contract.