# OpenSea MCP for AI Agents AI Agent Connect > OpenSea MCP lets your AI agent navigate the world's leading NFT marketplace directly. You can pull real-time floor prices, dig into specific token traits, and monitor wallet balances across multiple chains. It turns your agent into a dedicated market analyst that handles the heavy lifting of data retrieval, so you can focus on making informed trading decisions or building better web3 apps. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_f0Kdq3eqlExOTKFTS8ROWXhOTGWUVEuLGfBd1JhL/ai-agent-connect - **Tags:** nft, marketplace, digital-assets, crypto-collectibles, floor-price, web3 ## Description Connect OpenSea to your AI agent to navigate the NFT ecosystem without the usual friction. Instead of opening dozens of tabs to track trending projects or hunting through listings to find a specific price, you can just ask your agent to do the heavy lifting. It can pull real-time floor prices, fetch volume stats, and dig into the specific traits of any collection in seconds. Whether you're trying to see what a certain wallet is holding or looking for the latest NFT drops, this connection gives you a direct line to the marketplace data. It's one of the many tools you can find in the Vinkius catalog to turn your AI into a dedicated market researcher. You get a clear picture of the market, from rarity distributions to real-time balances, without ever having to leave your primary workspace. This makes it easy to spot trends, audit portfolios, and gather data for research projects instantly. You can move from high-level market scanning to deep-dive item analysis without any manual copy-pasting. It turns your agent into a power user of the marketplace, handling the data retrieval while you focus on the strategy. This connection also works across all the different blockchains supported by the platform, so you don't have to worry about missing out on activity on different networks. It bridges the gap between raw marketplace data and actionable insights, making it a go-to for anyone who needs to stay ahead of the curve in the digital asset space. ## Tools ### get_account Retrieve the public profile information for an OpenSea account. Use this to see the basic details of a user profile. ### list_events Access historical marketplace events and activity logs. This helps you see the history of a specific project. ### list_listings_collection_all Get a complete list of all active listings for a specific collection. Use this to see the entire current supply for sale. ### get_nfts_by_account List all the NFTs currently owned by a specific wallet address. Use this to audit a collector's portfolio. ### cancel_order Off-chain cancel an existing order on the marketplace. Use this to quickly pull a listing from the market. ### generate_listing_fulfillment Get the data required to purchase an NFT listing. This helps your agent handle the logistics of a sale. ### generate_offer_fulfillment Get the data needed to accept an offer on an NFT. This helps you move quickly when a good offer comes in. ### get_best_listing_nft Identify the lowest price currently listed for a specific NFT. This is the fastest way to check the current floor price. ### get_best_offer_nft Identify the highest current offer made on a specific NFT. It helps you understand the ceiling of the current market. ### get_chains List all the different blockchain networks supported by the OpenSea marketplace. Use this to see where the platform operates. ### get_collection_holders Retrieve a list of wallet addresses currently holding items in a specific collection. This helps identify major holders. ### get_collection_stats Fetch detailed statistics like volume and floor price for a collection. It provides a high-level view of project health. ### get_collection Pull full details about a specific NFT collection. This is your go-to for getting a general overview of a project. ### get_collection_traits List every available trait and attribute within a specific collection. Use this to see what makes a collection unique. ### get_drop_by_slug Retrieve supply, minting details, and stages for a specific NFT drop. This is useful for tracking new launches. ### get_drops List featured, upcoming, or recently minted NFT drops. Use this to keep an eye on the latest market entries. ### get_nft_metadata Get the full metadata, including image URLs and external links, for an NFT. This is essential for building front-end galleries. ### get_nft_owners List all the current owners for a specific NFT. This helps with tracking the movement of high-value assets. ### get_nft Retrieve the metadata, traits, ownership info, and rarity for a single NFT. This is the most complete way to inspect an item. ### get_nfts_by_collection Pull every NFT belonging to a specific collection. This is great for seeing the full scope of a project. ### get_nfts_by_contract Get all NFTs associated with a specific smart contract. This helps you find all items from a specific mint. ### get_order Retrieve the specific details of a marketplace order. Use this to check the status of a pending sale. ### get_swap_quote Get a current price quote for swapping one token for another. This helps you understand the current exchange rates. ### get_token_balances Check the fungible token balances for a specific wallet address. Use this to see how much of a specific token someone holds. ### get_token Get the metadata and details for a specific fungible token. This is useful for identifying different token types. ### get_top_collections Identify the most popular collections currently on the platform. Use this to see what's capturing the most attention. ### get_transaction_receipt Check the status of a recently submitted swap or fulfillment. Use this to verify that a transaction went through. ### get_trending_collections Identify the collections currently seeing the most activity. This is the quickest way to find hot projects. ### list_collections Browse a list of available collections on the marketplace. Use this to explore the variety of projects available. ### list_offers_collection_all Get a list of all active offers for a specific collection. This helps you gauge the demand for a project. ### post_criteria_offer Create an offer that applies to a specific collection or set of traits. Use this for broad bidding strategies. ### post_listing Create a new active listing for an NFT on the marketplace. This lets your agent help you put items up for sale. ### post_offer Create a specific offer on a single NFT item. Use this to make a targeted bid on a specific piece. ### post_swap_execute Get the executable transaction data required to complete a swap. This is the final step before executing a trade. ### search Search across collections, NFTs, tokens, and accounts simultaneously. Use this for broad discovery across the platform. ## Prompt Examples **Prompt:** ``` Show me the trending NFT collections on OpenSea right now. ``` **Response:** ``` I've fetched the trending collections for you. Here is what's currently seeing high activity: | Collection | Activity Level | | :--- | :--- | | **Pudgy Penguins** | High | | **Azuki** | High | Would you like me to pull the volume stats for one of these? ``` **Prompt:** ``` Get the floor price and volume stats for the 'boredapeyachtclub' collection. ``` **Response:** ``` The **Bored Ape Yacht Club** currently has the following market stats: * **Floor Price:** 12.5 ETH * **Total Volume:** 1.2M ETH * **Recent Activity:** 45 sales in the last 24 hours I can also list the current active offers for this collection if you'd like. ``` **Prompt:** ``` Check the profile and token balances for wallet address 0x123... ``` **Response:** ``` For wallet **0x123...**, here is the account summary: * **Profile Name:** CryptoCollector * **ETH Balance:** 2.5 ETH * **USDC Balance:** 500 USDC Would you like to see the specific NFT holdings for this account as well? ``` ## Capabilities ### Pull real-time floor prices Get the lowest current listing for any specific NFT instantly. ### Scan collection stats Retrieve volume, floor price, and general trends for any NFT project. ### Audit wallet balances Check the holdings and fungible token balances of any specific wallet address. ### Deep-dive into NFT traits Extract full metadata, rarity, and specific attributes for individual items. ### Monitor marketplace trends Identify the top and trending collections currently moving on the market. ### Track collection holders Generate a list of wallet addresses currently holding items in a specific collection. ## Use Cases ### Finding hot projects for a trade A trader asks their agent to find trending projects, which uses get_trending_collections and get_collection_stats to identify high-volume assets. ### Building a gallery front-end A developer uses get_nfts_by_collection to pull all items in a project and then calls get_nft_metadata to grab the image URLs for the UI. ### Auditing a whale's portfolio A collector asks the agent to check a specific wallet address using get_account and then uses get_nfts_by_account to see every NFT they own. ### Mapping trait distributions An analyst uses get_collection_traits to find all possible attributes and then uses get_collection_holders to see how many wallets own specific items. ## Benefits - Stop manual tab switching by using get_trending_collections to see what's hot on the market instantly. - Make faster trading moves with get_best_listing_nft and get_best_offer_nft for instant pricing on any item. - Audit portfolios quickly by using get_nfts_by_account to see all holdings for a specific wallet in one view. - Streamline data collection by using get_collection_traits to map out project attributes for research. - Get precise market data with get_collection_stats to see volume and floor price trends for any project. - Simplify web3 development by using get_nft_metadata to pull image URLs and links directly into your code. ## How It Works The bottom line is you get a real-time window into NFT market data without leaving your chat or editor. 1. Subscribe to the OpenSea MCP and provide your API key. 2. Connect the Connector to your preferred AI client like Claude, Cursor, or Windsurf. 3. Ask your agent to perform market research or portfolio checks. ## Frequently Asked Questions **How can I use the OpenSea MCP to track NFT floor prices?** You can ask your agent to check the floor price of any collection. It will instantly pull the lowest active listing, saving you from manually scrolling through marketplace tabs. **Can the OpenSea MCP show me what's trending in the NFT market?** Yes, it can identify the top and trending collections currently moving on the platform. Your agent can provide a summary of these projects and their current activity levels. **Is the OpenSea MCP good for auditing NFT wallets?** It is perfect for that. You can ask your agent to list all NFTs owned by a specific wallet address or check the fungible token balances of any account. **Can I use OpenSea MCP to get image URLs for a collection?** Yes, the Connector can pull full metadata for NFTs, which includes image URLs and external links. This is very helpful for developers building galleries or websites. **Does the OpenSea MCP support multiple blockchains?** Yes, it can query data across all the different blockchain networks supported by the OpenSea marketplace, giving you a broader view of the market. **Can I manage my own listings with the OpenSea MCP?** You can create new listings and manage offers through your agent. This allows you to put items up for sale or make specific bids without leaving your chat. **Can I check the floor price and volume for a specific NFT collection?** Yes! Use the `get_collection_stats` tool with the collection slug. The agent will return real-time metrics including floor price, total volume, and sales counts. **How do I retrieve the image and metadata for a specific NFT?** You can use the `get_nft_metadata` tool by providing the chain, contract address, and token ID. It returns detailed metadata including image URLs and external links. **Can I see which wallets hold the most items in a collection?** Yes, the `get_collection_holders` tool provides a list of wallet addresses that currently hold items within a specific collection slug.