# Blur API MCP > Blur NFT Trading Marketplace API MCP lets you analyze and transact digital assets directly through your AI agent. Get real-time floor prices, pull deep collection metadata, and execute bids or listings without leaving your chat window. Use this tool to manage your Web3 portfolio and make instant trading decisions. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** nft-trading, ethereum, floor-price, crypto-assets, marketplace-api ## Description Managing a crypto portfolio means constantly cross-referencing data: checking current market stats for an entire collection, comparing real-time floor prices across different marketplaces, and tracking specific asset metadata. This MCP connects all that functionality from Blur right into your workflow. You tell your AI client what you need—for instance, 'What's the total volume and supply for Azuki?' or 'Place a bid on this specific Pudgy Penguin.' The tool fetches the necessary data and performs the actions using natural language instructions. It lets you treat market research and trade execution as one continuous conversation. When you connect it via Vinkius, your AI agent gains access to Blur's depth of data, turning complex spreadsheet work into simple prompts. ## Tools ### create_ask Sets up a listing (ask) for an NFT on Blur. ### create_bid Places a bid, either on a specific token or an entire collection. ### get_asset Retrieves all metadata and current listing information for one NFT. ### get_collection_floor Finds the current minimum floor price across major marketplaces for a collection. ### get_collection Gathers detailed statistics and metadata about an entire NFT collection. ## Prompt Examples **Prompt:** ``` What is the current floor price for 'boredapeyachtclub' on all marketplaces? ``` **Response:** ``` I've checked the floor prices for Bored Ape Yacht Club. On Blur, the floor is currently 12.5 ETH, while on OpenSea it's 12.6 ETH. Would you like to see more details for this collection? ``` **Prompt:** ``` Get the metadata and listings for Pudgy Penguins token ID 500. ``` **Response:** ``` Fetching asset details... Pudgy Penguin #500 is currently listed on Blur for 15.2 ETH. It has traits like 'Kimono' and 'Crown'. Would you like to place a bid on this item? ``` **Prompt:** ``` Show me the total volume and supply for the 'azuki' collection. ``` **Response:** ``` The Azuki collection has a total supply of 10,000 tokens and an all-time volume of approximately 650,000 ETH. The current floor price is 5.8 ETH. Do you need information on specific tokens in this collection? ``` ## Capabilities ### Track collection metrics Retrieve overall statistics and metadata for an entire NFT collection. ### Check live floor prices Get the current minimum selling price for a specific collection across major markets. ### Inspect single assets Pull detailed metadata, token history, and current listing status for one unique NFT. ### Place market bids Create a bid on an asset or entire collection to secure a purchase. ### List assets for sale Set up a new listing (ask) for your NFT on the marketplace. ## Use Cases ### Determining market entry points A trader asks their agent, 'What is the current floor price for Azuki and what are its total supply stats?' The agent uses get_collection_floor and get_collection to give a quick comparative answer, helping the user decide if it's worth bidding on. ### Listing an asset quickly A user needs to sell their NFT. They prompt: 'List Pudgy Penguin #500 as an ask for 15 ETH.' The agent uses create_ask, and the listing goes live without any manual steps. ### Analyzing a target collection A data analyst needs background on a new project. They prompt: 'Get metadata and stats for this collection.' The agent runs get_collection, providing volume history and total supply numbers immediately. ### Making an immediate counter-offer After reviewing the listing details of an asset using get_asset, a buyer asks the agent to place a bid. The agent uses create_bid instantly, securing the potential purchase. ## Benefits - Stop jumping between browser tabs. You can check floor prices using get_collection_floor and immediately pull deep collection stats using get_collection—all in one chat session. - Execute trades directly from your workflow. Instead of manually navigating to the listing page, use create_bid or create_ask to place a bid or list an asset with simple natural language commands. - Get comprehensive data on single assets. The get_asset tool pulls all necessary metadata and current market listings for any NFT you specify. - Speed up analysis. If you need the total volume and supply, use get_collection to pull that raw data directly into your analytical output without exporting files. - Manage risk better. You can monitor a collection's floor price (get_collection_floor) before committing to an investment or listing. ## How It Works The bottom line is, your agent handles all the complex calls and returns clear answers about the NFT market. 1. Subscribe to this MCP and input your necessary Blur API Key. 2. Your AI client uses natural language instructions to determine which data point or action you need. 3. The tool executes the request, returning structured market data or confirming the trade action. ## Frequently Asked Questions **How do I get the floor price for an NFT collection using the Blur API MCP?** You use the get_collection_floor tool. Simply ask your agent to 'Get the current floor prices' for a collection slug, and it pulls the live minimum selling price across major marketplaces. **Can I check if an NFT is listed using the Blur API MCP?** Yes, run get_asset. This tool retrieves all metadata and current listings for a specific NFT, telling you exactly who has it listed and for how much. **Do I need to manually input my API key with the Blur API MCP?** Yes, during setup, you must subscribe to this MCP and provide your valid Blur API Key so your agent can authenticate trades and data requests. **Which tool do I use to sell my NFT on Blur?** You use create_ask. This function is designed specifically to set up a new listing for an asset you own, making it visible to buyers. **Does the Blur API MCP track collection statistics and volume?** Yes, get_collection provides detailed metadata and stats for any given collection, including total supply and historical market volume metrics.