# Faceit MCP for AI Agents AI Agent Connect

> Faceit MCP gives your AI agent direct access to the world's largest competitive gaming platform. You can pull real-time player stats, scout upcoming tournaments, and dive into hub leaderboards for titles like CS2 and Valorant. It turns your agent into a high-level esports analyst that knows the numbers behind the games without you having to click through endless profiles.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Oytg4k1T2q3jeTUi3Ugna6iKnL3Dx0cytJlMXsfZ/ai-agent-connect
- **Tags:** esports, matchmaking, player-stats, leaderboards, competitive-gaming, tournaments

## Description

Imagine you're trying to build a team or just want to know who the best players are in a specific region. Usually, that means jumping between different profiles, scrolling through endless match histories, and trying to keep track of ELO changes in a spreadsheet. This Connector changes that by letting your agent do the heavy lifting. Instead of manual searching, you just ask your agent to find a player's win rate or see who's leading a specific hub. It pulls everything directly from Faceit's data so you can focus on the strategy rather than the data entry. It's a huge time saver if you're managing a team or just want to stay on top of the competitive scene. You can find this and thousands of other tools in the Vinkius catalog, making it easy to plug into your existing workflow without worrying about the underlying API headaches. It's about getting the facts fast so you can make better calls in your next match or content piece.

## Tools

### get_hub
Get the rules, organizer info, and player counts for a specific hub.

### get_hub_leaderboard
Pull the rankings for a specific hub to see who's on top.

### get_hub_matches
Get a list of matches for a specific hub, including scores and timestamps.

### get_match
Pull the specific details and results for a single match.

### get_match_stats
Retrieve per-player performance metrics like K/D/A and headshot percentages for a match.

### get_player
Get a full profile for a player, including their nickname, country, and ELO.

### get_player_bans
Check a player's ban history, including reasons and durations.

### get_player_history
View a player's past match results, ELO changes, and game history.

### get_player_stats
Get specific game stats like win rates, streaks, and headshot percentages for a player.

### search_players
Find any player on the platform by searching their nickname.

### search_tournaments
Look up upcoming and ongoing tournaments with prize pools and skill requirements.

### get_games
See a full list of all games supported on the Faceit platform.

## Prompt Examples

**Prompt:** 
```
Who are the top players in hub abc123?
```

**Response:** 
```
### Hub Leaderboard: abc123

Here are the current top rankings for this hub:

| Rank | Player | ELO | Faceit Level |
| :--- | :--- | :--- | :--- |
| 1 | **PlayerOne** | 2156 | 9 |
| 2 | **ProGamer42** | 2089 | 9 |
| 3 | **SharpShooter** | 2034 | 8 |

*Note: Rankings are updated in real-time.*
```

**Prompt:** 
```
Find me a CS2 player named 'ShadowStrike' and tell me their stats.
```

**Response:** 
```
I found the profile for **ShadowStrike**:

*   **Faceit Level:** 10
*   **CS2 ELO:** 2847
*   **Win Rate:** 68%
*   **K/D Ratio:** 1.42
*   **Headshot %:** 52%
*   **Member Since:** 2016

They seem to be a highly active player with a solid win rate.
```

**Prompt:** 
```
What tournaments are happening this weekend for Valorant?
```

**Response:** 
```
Here are the upcoming Valorant tournaments for this weekend:

*   **Weekend Warriors**
    *   **Start Time:** Saturday 18:00
    *   **Skill Level:** 5+
    *   **Prize Pool:** €250
*   **Pro League Qualifier**
    *   **Start Time:** Sunday 16:00
    *   **Skill Level:** 8+

Let me know if you want more details on any of these!
```

## Capabilities

### Search for specific players
Find any player on the platform by nickname to get their levels and ELO.

### Pull detailed match performance
Get K/D/A, headshot percentages, and MVP rounds for specific matches.

### Browse community hubs
See hub rules, organizer info, and current player counts.

### Track tournament prize pools
Search for upcoming tournaments with start times and skill requirements.

### View live hub leaderboards
Get the current rankings and ELO for any specific hub.

### Check player ban history
See the reasons and durations for a player's past bans.

### Fetch game-specific stats
Retrieve win rates, current streaks, and headshot percentages for specific games.

## Use Cases

### Scouting for a new team
A manager asks the agent to find players with a 1.5 K/D in CS2 and a specific ELO range to find potential recruits.

### Content planning
A YouTuber asks for a list of the top 5 hubs for Valorant to see which ones have the most active communities for a video.

### Tournament prep
A team captain checks the prize pools and skill requirements for all upcoming CS2 tournaments happening this weekend.

### Performance review
A coach pulls the match stats for the last five games to see which players are hitting their headshot targets consistently.

## Benefits

- Stop manual scouting. Use search_players and get_player to instantly find and profile anyone on the platform without clicking through profiles.
- Master your team's performance. Use get_match_stats and get_player_history to see exactly where players are succeeding or falling short in every game.
- Stay ahead of the tournament circuit. Use search_tournaments to keep a live list of prize pools and start times for all your favorite games.
- Simplify hub management. Use get_hub and get_hub_leaderboard to quickly check rules and see who's currently leading the rankings.
- Get deep data insights. Use get_player_stats to grab headshot percentages and win streaks to help with player evaluation.

## How It Works

The bottom line is you get instant access to professional-grade esports data without ever leaving your chat interface.

1. Enter your Faceit API Key from the developer portal into your configuration.
2. Connect the Connector to your preferred AI client like Claude or Cursor.
3. Ask your agent to pull stats, search players, or find tournaments.

## Frequently Asked Questions

**Can the Faceit MCP find specific players for me?**
Yes, it can search for any player on the platform by their nickname. It will return their Faceit level, ELO, and basic game stats so you can quickly identify them.

**How do I use Faceit MCP to see tournament prize pools?**
You can ask your agent to search for tournaments. It will pull a list of upcoming events, including their start times, skill requirements, and the total prize pool for each.

**Can I get detailed match stats with Faceit MCP?**
Yes, it can retrieve per-player performance metrics for specific matches. This includes K/D/A, headshot percentages, and MVP rounds.

**Does Faceit MCP work for multiple games?**
It supports the major games on the platform, including CS2 and Valorant, as well as the full catalog of games supported by Faceit.

**Can I see hub leaderboards using Faceit MCP?**
Yes, you can get the full leaderboard for any specific hub. It will show you the rankings, nicknames, ELO, and Faceit levels of the top players.

**How does Faceit MCP help with scouting?**
It automates the research process. Instead of clicking through profiles, you can ask your agent to summarize a player's history, win rates, and recent performance in one go.

**How do I get a Faceit API key?**
Register at [**developers.faceit.com**](https://developers.faceit.com/) and create an application to get your API key. Free for non-commercial use.

**What games are supported?**
Faceit supports CS2, Valorant, Dota 2, League of Legends, Rainbow Six Siege, Rocket League, PUBG and many more. Use get_games to see the full catalog.

**What is a Faceit level?**
Faceit levels range from 1-10 based on ELO rating. Level 1 = 0-500 ELO, Level 10 = 2001+ ELO. Higher levels indicate more skilled players.