# Nifty Gateway MCP > The Nifty Gateway API connects your AI agent directly to the NFT marketplace data layer. You can list all available Nifties, retrieve detailed collection metadata, and audit your personal digital art portfolio without opening a web browser. Use it to pull structured data about specific assets or browse entire collections using simple language queries. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** nft-marketplace, digital-art, web3, crypto-assets, nifty-gateway ## Description This server connects your AI agent straight into the Nifty Gateway data layer. You're not browsing a website; you’re treating the whole live marketplace like a structured database. You pull asset metadata, check inventory reports, and get details on entire collections using plain language queries. **Discovering Assets:** You can list every single collection available across the platform using `list_collections` to grab all the names and basic metadata right off the bat. Need to know what's currently for sale? You run `list_nifties`, which gives you a paginated list of literally every Nifty listed on the marketplace. This process lets you pull massive amounts of data about available assets, making sure you don’t miss any new drops. **Deep Dive Inspection:** Once you know *where* to look, you can dig into the goods. To see everything a specific artist or set has put out, use `get_collection`; this tool fetches detailed metadata and all the info for one entire collection. If you already have a Nifty's unique ID, you can get its full technical breakdown using `get_nifty`. This gives you every single attribute and detail point about that specific piece of digital art. **Checking Your Books:** Want to audit what’s in your wallet? You run `list_user_nifties` to generate an inventory report. It pulls a complete list of all the Nifty assets currently held by your connected account, letting you see exactly what digital art you own without opening up a single browser tab. **How it Works Under the Hood:** When you send a query—like asking for 'all NFT collections created in 2023'—your AI client sends that natural language request to this server. The MCP Server translates that into specific tool calls, executing them against the live marketplace data. It doesn’t give you fluff; it spits out structured JSON results back to your agent. You get clean, usable data every time. You'll use `list_collections` for a broad overview of the platform's available art genres and categories. If you narrow down your focus, `get_collection` provides all the necessary metadata when you specify one particular set. For individual piece research, `get_nifty` is what you run; it pulls every attribute linked to a single asset ID. To see everything currently on sale, remember `list_nifties`. This tool handles pagination automatically, meaning whether there are fifty listings or five thousand, you'll get the full list. And finally, for checking your personal holdings, `list_user_nifties` keeps an accurate ledger of every asset in your authenticated wallet. This setup means you don't need to manually click through pages or filter data. You just tell your agent what you want—say, 'Show me the owner and attributes for Nifty ID X'—and it executes the precise tool call (`get_nifty`) to give you the answer instantly. ## Tools ### get_collection Retrieves detailed metadata and information about one specific NFT collection. ### get_nifty Fetches all attributes and details for a single Nifty using its unique ID. ### list_collections Lists the names and metadata for every collection on the platform. ### list_nifties Retrieves a paginated list of all available NFT listings across the marketplace. ### list_user_nifties Generates an inventory report showing all Nifty assets owned by your connected account. ## Prompt Examples **Prompt:** ``` List all Nifties currently available on the platform. ``` **Response:** ``` I've retrieved the latest Nifties. There are several active listings including 'The Eternal Bloom' and 'Cyber City #402'. Would you like details on a specific one? ``` **Prompt:** ``` Get information about Nifty ID '12345'. ``` **Response:** ``` Fetching details for Nifty 12345... This is 'Neon Sunset' by Artist X. It features a vibrant 80s aesthetic and is part of the 'Retro Future' collection. ``` **Prompt:** ``` Show me the Nifties I currently own. ``` **Response:** ``` I've listed your owned Nifties. You currently have 3 assets in your wallet, including 'Golden Ticket #1' and 'Abstract Flow'. Which one should we inspect? ``` ## Capabilities ### List all NFT collections Retrieves a list of every collection available on Nifty Gateway. ### Retrieve specific collection details Fetches full metadata and information for one specified art collection. ### List all available NFTs (paginated) Pulls a paginated list of every Nifty currently listed on the platform. ### Get detailed asset metadata Retrieves full technical and descriptive data for a single, known Nifty ID. ### Audit owned NFT assets Lists all the digital art assets currently held in your authenticated wallet. ## Use Cases ### Checking portfolio value before a meeting A collector needs to quickly summarize their assets for an investment call. Instead of logging into the web UI and taking screenshots, they ask their agent: 'Show me my Nifty holdings.' The agent runs `list_user_nifties` and provides a clean list, saving time and avoiding manual copy-pasting. ### Tracking a specific art series An analyst is researching the 'Retro Future' aesthetic. They use their agent to run `get_collection('retro_future')` multiple times across different IDs, compiling all necessary metadata points into one comprehensive report for later analysis. ### Finding the latest market drops A developer wants to build a front-end dashboard showing new listings. They use `list_nifties` with pagination enabled via their agent, pulling hundreds of records programmatically instead of manually scraping the public listing pages. ### Verifying asset details for compliance A user needs to verify the exact artist and attributes of an asset ID they found. They ask the agent to run `get_nifty('xyz123')`. The agent immediately returns a data payload confirming the owner, artist, and collection name. ## Benefits - **Full Inventory Audit:** Use `list_user_nifties` to get a complete report of your owned assets instantly. You don't have to click through a dashboard; the data is presented right where you are working. - **Market Discovery on Demand:** The `list_nifties` tool gives you paginated access to every available listing, making it simple to find rare drops or browse entire categories without leaving your chat interface. - **Deep Metadata Inspection:** Need to know if a piece is part of the 'Cyber City' series? Run `get_collection` or `get_nifty` with the ID. You get all the attributes and artist data you need, structured for immediate use. - **Structured Data Output:** Every tool returns clean, machine-readable JSON payloads. This means your agent doesn't just give you a summary; it gives you raw data ready to be piped into other scripts or databases. - **Centralized Market View:** `list_collections` lets you map out the entire landscape of available digital art series with one simple query, giving you a clear view of market segments. ## How It Works The bottom line is, you get live, structured NFT marketplace data without writing a single API call or leaving your chat window. 1. Subscribe to this server on Vinkius and enter your Nifty Gateway API Key. 2. Your AI client sends a request (e.g., 'List all collections'). 3. The MCP Server runs the appropriate tool function and returns structured data to your agent. ## Frequently Asked Questions **How do I list all available Nifty assets using the list_nifties tool?** Run `list_nifties` via your agent. This function supports pagination, so it pulls a large set of records, allowing you to query deep into current market listings. **What data does get_collection provide for an NFT collection?** It gives full metadata about the entire collection, including its name, artist, and defining attributes. This is better than just viewing the public landing page. **Does list_user_nifties show my purchase history?** No. `list_user_nifties` shows what assets are currently owned in your authenticated wallet, but it doesn't provide a historical transaction log or audit trail. **Which tool should I use to check an asset by its ID?** Use `get_nifty(ID)`. This is the most direct way to pull all technical and descriptive metadata for one specific Nifty, assuming you have the unique identifier. **How do I use list_collections to find out which collections are available on the platform?** You run `list_collections` to get a comprehensive directory of all existing NFT collections. The tool returns basic metadata for every collection, including its name and unique identifier so you know what's available. **What happens if I use get_nifty with an invalid Nifty ID?** If the provided Nifty ID is bad or doesn't exist, `get_nifty` returns a specific error code and message. This tells your agent immediately that the asset lookup failed, so you don't waste time on bogus IDs. **Does list_user_nifties require special authentication or API keys?** Yes, `list_user_nifties` requires your authenticated Nifty Gateway API Key to run. The tool uses this key to confirm ownership and pull only the assets tied to your wallet. **What is the pagination mechanism when I call list_nifties?** The `list_nifties` tool supports pagination, meaning it doesn't dump thousands of results at once. It returns a cursor or next page token that you pass back to the tool to fetch the subsequent batch of listings. **Can I see the specific details of an NFT if I have its ID?** Yes! Use the `get_nifty` tool with the unique Nifty ID. Your agent will return detailed metadata, artist information, and current attributes associated with that specific asset. **How do I check which NFTs I currently own on Nifty Gateway?** Simply ask the agent to run the `list_user_nifties` action. It will retrieve a complete list of all digital assets currently held in your authenticated Nifty Gateway account. **Can I browse entire collections or drops instead of individual items?** Yes, you can use `list_collections` to see all available collections on the platform, or `get_collection` with a specific ID to see the contents and details of a particular drop.