Iracing Mcp
What is Iracing Mcp
iRacing MCP is a Python-based project that integrates iRacing with the Model Context Protocol (MCP), allowing users to interact with iRacing data and build custom applications.
Use cases
Use cases include developing custom dashboards for real-time data visualization, analyzing racing performance statistics, and integrating iRacing data into other applications or tools.
How to use
To use iRacing MCP, you need to set up your iRacing account with legacy authentication, install the required dependencies, and run the server using the provided commands in your terminal or IDE.
Key features
Key features include retrieving iRacing profile statistics and obtaining iRating charts for any category, with more features expected in future updates.
Where to use
iRacing MCP can be used in the field of sim racing, particularly for developers and enthusiasts looking to create applications that leverage iRacing data.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Iracing Mcp
iRacing MCP is a Python-based project that integrates iRacing with the Model Context Protocol (MCP), allowing users to interact with iRacing data and build custom applications.
Use cases
Use cases include developing custom dashboards for real-time data visualization, analyzing racing performance statistics, and integrating iRacing data into other applications or tools.
How to use
To use iRacing MCP, you need to set up your iRacing account with legacy authentication, install the required dependencies, and run the server using the provided commands in your terminal or IDE.
Key features
Key features include retrieving iRacing profile statistics and obtaining iRating charts for any category, with more features expected in future updates.
Where to use
iRacing MCP can be used in the field of sim racing, particularly for developers and enthusiasts looking to create applications that leverage iRacing data.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
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-mcp
Running the Server on VSCode
Add this to your settings.json (in mcp.servers):
Running the MCP Server on Claude Desktop
Add this to your settings.json:
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-mcp -
Create environment with dependencies:
uv sync -
Set 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:
make
Contributing
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.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
