# OpenSea MCP > OpenSea MCP connects your AI client directly to the world’s largest NFT marketplace, giving you real-time market intelligence and asset tracking across multiple blockchains. Use it to analyze collection statistics, track floor prices, pull full metadata for any digital collectible, and monitor wallet balances instantly. It's your single source for deep-diving into Web3 assets without leaving your chat interface. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** nft, marketplace, digital-assets, crypto-collectibles, floor-price, web3 ## Description Need to understand what’s happening in the NFT market? This MCP gives your AI agent direct access to OpenSea’s entire data set. Instead of manually jumping between tabs, dashboards, and multiple chain explorers just to figure out a collection's value or an asset's history, you simply ask your client. You can pull current trends using `get_trending_collections` or analyze specific collections by listing all traits with `get_collection_traits`. Want to know the true rarity of a piece? Use `get_nft_metadata` to retrieve every detail and link attached to an NFT. It also keeps track of wallets, letting you check account profiles and fungible token balances using `get_account` and `get_token_balances`. By connecting this MCP through Vinkius, your AI client becomes a dedicated market analyst, giving you data on ownership records, volume stats, and current listings across chains like Ethereum or Polygon. It transforms the overwhelming process of research into simple conversation. ## Tools ### cancel_order Removes an NFT listing from the marketplace before it sells. ### generate_listing_fulfillment Retrieves data needed to purchase a specific NFT listing. ### generate_offer_fulfillment Gathers the necessary information to accept an existing buyer's offer on an NFT. ### get_account Provides a summary profile and basic details for any given OpenSea account address. ### get_best_listing_nft Finds the absolute lowest price available listing for a specific NFT. ### get_best_offer_nft Identifies the highest current offer placed on a specific NFT. ### get_chains Lists every blockchain network that OpenSea supports for data queries. ### get_collection_holders Returns a list of wallet addresses that currently own items belonging to a specific collection. ### get_collection_stats Provides high-level statistics for an entire NFT collection, like total sales and volume. ### get_collection Retrieves detailed information about a specific NFT collection's rules or history. ### get_collection_traits Lists every possible trait that can exist within a given collection (e.g., 'Hat: Fedora'). ### get_drop_by_slug Gets the minting stages, supply count, and details for a specific NFT drop. ### get_drops Lists featured or upcoming batches of NFTs available in drops. ### get_nft_metadata Fetches detailed information, including image URLs and external links, associated with an NFT. ### get_nft_owners Lists every single wallet address that has ever owned a specific NFT. ### get_nft Gathers the metadata, traits, ownership history, and rarity score for one unique NFT. ### get_nfts_by_account Returns all NFTs owned by a specific wallet address. ### get_nfts_by_collection Retrieves every NFT that belongs to a specified collection ID. ### get_nfts_by_contract Lists all NFTs associated with a specific smart contract address. ### get_order Retrieves the full details of an existing marketplace order or listing. ### get_swap_quote Generates a price estimate for exchanging one cryptocurrency or token for another. ### get_token_balances Checks the quantity of fungible tokens (like USDC) held by a specific wallet address. ### get_token Retrieves the metadata and details for a specific type of fungible token. ### get_top_collections Returns a list of collections that are currently performing well in sales volume or interest. ### get_transaction_receipt Verifies the status and outcome of a recent swap, listing creation, or fulfillment action. ### get_trending_collections Identifies which NFT collections are currently experiencing rapid growth in interest and sales. ### list_collections Provides a general list of available NFT collections on the platform. ### list_events Retrieves historical records of significant marketplace events and sales activity. ### list_listings_collection_all Fetches every active listing currently available for sale within a specific collection. ### list_offers_collection_all Retrieves all current offers placed on items within a specified collection. ### post_criteria_offer Creates an offer that applies across entire collections or based on specific traits. ### post_listing Publishes a brand new NFT item listing for sale in the marketplace. ### post_offer Places a direct, specific offer on one individual NFT asset. ### post_swap_execute Generates executable transaction data needed to swap crypto assets. ### search Runs a broad search across collections, accounts, NFTs, and tokens using keywords or filters. ## Prompt Examples **Prompt:** ``` Show me the trending NFT collections on OpenSea right now. ``` **Response:** ``` I've fetched the trending collections. Currently, 'Pudgy Penguins' and 'Azuki' are seeing high activity. Would you like to see the specific stats for one of them? ``` **Prompt:** ``` Get the floor price and volume stats for the 'boredapeyachtclub' collection. ``` **Response:** ``` The Bored Ape Yacht Club currently has a floor price of 12.5 ETH with a total volume of 1.2M ETH. There have been 45 sales in the last 24 hours. ``` **Prompt:** ``` Check the profile and token balances for wallet address 0x123... ``` **Response:** ``` For wallet 0x123..., the profile name is 'CryptoCollector'. The account holds 2.5 ETH and 500 USDC. Would you like to see their NFT holdings as well? ``` ## Capabilities ### Analyze collection performance metrics You retrieve comprehensive statistics for a whole collection, including total volume and floor price. ### Inspect individual NFT data You pull detailed metadata, ownership history, and rarity traits for any specific digital asset. ### Track wallet holdings You check a wallet's profile name and current balances for both fungible tokens and NFTs it owns. ### Monitor marketplace listings and offers You list all active items in a collection or find the highest offer available on a single NFT. ### View market trends across chains You query which collections are currently trending and track data across multiple supported blockchains. ## Use Cases ### Analyzing a competitor's portfolio A client wants to know everything about a rival collector's holdings. They ask their agent to run `get_nfts_by_account` and also check the wallet's liquid assets using `get_token_balances`. The AI compiles a comprehensive report on both their NFTs and their available cash, all in one response. ### Valuing a new collection launch A developer needs to understand if a planned NFT drop is viable. They use the MCP to call `get_collection_stats` for similar existing collections and then run `get_collection_traits` to model potential trait scarcity, giving them immediate data points for their pitch. ### Following up on a major transaction You completed a swap or listing creation. Instead of waiting hours for confirmation, you immediately use `get_transaction_receipt` to check the status and confirm if the funds moved correctly or if the action failed. ### Researching asset ownership lineage A collector wants to know who originally owned a specific piece of art. They run `get_nft_owners` on the item's contract address and get a full, verifiable history of every wallet that has ever held it. ## Benefits - You get instant access to collection statistics; instead of visiting multiple dashboards, you use `get_collection_stats` to pull total volume, floor price, and sales data in one query. - Deep-dive into any asset using `get_nft_metadata`. You retrieve all the critical details—image links, external documentation, rarity scores—without copy-pasting from web pages. - Check entire wallet portfolios with tools like `get_nfts_by_account` and `get_token_balances`. Your agent compiles a full picture of assets held by an address in one go. - Track market movement using `get_trending_collections` to see what's hot right now, or use `list_offers_collection_all` to gauge demand for specific groups of items. - You can analyze supply and rarity distribution by listing collection traits with `get_collection_traits`, helping you understand the market landscape far better than manual browsing. ## How It Works The bottom line is you get market-grade intelligence on digital collectibles without leaving the chat window or needing to manage complex API calls yourself. 1. Subscribe to this MCP on Vinkius and provide your required OpenSea API Key. 2. Your AI client connects to the catalog and recognizes the available NFT tools. 3. You prompt your agent with a specific request, like 'Show me the top 5 trending collections,' and receive structured data instantly. ## Frequently Asked Questions **How do I check the price history using OpenSea MCP?** While we don't have a direct 'price history' tool, you can track trends by repeatedly calling `get_trending_collections` and reviewing the volume data over time. This allows your agent to build a rough performance graph for analysis. **Can I check if an NFT is listed using OpenSea MCP?** Yes, you can list all active items in a collection by calling `list_listings_collection_all` or check specific listings by running `get_order` and referencing the listing ID. **What is the difference between `get_nft` and `get_nft_metadata` using OpenSea MCP?** `get_nft` gives you a high-level summary, including traits and rarity. `get_nft_metadata` provides the deep dive—the actual image URLs, external links, and detailed descriptive text for that specific piece. **How do I find out if an offer is available on OpenSea MCP?** You can check two ways: use `list_offers_collection_all` to see all offers in a collection, or use `get_best_offer_nft` by providing the specific NFT ID you want to know about. **Does OpenSea MCP support multiple blockchains?** Yes. You can run `get_chains` to see every supported blockchain network, ensuring your analysis is comprehensive and not limited to a single chain.