# Faceit MCP MCP

> Faceit MCP connects your AI client to the world's largest competitive gaming data source for CS2, Valorant, and more. Use it to search detailed player profiles by nickname, retrieve performance stats like K/D ratio and headshot percentage, track match history, analyze hub leaderboards, or find information on upcoming tournaments.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** esports, matchmaking, player-stats, leaderboards, competitive-gaming, tournaments

## Description

Tracking esports data used to take hours of manual searching across multiple websites—checking tournament sites for dates, then hopping over to stat trackers just for player scores. This MCP changes that. You talk to your AI client about the players and matches you care about, and it pulls all the necessary information together in one go. Need to know a team's average K/D ratio from their last three games? Just ask. Want to compare a streamer’s performance across different maps and levels? It handles that. You connect through Vinkius, our #1 MCP App Catalog, giving your agent access to all this deep gaming data without needing to open a dozen tabs. You get clean, actionable stats instantly.

## Tools

### get_games
Gets a list of all supported games, including their names and player counts.

### get_hub
Retrieves general information about a specific Faceit community hub.

### get_hub_leaderboard
Pulls the current ranking for a designated hub, listing player names, ELO scores, and levels.

### get_hub_matches
Returns match details for a specific hub, filtering by status like ongoing or past matches.

### get_match
Retrieves all descriptive data points related to one specific match ID.

### get_match_stats
Calculates per-player statistics for a given match, including K/D/A and headshot percentage.

### get_player
Gets the comprehensive profile of a single Faceit player, listing their various IDs and history data.

### get_player_bans
Returns the disciplinary record for a player, noting ban type, reason, date, and duration.

### get_player_history
Provides a timeline of a player's past matches, including results, score changes, and game dates.

### get_player_stats
Pulls specific metrics for one player across all games, such as win rate and current kill/death ratio.

### search_players
Finds any Faceit user by nickname, returning IDs, avatars, ELO ratings, and game stats.

### search_tournaments
Searches the platform for tournaments, returning names, games, required skill levels, and prize pools.

## Prompt Examples

**Prompt:** 
```
Search for player s1mple on Faceit.
```

**Response:** 
```
Found s1mple: Faceit Level 10, CS2 ELO 2847. Win rate: 68%, K/D: 1.42, Headshot %: 52%. Member since 2016.
```

**Prompt:** 
```
Show me upcoming CS2 tournaments.
```

**Response:** 
```
Found 5 upcoming CS2 tournaments: 1) 5v5 Daily Cup (Level 7+, starts 14:00 UTC, $100 prize) — 2) Weekend Warriors (Level 5+, Saturday 18:00, €250 prize) — 3) Pro League Qualifier (Level 8+, Sunday 16:00).
```

**Prompt:** 
```
Get the leaderboard for hub abc123.
```

**Response:** 
```
Hub Leaderboard: 1. PlayerOne (ELO 2156, Level 9) — 2. ProGamer42 (ELO 2089, Level 9) — 3. SharpShooter (ELO 2034, Level 8) — 4-10...
```

## Capabilities

### Find specific player profiles
Search the platform by nickname to retrieve detailed information including ELO ratings and Faceit levels.

### Analyze match performance metrics
Get deep statistics for a single game, detailing K/D/A ratios, headshot percentages, and MVP rounds for every player involved.

### View team rankings in community hubs
Fetch the current leaderboard for any specific hub, showing players' ranks, ELO scores, and Faceit levels.

### Track match results and details
Retrieve full information on a given match, including final scores, teams, and status updates.

### Discover upcoming tournaments
Search for tournament listings based on game type or skill level, showing prize pools and start times.

### Browse supported games list
Get a full catalog of all gaming titles integrated with the Faceit platform.

## Use Cases

### A coach needs to assess a rookie's readiness.
The agent pulls the player’s profile using `get_player` and combines it with their last ten matches retrieved via `get_player_history`. This shows the coaching staff not just if they won, but how consistently they maintained a high K/D ratio.

### A content creator needs to find trending players.
They run `search_players` for popular local nicknames. The agent can then use `get_player_stats` on the top results, quickly pulling win rates and current ELO scores to build a list of high-value subjects.

### A team manager needs to vet potential recruits.
Instead of relying on hearsay, they use `get_match_stats` for specific matches the recruit played. This provides objective evidence of their headshot percentage and clutch performance under pressure.

### An analyst needs to predict league activity.
The agent uses `search_tournaments` to find all major upcoming events, then checks `get_games` to confirm the titles, providing a complete picture of the competitive calendar for the quarter.

## Benefits

- Stop manually checking multiple sites. You can use `search_players` to find any user by nickname, getting their Faceit level and ELO rating right away.
- Analyze performance depth with `get_match_stats`. Instead of just seeing a win/loss record, you get granular data like K/R ratio and headshot percentages for every round.
- Understand team dynamics using the hub tools. You can use `get_hub_leaderboard` to see who's ranked highest in a community without visiting the hub manually.
- Build out content quickly by searching tournaments with `search_tournaments`. You instantly get details on prize pools, games, and required skill levels for upcoming events.
- Review player commitment or disciplinary issues using `get_player_bans` to see a full ban history record, which is critical context for any analysis.

## How It Works

The bottom line is, you talk to your agent using simple English questions; it does the complex data retrieval for you.

1. Subscribe to this MCP and provide your personal Faceit API Key.
2. Connect your preferred AI client (like Claude, Cursor, or any compatible agent).
3. Ask your agent a natural language question about player stats or match history.

## Frequently Asked Questions

**How do I find detailed stats for a specific match using get_match_stats?**
You must provide the unique match ID when calling `get_match_stats`. The tool then returns K/D/A, headshot %, and other metrics for every player involved in that contest.

**What is the best way to find a user's full background with get_player?**
Use `get_player` by providing the nickname. This tool gives you a wide range of data, including all game-specific levels, ELO ratings across multiple titles, and member since dates.

**Can I check current hub rankings using get_hub_leaderboard?**
Yes, `get_hub_leaderboard` pulls the live ranking for a specified hub. It lists player names alongside their ELO score and Faceit level.

**If I want to know about upcoming competitions, should I use search_tournaments?**
Exactly. `search_tournaments` is the tool for this job. You can find tournament names, IDs, games supported, and prize pools without having to visit the main Faceit calendar.

**How do I get a list of all possible gaming titles?**
Run `get_games`. This tool returns an inventory of every game currently supported on the platform, including their names and how many players are active in them.

**How do I check a player's ban history or moderation status using get_player_bans?**
This function checks if an account is banned, providing immediate clarity on its status. You get the exact ban type, reason, date, and duration of any recorded penalties.

**If I only want to see a player's match results for one specific title, how do I use get_player_history?**
You must provide the game filter when running this function. This limits the returned history records to just that single game, making the timeline much cleaner.

**How can I list matches for a hub, filtering results so I only see completed or future games using get_hub_matches?**
The function accepts status filters like 'past', 'upcoming', and 'ongoing'. Specifying these types narrows down the match IDs and scores exactly how you need them.