iRacing MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iRacing MCP show my iRating chart for road racing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
iRacing MCP
iRacing MCP is a Python-based project that integrates iRacing with the Model Context Protocol (MCP). It provides tools and resources to interact with iRacing data and build custom applications.
Features
Retrieve iRacing profile statistics.
Get iRating chart (for any category)
More coming soon
Related MCP server: Formula1 MCP Server
Getting Started
Prerequisites
uv - Install here
iRacing account with legacy authentication (required) - Enable it here: https://oauth.iracing.com/accountmanagement/security
Usage
Running the Server Standalone
To start the MCP server, run:
IRACING_USERNAME="your username" IRACING_PASSWORD="your-password" uvx iracing-mcpRunning the Server on VSCode
Add this to your settings.json (in mcp.servers):
"iracing": {
"command": "uvx",
"args": [
"iracing-mcp@latest"
],
"env": {
"IRACING_USERNAME": "your@email.com",
"IRACING_PASSWORD": "your password"
}
}Running the MCP Server on Claude Desktop
Add this to your settings.json:
[
"mcpServers": {
"iracing": {
"command": "uvx",
"args": [
"iracing-mcp@latest"
],
"env": {
"IRACING_USERNAME": "your@email.com",
"IRACING_PASSWORD": "your-password"
}
}
}
}Running the Server on other MCP Clients
Currently I am only using VS Code as MCP Client so I don't know how to configure to other MCP Clients. I am happy to receive PRs on how to configure in the different MCP Servers (e.g. Cursor, Claude Desktop, etc.)
Development
Clone the repository:
git clone https://github.com/musantro/iracing-mcp.git cd iracing-mcpCreate environment with dependencies:
uv syncSet up environment variables for iRacing credentials:
export IRACING_USERNAME="your_username" export IRACING_PASSWORD="your_password"
Linting and Formatting
Use the following commands to lint and format the code:
makeContributing
We welcome contributions! Follow these steps to contribute:
Fork the repository.
Create a new branch for your feature or bugfix.
Push your branch.
Open a pull request.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Available Tools
2 toolsget_iracing_profile_statsA
Get the current iRacing profile statistics.
Retrieves the user's iRacing profile information including license level, iRating, and other career stats.
Inputs: no named parameters.
get_irating_chartA
Get the iRating data for a specific license category.
Retrieves the user's iRating history data for the specified racing category. This includes historical iRating values that can be used for charting.
1 is oval, 2 is road, 3 is dirt oval, 4 is dirt road, 5 is sports car, and 6 is formula car.
Inputs: category (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one retrieves general profile statistics, the other provides historical iRating data for a specific category. There is no ambiguity between them.
Both tools follow a consistent verb_noun pattern using snake_case and the 'get_iracing_' prefix, making them predictable and easy to understand.
With only 2 tools, the server is severely under-scoped for the iRacing domain, which typically requires many more tools for operations like searching races, managing subscriptions, or accessing car/track data.
The tool surface is extremely limited, covering only profile stats and iRating history. Critical operations like race listing, car/track data, league management, and session results are entirely missing, making it incomplete for practical use.
Maintenance
Related MCP Connectors
BGG MCP provides access to the BoardGameGeek API through the Model Context Protocol, enabling retr…
Model Context Protocol server for Studex tools, notifications, and profile integrations
AI race engineer for sim racing (Automobilista 2, Assetto Corsa, Assetto Corsa Competizione, Assetto Corsa Evo, RaceRoom). Provides telemetry analysis, braking diagnostics, and leaderboards. Connected via public demo by default. Get your free personal token at [https://flowix.com](https://flowix.com) to analyze your own laps.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides Formula One data and statistics through a Model Context Protocol interface, allowing users to access race calendars, session results, driver statistics, telemetry data, and championship standings.811MIT
- AlicenseNot gradedqualityDmaintenanceProvides real-time and historical Formula 1 racing data through the Model Context Protocol, offering access to timing data, driver stats, race results, telemetry, and more.14MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that provides comprehensive Formula One racing data, enabling access to event schedules, driver information, telemetry data, race results, and performance analytics through natural language queries.81MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered racing coaching and telemetry analysis for iRacing, providing real-time racing advice, car spotting, lap analysis, and conversational interaction with racing data through live telemetry streaming.2MIT