# Mnemonic MCP > Mnemonic connects your AI client directly to deep NFT analytics and Web3 blockchain data. You can query specific wallet holdings, track historical transfers across collections, get real-time market stats, and inspect smart contract metadata—all through natural conversation. This lets you analyze entire portfolios without leaving your chat window. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** nft-analytics, web3-intelligence, portfolio-tracking, blockchain-data, market-cap, asset-valuation ## Description You connect your AI client directly to deep Web3 analytics and NFT data with **Mnemonic**. Forget jumping between dashboards or wading through spreadsheets. You use natural conversation—plain language, really—to pull complex blockchain info. It's built for people who need real answers about digital assets, letting you analyze massive portfolios without ever leaving your chat window. **Analyzing the Market and Collections** You can find collections by name using `search_collections`. Once you identify a collection, you get fundamental stats right away with `get_collection_details`. You'll see key statistics for an entire drop—the volume, the market cap, everything—through `get_collection_stats`. Want to know who owns what? You can calculate and get the total number of unique wallet addresses that own tokens in a specific collection using `get_collection_distribution`. Need a full itemization of every token belonging to a set? Use `list_collection_tokens`. **Tracking Assets and Ownership** To check your personal holdings, you tell it which wallet address you're looking at. Your agent will list every NFT that wallet owns using `get_wallet_nfts`, or you can pull the absolute complete record of all transactions for that wallet with `get_wallet_history`. If you need to see who currently holds a specific asset within a collection, it identifies those owners via `get_nft_owners`. You can also map out every transfer event in history—whether across an entire drop or just one token—by querying `list_transfers`, and you'll get records that let you filter by date or the token itself. If you need to know what a specific NFT is worth, it gives you current and historical pricing data using `get_nft_prices`. **Deep Dive Asset Forensics** When you focus on one single asset, `get_nft_details` provides all the comprehensive info: properties, ownership details, everything. If you're doing deep forensics on a smart contract or collection address, you can pull detailed technical metadata using `get_contract_metadata`. These tools let you peer into how the underlying code works. You also get access to all the core data needed for every NFT token—its unique properties and ownership info—through these mechanisms. This entire process lets your agent turn raw blockchain activity into actionable intelligence, giving you a full picture of any digital asset's life cycle. ## Tools ### get_collection_details Retrieves fundamental information about a specified NFT collection. ### get_collection_distribution Calculates and returns how many unique addresses own tokens within a specific collection. ### get_collection_stats Gathers key statistics for an entire NFT collection, including volume and market cap. ### get_contract_metadata Fetches detailed technical metadata for a given blockchain smart contract address. ### get_nft_details Provides comprehensive data, properties, and ownership info for a single NFT token. ### get_nft_owners Identifies all current wallet addresses that own specific NFTs within a collection. ### get_nft_prices Gets the current and historical market pricing data for any given NFT asset. ### get_wallet_history Retrieves a complete record of all transactions associated with a specific wallet address. ### get_wallet_nfts Lists every NFT token currently held by a specified wallet address. ### list_collection_tokens Retrieves an itemized list of all unique tokens belonging to a collection. ### list_transfers Queries and returns specific records of NFT transfer events, allowing filtering by time or token. ### search_collections Finds collections based on names or other search criteria provided by the user. ## Prompt Examples **Prompt:** ``` List all NFTs owned by the wallet 0x123... ``` **Response:** ``` Fetching wallet portfolio... I found 12 NFTs including 3 Bored Ape Yacht Club and 2 Art Blocks. Would you like to see the floor prices for these collections? ``` **Prompt:** ``` Search for NFT collections named 'Cool Cats'. ``` **Response:** ``` I've searched for 'Cool Cats'. I found 3 matches: the primary 'Cool Cats' collection (0x1a2b...), 'Cool Cats Kittens', and 'Cool Cats Collaborations'. Which one would you like more details on? ``` **Prompt:** ``` What is the ownership distribution for the Azuki collection? ``` **Response:** ``` Analyzing Azuki ownership... The collection has 5,400 unique owners. The top 10 holders own 15% of the total supply, indicating a highly distributed and healthy ownership base. Shall I retrieve the current floor price as well? ``` ## Capabilities ### Analyze Collection Metrics Get real-time statistics, ownership distribution, volume, and floor price for any NFT collection. ### Track Wallet Activity View all NFTs owned by a wallet address or retrieve the complete transaction history for an entire wallet. ### Inspect Asset Metadata Retrieve detailed properties, current ownership records, and technical metadata for specific tokens or smart contracts. ### Monitor Transfers Query historical transfer events across entire collections or individual assets to map asset movement over time. ## Use Cases ### Investigating an Asset Leak A collector suspects their token was sold suspiciously. They ask the agent to use `list_transfers` for that specific contract address over a date range, then cross-reference it with `get_wallet_history` on all known associated addresses. This pinpoints the exact moment and recipient of the transfer. ### Quick Portfolio Valuation A trader needs to know their current holdings' value quickly. They ask the agent, who then uses `get_wallet_nfts` to list assets, followed by `get_nft_prices` for each one, giving a total estimated worth in the chat. ### Analyzing Market Concentration A researcher wants to know if a collection is widely held. They use `get_collection_distribution`, which instantly returns the unique owner count and ownership concentration metrics for large-scale reporting. ### Building on Existing Contracts A developer needs to validate token rules before writing code. They run `get_contract_metadata` first, verifying the contract standards and properties before starting their development process using the AI agent's output. ## Benefits - See a wallet's entire history in one go. Instead of manually checking transaction logs, `get_wallet_history` delivers every move for an address immediately. - Get instant collection health checks. Use `get_collection_stats` to see volume and market cap without navigating to any third-party site. - Pinpoint asset movement. Running `list_transfers` lets you track exactly when and where a token moved, which is key for forensic analysis. - Inspect metadata on demand. When you run `get_nft_details`, you get the full technical properties of an NFT without needing to open any dedicated explorer tab. - Automate portfolio checks. With `get_wallet_nfts` and `get_nft_prices`, your agent can tell you what's in a wallet and how much it might be worth, all at once. ## How It Works The bottom line is that you use your AI client to run complex, multi-step blockchain queries without ever seeing a dashboard. 1. First, subscribe to the Mnemonic server and enter your unique API Key. 2. Next, tell your AI client exactly what you need (e.g., 'List all NFTs owned by 0x123...'). 3. The agent runs the necessary tools (`get_wallet_nfts` or `list_transfers`) and returns structured data directly in the conversation. ## Frequently Asked Questions **How do I find out what NFTs a wallet holds using get_wallet_nfts?** Just ask the agent to run `get_wallet_nfts` for the address. It will list every token owned by that wallet, giving you an immediate view of their current portfolio. **Can I track when a collection was created using get_collection_details?** Yes, `get_collection_details` provides core metadata about the collection. This includes foundational information like the contract address and initial deployment details. **What's the difference between list_transfers and get_wallet_history?** `list_transfers` focuses specifically on NFT movement events, giving you a clean record of transfers. `get_wallet_history` gives every transaction for an address, including non-NFT related activity. **How do I check the market price using get_nft_prices?** Provide the NFT's contract ID or token URI to the agent. It uses `get_nft_prices` and returns both historical data and the current floor/market value. **What is required to authenticate my client before calling tools like `get_collection_stats`?** You must use your Mnemonic API Key for authentication. The key authenticates the connection between your AI agent and our service, ensuring secure access to Web3 data. Always keep this key private; it's what allows your agent to execute queries. **Can I filter the output of `list_transfers` by a specific date range or token type?** Yes, you can apply advanced filters when calling `list_transfers`. The tool supports filtering by start and end timestamps, as well as specific contract addresses or token IDs. This lets your agent narrow massive datasets down to exactly what you need. **What happens if I send too many queries using `get_wallet_history` in a short time?** Our service implements rate limiting, so running excessive calls will result in an API error. You'll need to build retry logic into your agent workflow, incorporating exponential backoff. Wait at least 5 seconds between high-volume requests. **Does `get_nft_owners` only return the current owner, or can it provide historical ownership data?** `get_nft_owners` returns comprehensive metadata detailing all known owners and transfer records for that specific NFT. It doesn't just give you who owns it now; it maps out its entire custodial history on the blockchain. **Where do I find my Mnemonic API Key?** Log in to the Mnemonic Developer Dashboard at https://dashboard.mnemonic.dev/ to generate your API key. **Which blockchains are supported?** Mnemonic currently supports Ethereum and Polygon NFT data. **Is the pricing data real-time?** Yes, Mnemonic provides live market statistics aggregated from major NFT marketplaces.