# Roblox Catalog Intelligence MCP

> Roblox Avatar & Catalog Intelligence provides deep data access to the Roblox marketplace. Your AI agent can audit item prices, search the entire catalog for specific assets, analyze user inventories, and track limited resale history—all from a single connection.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** virtual-economy, marketplace, asset-management, pricing-data, inventory-tracking

## Description

Your AI agent gives you deep access right into the Roblox Catalog, letting you pull market data and inventory details without doing a million manual searches. You can't just look at pictures; your agent handles the whole heavy lifting for you.

If you need to find specific assets in the Avatar Shop, run `search_avatar_catalog`. This lets you search across all items while letting you filter by category and sort results exactly how you wanna see 'em. It's a targeted look at thousands of clothing and accessories.

When you know an item ID, use `get_catalog_item_details` to grab the full metadata for that asset. You get everything there: the price point, the description, creator details, and current stock status. If you need high-resolution pictures of one or more assets, just call `get_asset_thumbnails`. 

For looking at completed looks, if you have an avatar bundle ID, `get_avatar_bundle_details` returns a specific item list and all the metadata for that entire grouping. Wanna see accessories or clothing that match what's already there? Use `get_bundle_recommendations`; it finds bundles stylistically similar to the input. 

When you're dealing with limited items, tracking is everything. You can use `get_limited_resale_data` to calculate the historical resale price data for any limited asset so you know its market value over time. To see who’s moving inventory right now, run `get_limited_resellers`. That lists every single account that's actively reselling a specific Limited item, and it shows you current supply levels.

To audit user profiles, use `get_user_catalog_inventory`. This tool browses and lists all the public assets—like Hats or Gear—contained within a specific Roblox user ID’s inventory. It lets you see what a collector owns without ever having to visit their profile manually. You've got everything needed right here.

## Tools

### get_asset_thumbnails
Retrieves high-resolution thumbnail images for one or more listed assets.

### get_avatar_bundle_details
Returns specific metadata and item lists for an entire avatar bundle ID.

### get_bundle_recommendations
Finds accessory or clothing bundles that are stylistically similar to a provided input bundle.

### get_catalog_item_details
Fetches complete metadata—including price and description—for an asset using its specific ID number.

### get_limited_resale_data
Calculates the historical resale price data for any limited-edition item.

### get_limited_resellers
Lists every active account currently reselling a specific Limited item, showing supply levels.

### get_user_catalog_inventory
Browses and lists the public assets—like Hats or Gear—contained within any user's profile inventory.

### search_avatar_catalog
Searches items across the entire Avatar Shop, allowing you to filter by category and sort results.

## Prompt Examples

**Prompt:** 
```
Search for 'Valkyrie' hats in the catalog and show the cheapest active listing.
```

**Response:** 
```
Running the catalog query for 'Valkyrie'... I found 3 matching items. The 'Valkyrie Helm' is currently a Limited item. I've identified the cheapest active listing at 55,000 Robux. Would you like to see the other variations?
```

**Prompt:** 
```
What items are included in the 'Korblox Deathspeaker' bundle?
```

**Response:** 
```
Inspecting bundle ID '192'... The 'Korblox Deathspeaker' bundle includes 7 items, most notably the legendary 'Korblox Deathspeaker Right Leg'. The current price is 17,000 Robux. Shall I provide the IDs for each component?
```

**Prompt:** 
```
Audit the inventory of user ID '7654321' and list their 5 most expensive items.
```

**Response:** 
```
Retrieving user assets... User '7654321' has 150 public items. Their top 5 most expensive assets include 'Dominus Empyreus' and 'Clockwork's Headphones'. The total estimated value of these 5 items is 1.2M Robux. Would you like the full breakdown?
```

## Capabilities

### Search and Filter Catalog Assets
Find specific items in the Avatar Shop by running targeted searches that support category and sort filters.

### Get Technical Item Metadata
Retrieve full, granular data for any single asset ID, including creator details and current stock status.

### Audit User Inventories
Fetch a public list of assets owned by a specific Roblox user ID, categorizing items like Hats or Gear.

### Analyze Bundle Composition
Get detailed information and component lists for entire avatar bundles.

### Track Limited Item Resale Data
Review the historical resale price data for limited-edition assets to gauge their current market value.

### Identify Market Arbitrage Targets
List all active resellers for a given Limited item so you can monitor supply and pricing immediately.

## Use Cases

### Finding undervalued investment pieces
A trader wants to find Limited items that are priced low relative to their history. They first use `search_avatar_catalog` to narrow down the category (e.g., 'Hats'). Then, they run `get_limited_resale_data` on candidates to confirm if the current listing price is an actual deal.

### Analyzing a high-profile user's wealth
An analyst needs to know how wealthy a specific account is. They run `get_user_catalog_inventory` using the target ID, which returns all public assets. The agent then calculates the total estimated value for reporting.

### Deconstructing a rare outfit
A creator sees an amazing outfit but doesn't know what pieces it's made of. They input the bundle ID into `get_avatar_bundle_details`, and the agent instantly returns the list of all constituent items, saving manual investigation.

### Monitoring market competition
A developer wants to know what assets a competitor is listing or selling. They use `search_avatar_catalog` with filters for specific rarity levels and then check the current resellers using `get_limited_resellers`.

## Benefits

- Stop guessing the true worth of an item. Running `get_limited_resale_data` gives you verifiable, historical price points, making valuation immediate.
- Don't waste time browsing. Use `search_avatar_catalog` to pull thousands of items matching specific keywords or categories in one query.
- Audit competitors instantly. Run `get_user_catalog_inventory` against a user ID and get a precise list of their assets and estimated collection value.
- Understand complex outfits immediately. Instead of guessing what's inside, use `get_avatar_bundle_details` to see every component of an item bundle.
- Track the supply chain. If you need to know who is selling an asset right now, running `get_limited_resellers` provides a live list of current market participants.

## How It Works

The bottom line is you tell your AI client what data you need, and it calls the right tool to get the answer from Roblox's public catalog.

1. Subscribe to the server. No API key is needed because it accesses public catalog data.
2. Connect your preferred AI client (Claude, Cursor, etc.) to this MCP Server via natural conversation.
3. Ask your agent a direct question—like 'Find me all limited hats under 50k Robux'—and the tools execute the query.

## Frequently Asked Questions

**How do I find specific items using search_avatar_catalog?**
You use the tool with keywords, but you can also refine your search by specifying categories or applying sort filters. This gives you a much more targeted result than just browsing.

**Does get_limited_resale_data work for all items?**
No, it only works for Limited items that have recorded resale history on the platform. You must first confirm the item's limited status before running this tool to avoid errors.

**What is the best way to audit a user’s whole account?**
Run `get_user_catalog_inventory` with the target user ID. This fetches their public assets, and you can then use other tools like `get_catalog_item_details` on the returned IDs for deeper metrics.

**Can I find out what's in a bundle using get_avatar_bundle_details?**
Yes. You feed it the specific bundle ID, and the tool returns a full breakdown of every single item included in that package—great for understanding complex outfits.

**When I run `get_catalog_item_details`, what should I know about rate limits for bulk metadata retrieval?**
The server manages standard API request throttling. For large-scale audits, process requests in batches of 50 assets to prevent timeouts and ensure reliable data flow.

**Does `search_avatar_catalog` allow me to filter by specific asset types or rarity, like 'Limited U' gear?**
Yes, the search function supports category filters. You can narrow results using parameters for specific asset types (e.g., accessories, shirts) and rarity tiers.

**How fresh is the pricing data I get from `get_limited_resale_data`?**
The tool pulls recent market activity but shows historical records alongside it. It provides a clear timestamp for when the price data was last recorded, so always check that context.

**If I use `get_bundle_recommendations`, how does it ensure the suggested items are actually compatible with my existing assets?**
The recommendations engine analyzes item metadata compatibility. It doesn't just suggest popular items; it cross-references required slots and asset types.

**Can my AI automatically find 'Limited' items that are currently for sale?**
Yes! Use the `get_limited_resale_data` tool. Your agent will filter the official Roblox catalog to return only rare Limited and Limited U assets, including their current resale prices and availability.

**How do I check the contents of a specific avatar bundle?**
Simply provide the Bundle ID to the agent and ask for details. It will run the `get_avatar_bundle_details` action to retrieve the full list of constituent items, price, and descriptive metadata for that bundle.

**Is it possible to estimate the total Robux value of a user's public inventory?**
Absolutely. By using the `get_user_catalog_inventory` tool, the agent retrieves the list of items. It can then run the `get_limited_resale_data` tool to provide a summed estimation of the collection's market worth.