Skip to main content
Glama
iRacing MCP

iRacing MCP

by musantro

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

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

  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.

Available Tools

2 tools
get_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

    A3.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern using snake_case and the 'get_iracing_' prefix, making them predictable and easy to understand.

    Tool Count2/5

    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.

    Completeness1/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides 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.
      8
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      14
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      8
      1
      MIT