# Fortnite Cosmetics MCP > Fortnite Cosmetics & Item Shop. This server gives your AI client deep access to the official Fortnite API. You can track daily shop rotations, audit cosmetic rarity (Legendary, Epic, etc.), and list unreleased 'leaked' skins. Use it to search the entire cosmetic database by name, type (outfit, pickaxe), or rarity tier. It's the definitive source for Fortnite item market data. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** cosmetics, item-shop, market-data, inventory-tracking, gaming-economy ## Description Your AI client connects directly to the official Fortnite API. This lets your agent check the current shop inventory, pulling the full list of items, bundles, and V-Bucks pricing from the daily and featured shop rotations. It also gives you the tools to list cosmetics that have been newly added or are appearing in leaked files, helping you track upcoming content. You can search the entire cosmetic database using keywords, getting images, rarity, and introduction dates for matches. You can narrow down the search results by item category, like outfits, pickaxes, or emotes. You can also filter the database to find cosmetics based on specific rarity tiers, such as Legendary or Epic. To pull the full metadata for any single cosmetic, just give the agent its unique ID; it pulls the rarity, description, and full details. The server lets you list all available profile banner icons and their metadata, and you can get the complete dataset of all item shop listings and available bundles. ## Tools ### get_combined_shop Retrieves the complete dataset containing all item shop listings and available bundles. ### get_cosmetic_details Fetches the full metadata record for a single cosmetic item using its unique ID. ### get_item_shop Gets the current daily and featured item shop data, updated to the latest time. ### get_new_cosmetics Lists cosmetics that have been newly added or are currently flagged as leaked items. ### list_banners Lists all available profile banner icons and their metadata. ### search_cosmetics Searches the entire cosmetic database by accepting a specific name or keyword. ### search_cosmetics_by_rarity Filters the cosmetic database to return only items belonging to a specified rarity tier. ### search_cosmetics_by_type Filters the cosmetic database to return only items belonging to a specified item type (e.g., outfit, emote). ## Prompt Examples **Prompt:** ``` Show me today's featured items in the Fortnite shop and their prices. ``` **Response:** ``` Retrieving today's shop rotation... I've identified 5 featured items including the 'Aura' skin (800 V-Bucks) and the 'Star Power' emote. I also found a new discounted bundle. Would you like the direct icon preview for these items? ``` **Prompt:** ``` Search for all items in the 'Frozen Series' and list their rarities. ``` **Response:** ``` Running the set query for 'Frozen Series'... I found 6 items including 'Frozen Love Ranger' and 'Frozen Raven'. Most items in this set are of 'Frozen' rarity. Shall I provide the detailed descriptions for each? ``` **Prompt:** ``` What are the latest leaked skins found in today's game update? ``` **Response:** ``` Inspecting latest patch leaks... I've identified 3 new unreleased skins: 'Skin Name X', 'Skin Name Y', and an upcoming crossover emote. These are not yet in the shop but appear in the database files. Would you like the high-res icon URLs? ``` ## Capabilities ### Check daily shop inventory Retrieves the full list of items, bundles, and current V-Bucks pricing available in the daily and featured shop rotations. ### Get details for a specific cosmetic Pulls the full metadata, rarity, and description for any cosmetic item when you provide its unique ID. ### List new or leaked items Retrieves a list of cosmetics that have recently been added or are currently appearing in leaked files, helping you track upcoming content. ### Search by name and metadata Searches the entire cosmetic database using keywords, returning images, rarity, and introduction dates for matches. ### Filter by rarity level Finds cosmetics across the database by filtering them based on specific rarity tiers (e.g., Legendary, Epic, Common). ### Filter by item type Narrows down search results by item category, such as outfit, pickaxe, glider, or emote. ## Use Cases ### Tracking a specific rare set A collector needs to verify if the 'Shadow Hunter' set has any common items in the current shop. They ask their agent, which runs `search_cosmetics` for 'Shadow Hunter' and then filters the results using `search_cosmetics_by_rarity` to confirm the minimum rarity level. ### Reporting on seasonal drops A content creator needs a list of everything that drops during the next event. They ask their agent to run `get_new_cosmetics` and then use `search_cosmetics_by_type` to separate out only the glider designs for a video segment. ### Comparing shop bundles A user wants to know if the current featured bundle is better value than the daily shop. They run `get_item_shop` and `get_combined_shop` to pull both datasets and compare the V-Bucks cost and item value side-by-side. ### Finding item type variations A designer needs all available emote icons for a project. They run `search_cosmetics_by_type` with 'emote' and then pass the resulting IDs to `get_cosmetic_details` to gather the high-res URLs. ## Benefits - Get real-time shop data immediately. Use `get_item_shop` to see current V-Bucks prices and bundles without guessing. - Stop guessing what's next. Call `get_new_cosmetics` to list unreleased or leaked items, keeping you ahead of seasonal announcements. - Target your search exactly. Use `search_cosmetics_by_rarity` to filter the whole catalog down to only Legendary or Epic items. - Break down the inventory. Use `search_cosmetics_by_type` to isolate only pickaxes or only emotes, ignoring everything else. - Deep dive into single items. `get_cosmetic_details` pulls every piece of metadata you need for one specific skin or item. - Audit the full picture. Running `get_combined_shop` gives you a comprehensive look at the entire item shop structure at once. ## How It Works The bottom line is, you stop manually browsing the game client and start querying the raw, structured API data directly from your chat. 1. Subscribe to the Fortnite Cosmetics & Item Shop server and provide your API Key. 2. Tell your AI client what you need—for example, 'Show me all Legendary outfits.' 3. Your agent uses the correct tool (like `search_cosmetics_by_rarity` or `search_cosmetics_by_type`) and delivers the filtered, structured data. ## Frequently Asked Questions **How do I use `search_cosmetics_by_rarity` to find items?** You tell your agent to filter by rarity. Just specify the tier you want (like 'Legendary' or 'Epic'). The tool returns all cosmetics matching that rarity across the entire database. **What is the difference between `get_item_shop` and `get_combined_shop`?** `get_item_shop` provides the most up-to-date daily and featured items. `get_combined_shop` gives a full, comprehensive dump of the entire item shop data. **Can I use `search_cosmetics_by_type` to find only outfits?** Yes. You pass 'outfit' as the type. This tool filters the database and only returns items classified as outfits, ignoring pickaxes or emotes. **Do I need `get_cosmetic_details` for every item?** No. If you just need a list of item names, `search_cosmetics` works. You only need `get_cosmetic_details` when you need the full, deep metadata object for one specific item. **How do I list leaked skins using `get_new_cosmetics`?** You simply ask the agent to run `get_new_cosmetics`. It checks the database for unreleased or newly found skins and lists them for you. **What is the function of `search_cosmetics` when I just know the name of an item?** The `search_cosmetics` tool returns images, rarity, set information, and the introduction date for a cosmetic. This lets you quickly identify an item without needing its specific ID. **How do I check if an item is in the current shop using `get_item_shop`?** `get_item_shop` retrieves the real-time daily and featured shop items. If an item is listed there, it's currently available for purchase or viewing in the shop rotation. **If I run `get_cosmetic_details` for a cosmetic, what specific metadata do I get?** The `get_cosmetic_details` tool provides comprehensive data for a specific cosmetic ID. You get full details, including technical metadata and high-quality icon URLs. **Can my AI automatically find 'Leaked' skins that haven't been released yet?** Yes! Use the `get_new_cosmetics` tool. Your agent will scan the Fortnite-API database for items added in the latest patch but not yet available in the shop, providing names and icon previews. **How do I check the last time a specific rare skin was seen in the shop?** Simply ask the agent to run the `get_cosmetic_details` tool with the item ID. It will retrieve the historical dates of availability, helping you quantify the rarity of the target skin. **Does the integration permit listing all items belonging to a specific set like the 'Frozen Series'?** Yes. The `search_cosmetics` action allows your agent to filter the entire database by official set names, ensuring you find all matching gliders, skins, and pickaxes for your collection.