iRacing

Provides real-time iRacing data to MCP clients with login, team and member lookups, and career stats

typescript

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "emiliosp-iracing-data-mcp-server": {
      "command": "npx",
      "args": [
        "iracing-data-mcp-server@latest",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/cookie-jar-file"
      ],
      "env": {
        "EMAIL": "your.email@example.com",
        "API_KEY": "your_api_key_here",
        "PASSWORD": "your_password_here",
        "COOKIE_JAR": "./cookies.txt"
      }
    }
  }
}

You can use this MCP (Model Context Protocol) server to access iRacing’s racing data through AI assistants or direct CLI, with automatic authentication, type-safe operations, and a convenient CLI interface for data lookups and career information.

How to use

Use the MCP server to expose iRacing data to AI assistants or to run data queries from your own automation. You will run the MCP as a local stdio server via a simple command, provide your authentication cookies, and then call the available tools to login, fetch member profiles, look up drivers, retrieve team data, or get season recaps and career stats.

How to install

Prerequisites: Node.js 24+ and npm. You also need an iRacing account with an active subscription.

Follow these concrete steps to set up and run the MCP server locally.

# 1) Install Node.js and npm (Node.js 24+ is required)
# 2) Clone the project repository
#    Replace with your actual repository URL if you have a fork
git clone https://github.com/yourusername/iracing-data-mcp-server.git
cd iracing-data-mcp-server

# 3) Install dependencies
npm install

# 4) Prepare authentication details
# Create a cookies file path that will store your iRacing cookies
# Example path: ./cookies.txt
# You will provide your iRacing credentials via environment variables when starting the server

# 5) Start the MCP server using the provided stdio command (see next step for exact command)

Configuration and running the MCP server

The MCP server is started locally using a standard command via npm tooling. Set up your environment variables and run the following to launch the server (the command includes the package, the required module, and the path to your cookie jar):

npx iracing-data-mcp-server@latest @modelcontextprotocol/server-filesystem /path/to/your/cookie-jar-file

COOKIE_JAR=./cookies.txt
EMAIL=your.email@example.com
API_KEY=your_api_key_here

Security and maintenance notes

Use an API key for secure authentication when available. The server manages authentication cookies automatically and refreshes sessions as needed. Keep your cookie jar path secure and avoid exposing API keys or credentials in shared environments.

Available tools

login

Authenticate with iRacing and establish a session for subsequent data access

get_members_profile

Retrieve detailed member profile data by member IDs

get_team

Retrieve information about a team by its team ID

get_member_recap

Get a season recap for a member, with optional year and season parameters

get_member_career

Obtain career statistics for a member by their ID

driver_lookup

Search for drivers by name

Built by

VeilStrat

AI signals for GTM teams