Click on "Install 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 Data MCP Serverfind the career statistics for driver Max Verstappen"
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 Data MCP Server 🏎️
A Node.js Model Context Protocol (MCP) server that provides seamless access to iRacing's racing simulation data API. This project serves as both a standalone CLI tool and an MCP server for AI assistant integration.
🌟 Features
🤖 MCP Server Integration
AI Assistant Ready: Seamlessly integrate with Claude, ChatGPT, and other AI assistants
Real-time Data Access: Live access to iRacing's comprehensive racing data
Automatic Authentication: Handles login and session management automatically
Type-safe Operations: Full TypeScript support with Zod schema validation
📊 Data Access
Member Profiles: Detailed driver information including licenses and ratings
Team Information: Comprehensive team data and statistics
Career Statistics: Complete racing career history and achievements
Season Recaps: Detailed season performance and progression
Driver Lookup: Search and find drivers by name
API Documentation: Built-in access to iRacing's API documentation
🛠️ Dual Interface
MCP Server: For AI assistant integration
CLI Tool: For direct command-line access and automation
📖 Usage
As MCP Server
Configuration for LLM Clients
To use this MCP server with AI assistants like Claude Desktop, add the following configuration to your MCP settings file:
For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Available MCP Tools
The server will run and provide the following tools to AI assistants:
Tool | Description | Parameters |
| Authenticate with iRacing | None |
| Get member profile data |
|
| Retrieve team information |
|
| Get season recap data |
|
| Get career statistics |
|
| Search for drivers |
|
📹 Watch the video
As CLI Tool
Environment Setup
Create a .env file in your project directory:
Initial Authentication
Before using the cli, authenticate with iRacing:
Use the command-line interface for direct data access:
Get Member Profile
Get Team Information
Get Member Career Data
Get Season Recap
Driver Lookup
API Documentation
🔧 Development Setup
Prerequisites
Node.js 24+
npm
iRacing account with active subscription
Clone and Install
🔐 Authentication & Security
API Key vs Password
Recommended: Use an API key for enhanced security:
Generate API Key:
const crypto = require('crypto'); const apiKey = crypto.createHash('sha256') .update(password + email) .digest('base64');Set in Environment:
API_KEY=your_generated_api_key # Remove PASSWORD variable when using API_KEY
Cookie Management
The server automatically manages authentication cookies:
Stores cookies in the path specified by
COOKIE_JARAutomatically refreshes expired sessions
Handles authentication errors gracefully