# Epic Games Store Intelligence MCP MCP

> Epic Games Store Intelligence lets your agent act like a professional gaming analyst for the entire Epic catalog. It instantly tracks free games, monitors major seasonal sales, and searches deep technical metadata across thousands of titles. You can audit store trends, find niche indie gems by tag, or pull detailed product information—all from natural conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** storefront, game-catalog, promotions, free-games, graphql, digital-distribution

## Description

This MCP gives your AI agent deep access to the official Epic GraphQL catalog. Instead of manually browsing sale pages or tracking down freebie schedules, you simply ask your client what's going on in the store. Your agent handles the heavy lifting: it can instantly pull up every upcoming free title, audit prices and descriptions for specific games, or map out top-selling titles across genres like RPG or Action. It’s essentially giving your workflow a professional gaming consultant who knows where to look for deals, new releases, and market trends. When you connect this MCP through Vinkius, you get one central place to access all of Epic's game data right from any compatible client, turning complex research into simple conversation.

## Tools

### get_free_games
Pulls a list of games that are currently free or scheduled to be free soon.

### get_game_details
Grabs full product information, including descriptions and prices, for one specific game title.

### list_games_on_sale
Provides a list of all games that are currently discounted or on sale.

### list_new_releases
Finds the most recently added titles to the store catalog.

### list_top_sellers
Lists the games that are currently selling the most units in the marketplace.

### search_games_by_category
Narrows down the catalog to show only games within a specific genre, like Action or Puzzle.

### search_games_by_tag
Finds titles that share common characteristics, such as 'Indie' or 'Survival'.

### search_store_catalog
Performs a broad search across the entire store for games based on keywords.

## Prompt Examples

**Prompt:** 
```
Which games are free on the Epic Games Store right now?
```

**Response:** 
```
Checking the freebie vault... I found 2 free games available this week: 'Game Title A' and 'Game Title B'. I also identified that 'Upcoming Title' will be free starting next Thursday. Would you like the direct claim links?
```

**Prompt:** 
```
Search for all Batman games in the catalog and show their current prices.
```

**Response:** 
```
Running the GraphQL query for 'Batman'... I found 4 titles including the 'Arkham Trilogy' (currently on sale for $14.99) and 'LEGO Batman'. Would you like to see the full technical metadata for the Arkham bundle?
```

**Prompt:** 
```
Analyze the latest news and seasonal events for Fortnite.
```

**Response:** 
```
Inspecting Fortnite updates... A new season started yesterday with significant map changes and a new battle pass. I also found an upcoming live concert event scheduled for Saturday. Shall I provide the detailed patch notes?
```

## Capabilities

### Track Free Games and Sales
Get instant lists of currently active or upcoming free games, plus see every title that’s marked down with a discount.

### Analyze Store Trends
Discover the most popular titles and track what's newly released across categories like Action, Indie, and RPG.

### Search Full Catalog Details
Run deep searches on any title or genre to pull technical metadata, current prices, descriptions, and cover images for comparison.

## Use Cases

### Covering 'Best of' Lists
A journalist needs to write an article on the best Action RPGs currently available. Instead of manually searching, they ask their agent to run `search_games_by_category` for both genres and then filter that list using `list_games_on_sale`. The agent provides a ready-made, vetted shortlist.

### Tracking Competitor Moves
A marketing team needs to know if any competitors are dropping free games. They ask their agent to run `get_free_games` daily. If the list changes or a major title appears, they get an instant alert without having to visit the store site.

### Researching Deep Metadata
A developer is building a database and needs technical specs on 5 older titles. They use `search_store_catalog` first to find the IDs, then loop through them using `get_game_details` for reliable descriptions, prices, and metadata.

### Analyzing Peak Sales Periods
A content creator wants to predict when sales will be highest. They ask their agent to combine data from `list_games_on_sale` with `list_top_sellers` to see which games are both cheap and popular, guiding their promotional calendar.

## Benefits

- Don't miss a single deal. Use `get_free_games` to instantly pull up every upcoming or active free title, keeping your content fresh with zero manual checks.
- Build market comparisons fast. Run `search_store_catalog` and then use `get_game_details` on several titles to get technical data (like descriptions and banners) all at once.
- Know what's hot right now. Combine `list_top_sellers` with `list_new_releases` to see if a major trend is picking up steam, giving you angles for immediate coverage.
- Pinpoint niche content. Forget general searches. Use `search_games_by_tag` to find specific types of games—like 'Puzzle' or 'Indie'—that general queries miss.
- See the discounts without effort. Instead of checking every sales page, just run `list_games_on_sale` and get a clean list of everything marked down.

## How It Works

The bottom line is: you just talk to your agent and it handles all the messy API lookups behind the scenes.

1. Subscribe to this MCP and input your Epic Client ID and Secret from the developer portal.
2. Connect your AI agent through any compatible client (like Cursor or Claude).
3. Ask your agent a question—for example, 'What are the top RPGs on sale?'—and it executes the necessary calls.

## Frequently Asked Questions

**How do I find all games by genre using `search_games_by_category`?**
You simply tell your agent to search by category. It will pull up every title associated with that genre, letting you browse the full scope of titles in one query.

**What is the best way to find free games using `get_free_games`?**
Just ask your agent directly. It checks both currently available and upcoming free titles, so you never miss an offer without having to manually check the store page.

**Can I use `search_games_by_tag` for niche searches?**
Yes. This tool lets you filter by specific tags like 'Indie' or 'Puzzle', which is much better than a general keyword search if you need to narrow the scope.

**Does `list_games_on_sale` cover everything?**
No, it just lists titles currently discounted. If you want to know about new releases that *aren't* on sale, you have to use `list_new_releases` separately.

**How do I authenticate my agent when using `search_store_catalog`?**
You must provide your Epic Client ID and Secret credentials. These are obtained from the official Epic Developer Portal, ensuring your connection is secure and authorized for API access.

**Are there rate limits when running `list_top_sellers` repeatedly?**
The MCP manages standard API rate limiting for you. For high-volume tasks or repeated calls, we recommend batching your requests or checking the Epic Developer Portal's usage guidelines.

**If I use `get_game_details`, what happens if the game title is invalid or missing?**
The MCP returns a specific structured error code and an empty data object. Your agent can check for this status to gracefully handle missing titles without crashing your workflow.

**Beyond just titles and prices, what metadata do I get using `list_new_releases`?**
You receive comprehensive technical metadata. This includes high-quality banners, developer names, categories, and full descriptions for every new title found in the catalog.