# Fortnite Cosmetics MCP

> Fortnite Cosmetics & Item Shop provides deep access to the official Fortnite API database via an MCP. Your agent can instantly pull daily shop rotations, check V-Bucks pricing, audit item rarity across thousands of cosmetics, and list newly leaked or unreleased skins. This is how you keep track of every piece of in-game gear without manual effort.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** cosmetics, item-shop, market-data, inventory-tracking, gaming-economy

## Description

Need to know what's changing in the Fortnite Item Shop? Your agent handles it. Instead of checking multiple websites for daily rotations, this MCP reads directly from the official database. You can ask your AI client to list exactly what’s featured today and how much it costs in V-Bucks. Want to find an old outfit or check if a certain type of glider exists? You filter through the entire cosmetic history by rarity (Legendary, Epic) or item category (Backpack, Emote). It even flags unreleased skins found in game files—the 'leaked' stuff that hasn't hit the shop yet. By connecting this MCP via Vinkius, you give your agent professional-level auditing power over every piece of gear and data point.

## Tools

### get_cosmetic_details
Retrieves full information for a single cosmetic piece using its unique ID.

### get_new_cosmetics
Lists any cosmetics that have been added recently, including unreleased leaks.

### get_item_shop
Gets the current items listed in both the daily and featured shop sections.

### get_combined_shop
Pulls all current items available in the combined, active item shop rotation.

### list_banners
Retrieves all available profile banner icons for use or reference.

### search_cosmetics_by_rarity
Filters and finds cosmetics based on specific rarity levels like Epic or Legendary.

### search_cosmetics_by_type
Narrows down the search results by item category, such as Outfit or Emote.

### search_cosmetics
Searches the entire database for cosmetics by name, returning images and set info.

## 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 current store offerings
Pulls the full combined list of items currently available in the daily and featured shop rotations.

### Find specific cosmetic details
Retrieves complete data for any single item, including its ID, type, and description.

### Identify new or leaked items
Lists cosmetics that have recently been added to the database but may not yet be visible in the active shop rotation.

### Search by item type
Filters the massive cosmetic library to show only specific categories, like Outfits or Pickaxes.

### Filter by rarity tier
Narrows down search results based on established rarities (e.g., Legendary, Rare).

## Use Cases

### Auditing a suspected set incompleteness
A collector asks the agent: 'Show me all items in the 'Frozen Series' that are Epic rarity.' The agent uses `search_cosmetics` and then filters with `search_cosmetics_by_rarity`, generating a complete, verifiable list of missing pieces.

### Tracking an emerging seasonal trend
A content creator needs data on upcoming items. They ask the agent to check for leaks using `get_new_cosmetics`. The agent identifies three unreleased skins and provides their high-res icon URLs for immediate use in a video script.

### Verifying shop bundle availability
A user wants to know what the current maximum value of bundles is. They call `get_combined_shop` which returns all active pricing data, allowing them to instantly compare featured items against daily deals.

### Gathering assets for a client report
A gaming firm needs technical details on specific item types. The agent uses `search_cosmetics_by_type` (e.g., 'Backpack') and then uses `get_cosmetic_details` to pull the ID, rarity, and icon URL for each result.

## Benefits

- You don't have to piece together the daily shop. Use `get_item_shop` or `get_combined_shop` and get all current V-Bucks pricing and bundles in one call.
- Stay ahead of the curve by using `get_new_cosmetics`. This tool lists unreleased skins, letting you track leaks before they hit the main shop.
- Never miss a set piece. Combine searches with `search_cosmetics` (by name) and then narrow it down further using `search_cosmetics_by_rarity` to audit full collection histories.
- Need to find all your gliders? Use `search_cosmetics_by_type` to filter the massive database by category, saving you hours of manual searching.
- When reporting assets for videos, use `get_cosmetic_details`. It provides high-quality icon URLs and full technical descriptions instantly.

## How It Works

The bottom line is you give your agent the key, and it handles all the complex database queries for you.

1. Subscribe to the MCP and provide your dedicated Fortnite-API Key.
2. Connect this MCP to your preferred agent client (Claude, Cursor, etc.).
3. Ask your agent a question—like 'Show me all Legendary outfits'—and it uses the tools to pull the live data.

## Frequently Asked Questions

**How do I find out what skins are available today using get_item_shop?**
The `get_item_shop` tool pulls the current daily and featured items, giving you all active cosmetics and their prices in one go. This is your best bet for real-time shop data.

**Can I use search_cosmetics by rarity to find a specific outfit?**
Yes. You first use `search_cosmetics_by_rarity` to filter down the list to only 'Legendary' items, and then you can narrow that result set using `search_cosmetics` with partial name keywords.

**What is the difference between get_combined_shop and get_item_shop?**
`get_item_shop` focuses on the daily rotation (featured/daily). `get_combined_shop` gives you a broader, full list of all items currently active in the combined shop structure.

**How do I see cosmetic data for an item that was leaked but not sold?**
You use `get_new_cosmetics`. This tool specifically checks the database files and lists recently added or unreleased items, even if they aren't in the active shop.

**What do I need to do to authenticate my agent before using tools like `get_item_shop`?**
You must subscribe to the MCP and provide your Fortnite-API Key through the Vinkius connection settings. This key authorizes your AI client to make requests against the live data source, allowing you to run any query.

**How can I find all types of items besides outfits using `search_cosmetics_by_type`?**
You use `search_cosmetics_by_type` and pass the specific item category like 'backpack', 'pickaxe', or 'emote'. This lets you filter results precisely, giving you a complete list of cosmetic types available in the game.

**What if I only have the unique ID number for a skin, not its name? Can `get_cosmetic_details` help?**
Yes, using `get_cosmetic_details` is perfect for this. Just pass the cosmetic's unique ID, and the MCP will return all technical metadata—including descriptions, rarity, and high-resolution URLs—for that specific item.

**How do I search for items belonging to a specific seasonal set using `search_cosmetics`?**
Run `search_cosmetics` and include the known set name in your query. The resulting data will provide 'set info' for each match, letting you filter or examine every cosmetic tied together as part of one collection.

**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.