mcpField
I
iRacing MCP

iRacing MCP

Local
github.com/musantroGames & Entertainment9Updated 80w ago
Repository

About iRacing MCP

iRacing MCP is a Python server for retrieving iRacing profile statistics and iRating charts. It is intended for people building custom applications or querying iRacing data through MCP.

Key features

  1. 01Retrieve profile statistics
  2. 02View iRating charts by category

Use cases

  1. 01Checking an iRacing profile’s statistics
  2. 02Reviewing an iRating chart for a category

MCP support

It exposes tools and resources for interacting with iRacing data to MCP clients.

#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "iracing": {
      "command": "uvx",
      "args": [
        "iracing-mcp"
      ],
      "env": {
        "IRACING_USERNAME": "<IRACING_USERNAME>",
        "IRACING_PASSWORD": "<IRACING_PASSWORD>"
      }
    }
  }
}
Run commanduvx iracing-mcp
Environment variables to set
IRACING_USERNAME
IRACING_PASSWORDSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiiracing-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

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):

"iracing": {
    "command": "uvx",
    "args": [
        "iracing-mcp@latest"
    ],
    "env": {
        "IRACING_USERNAME": "[email protected]",
        "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": "[email protected]",
                "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

  1. Clone the repository:

    git clone https://github.com/musantro/iracing-mcp.git
cd iracing-mcp

  2. Create environment with dependencies:

    uv sync

  3. 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:

  1. Fork the repository.
  2. Create a new branch for your feature or bugfix.
  3. Push your branch.
  4. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.