Faceit MCP. Track player performance and analyze match data.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Faceit MCP Server accesses competitive gaming data for CS2, Valorant, and other titles. Use it to search for players by nickname, track detailed stats (K/D, win rate, headshot %), check match results, or find local hub leaderboards.
Get player profiles, match history, and tournament info all from your agent.
What your AI agents can do
Get games
Returns a list of all game IDs, names, and player counts supported on the platform.
Get hub
Retrieves general details for a specific Faceit community hub, including rules and organizer information.
Get hub leaderboard
Gets the ranking list for a specified hub, showing player nicknames, ELO, Faceit level, and rank position.
Retrieves a player's full record, including their nickname, country, Faceit levels across multiple games, and ELO ratings.
Returns granular stats for a specific match, such as K/D/A, headshot percentage, K/R ratio, and MVP rounds.
Retrieves a player's match log, including results (win/loss), score changes, ELO adjustments, and the date of play.
Gathers aggregated, game-specific stats for a player, like total matches played, current win streak, and K/D ratio.
Accesses the ranking board for a specific community hub, listing player nicknames, ELO, Faceit level, and rank position.
Finds details on upcoming or ongoing tournaments, including names, required skill levels, and prize pools.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Faceit MCP Server: 12 Tools for Gaming Data
Use these tools to pull structured data on player profiles, match outcomes, and community leaderboards from Faceit.
019d8438get games
Returns a list of all game IDs, names, and player counts supported on the platform.
019d8438get hub
Retrieves general details for a specific Faceit community hub, including rules and organizer information.
019d8438get hub leaderboard
Gets the ranking list for a specified hub, showing player nicknames, ELO, Faceit level, and rank position.
019d8438get hub matches
Gets a list of matches for a hub, allowing filtering by type: all, upcoming, ongoing, or past.
019d8438get match
Fetches all details for a specific match ID.
019d8438get match stats
Returns detailed performance metrics for every player in a match, such as K/D/A and headshot percentage.
019d8438get player
Retrieves the full profile details for a single Faceit player, including their country and various ELO ratings.
019d8438get player bans
Returns a player's ban history, detailing the ban type, reason, date, and duration.
019d8438get player history
Gets a player's full match history, including scores, win/loss status, ELO changes, and game played.
019d8438get player stats
Provides aggregated, game-specific statistics for a player, including win rate, K/D ratio, and current win streak.
019d8438search players
Searches for Faceit players by nickname, returning their IDs, levels, ELO ratings, and current game stats.
019d8438search tournaments
Finds details about upcoming tournaments, including names, required skill levels, and prize pools.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Faceit, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You connect your agent to the Faceit MCP Server and you get all the competitive gaming data for CS2, Valorant, and more. You don't gotta jump on the website or manually copy any stats. Here's what you can do:
Finding Players and Stats
search_players lets you search for any player by their nickname, giving you their ID, Faceit level, ELO rating, and current game stats. get_player retrieves a full profile for a player, showing their country and all their ELO ratings. You can check a player's ban history with get_player_bans, which lists the ban type, reason, date, and how long the ban lasted. get_player_stats gives you aggregated, game-specific stats, like win rate, K/D ratio, and what a player's current win streak is.
If you want to see a player's whole match history, get_player_history pulls that log, including scores, win/loss status, ELO changes, and the date they played.
Analyzing Matches and Hubs
get_match fetches all the details for a specific match ID. You can then use get_match_stats to get detailed performance metrics for every player in that match, like K/D/A, headshot percentage, K/R ratio, and MVP rounds. For a specific community hub, get_hub pulls general details, including rules and who organized it.
You can check the ranking board for that hub using get_hub_leaderboard, which lists player nicknames, ELO, Faceit level, and rank position. To see matches happening at a hub, get_hub_matches gets a list, and you can filter it by type—all, upcoming, ongoing, or past.
Tracking Tournaments and Games
search_tournaments finds details on upcoming or ongoing tournaments, giving you their names, required skill levels, and prize pools. get_games returns a list of every game ID, name, and how many players the platform supports. If you need a player's match log, get_player_history shows it, including scores, win/loss status, ELO changes, and the date played.
How Faceit MCP Works
- 1 Subscribe to the Faceit server and enter your API Key.
- 2 Ask your AI agent a question (e.g., 'What are the stats for PlayerX in CS2?').
- 3 The agent selects the correct tool (
get_player_stats) and executes it, returning the data to your client.
The bottom line is: you get structured, real-time competitive gaming data without leaving your chat client.
Who Is Faceit MCP For?
Anyone who tracks competitive esports or manages gaming teams needs this. It’s for the team manager who needs to analyze performance across multiple players quickly, the content creator who needs fast, accurate match results for articles, and the dedicated player who just wants to see their own stats without clicking through five different websites.
Uses the server to analyze player performance and match history across multiple players, checking hub leaderboards to identify key players.
Pulls specific match results and tournament details to write articles or build video content, eliminating manual data scraping.
Checks player stats and match history for opponents or teammates to gauge current skill levels and identify areas for improvement.
What Changes When You Connect
- Check a player’s current skill level immediately. Instead of navigating to a separate profile page, use
search_playersto get their nickname, Faceit level, and ELO rating in one call. - Build comprehensive player profiles. You can combine
get_player(for general info) withget_player_stats(for game-specific metrics) to build a full picture of a player's career. - Analyze match performance after the fact. Use
get_match_statsto pull K/D/A, headshot %, and K/R ratios for every player in a specific match without manual calculation. - Keep tabs on the community. Use
get_hub_leaderboardto pull the top rankings for a specific hub, orget_hub_matchesto see what games are happening right now. - Research competitive opportunities. Run
search_tournamentsto list all upcoming events, checking skill requirements and prize pools before committing time. - Understand player stability. Check a player's ban history using
get_player_bansto verify their account status before trusting their stats.
Real-World Use Cases
Need to compare two players' overall skill.
A scout needs to compare Player A and Player B. They first use search_players to get the basic profile and ELO for both. Then, they use get_player_stats for both to get the win rate and K/D ratio. The agent compares the resulting structured data, solving the comparison in minutes.
Investigating a specific match's outcome.
A coach asks, 'Why did we lose that match last night?' The agent takes the match ID, calls get_match_stats, and returns a breakdown of individual performance metrics (K/D/A, MVP rounds). The coach sees exactly where the team failed.
Tracking a player's career progress.
A journalist wants to write a piece on a player's rise. They use get_player_history to pull match IDs, scores, and dates, and then use get_player_stats to summarize the trend, giving the article depth that manual research can't match.
Finding the best local community event.
A player wants to find a local tournament. They use get_hub to find the community hub's details, then get_hub_leaderboard to see who the current top players are, and finally search_tournaments to find nearby events.
The Tradeoffs
Mixing player info with match details
Trying to find a player's win rate using only get_player and then trying to cross-reference it with a single match ID using get_match.
→
For comprehensive player stats, use get_player_stats. If you need the outcome of a single match, use get_match_stats with the specific match ID. Don't try to combine them for general performance metrics.
Over-relying on basic search
Assuming search_players provides every possible detail, like ban history or specific K/D ratios for a single match, just because the nickname is found.
→
If you need the full profile, run get_player. If you need specific game-level metrics, use get_player_stats. For ban status, you must explicitly run get_player_bans.
Using the wrong tool for history
Using get_player to get a player's match history, which only provides core profile data and ignores scores or win/loss records.
→
Always use get_player_history to get a complete log of match IDs, results, scores, and ELO changes. This is the dedicated tool for tracking time-based performance.
When It Fits, When It Doesn't
Use this if you need structured, verifiable data about competitive esports. You need to know who played, what they scored, and what their aggregate performance is. The data must come from a specific context (a match, a hub, or a player profile).
Don't use this if you are just looking for general community vibes or anecdotal information. If you only need to know the general name of a game or a simple list of players, checking the get_games tool might be enough. If you need to calculate complex relationships between player performance and tournament schedules, you'll need to sequence calls using search_tournaments and get_player_stats together.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Faceit. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Analyzing player performance shouldn't take 15 tabs and 3 hours of copy-pasting.
Before this server, analyzing a player's career meant manually visiting their profile page, checking the stats tab, pulling the last 10 matches from the history log, and then cross-referencing those dates with separate tournament result sites. It was a nightmare of clicks and copy-pasting.
Now, you ask your agent: 'Give me the K/D ratio and win rate for Player X.' The agent runs `get_player_stats` and returns the data instantly, structured and ready to paste into a document. You get the raw metrics, not a screenshot.
Faceit MCP Server: Get player data and match stats
You used to have to get a match ID from one place, then find the players' stats on a second page, and finally get the scores from a third API. The data was siloed.
Now, you pass the match ID and ask the agent to run `get_match_stats`. It returns every player's K/D/A, headshot %, and MVP rounds in one structured payload. The data is cohesive.
Common Questions About Faceit MCP
How do I use the `get_player_stats` tool to find a player's win rate? +
Use get_player_stats and specify the player ID and game. This tool returns the player's win rate, K/D ratio, and total matches played directly.
What is the difference between `get_player` and `search_players`? +
search_players finds players by nickname across the platform. get_player fetches the complete, detailed profile for a specific player ID, including their country and various ELO ratings.
Can I find a player's match history using the `get_player_history` tool? +
Yes, get_player_history returns a list of match IDs, results (win/loss), scores, ELO change, and the date for every game played.
How do I find upcoming tournaments using `search_tournaments`? +
Run search_tournaments and specify the game and skill level. The tool returns names, IDs, start times, prize pools, and registration status for upcoming events.
Does `get_hub_leaderboard` only show the top 10 players? +
The get_hub_leaderboard returns the player rankings with nicknames, ELO, Faceit level, and position for the specified hub.
How do I use the `get_player_bans` tool to check a player's ban history? +
This tool returns the ban type, reason, date, and duration. You simply need to provide the player's ID to pull up their full ban history.
What if I need to see all matches in a specific community hub, not just the upcoming ones? Should I use `get_hub_matches`? +
Yes, use get_hub_matches and specify the filter type as "all". This pulls every match ID, team, score, and timestamp for that hub.
Can I use the `get_match_stats` tool to analyze performance for a match that already happened? +
Absolutely. This tool gets per-player performance metrics like K/D/A, headshot %, and K/R ratio for any specific match ID.
How do I get a Faceit API key? +
Register at 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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Google Search Console
Monitor your website's search performance, fix indexing issues, and manage sitemaps via AI.
Electricity Maps Carbon Intelligence
Universal energy and carbon intelligence — get real-time electricity mix and carbon data via AI.
Datalastic Maritime
Universal maritime intelligence — search vessels, track positions, and find ports via AI.
You might also like
Loyverse
Free POS and inventory management system.
Zoho Sheet
Connect your AI agents to Zoho Sheet for spreadsheet management: workbooks, worksheets, cell data, rows, and sharing.
Kavita (eBook/Manga)
Manage your Kavita media server—scan libraries, check API status, and authenticate sessions directly from your AI agent.