iRacing 🐎

What is iRacing 🐎?

iRacing 🐎 is a Node.js Model Context Protocol (MCP) server that provides seamless access to iRacing's racing simulation data API. It serves as both a standalone CLI tool and an MCP server for AI assistant integration.

How to use iRacing 🐎?

Install via npm (npx iracing-data-mcp-server@latest) and configure environment variables for credentials (EMAIL, PASSWORD or API_KEY) and cookie storage (COOKIE_JAR). Use as an MCP server with AI assistants like Claude Desktop, or as a CLI tool with npm run login followed by npm run api commands (e.g., npm run api member 123456).

Key features of iRacing 🐎

• AI Assistant Ready: Integrate with Claude, ChatGPT
• Real-time iRacing data access
• Automatic login and session management
• Type-safe operations with TypeScript and Zod
• Dual interface: MCP server and CLI

Use cases of iRacing 🐎

• AI assistant answering driver statistics and team data
• CLI automation for fetching member career stats
• Season recap retrieval for performance analysis
• Driver lookup by name for scouting or research
• Access iRacing API documentation directly

FAQ from iRacing 🐎

How do I authenticate with iRacing?

Use your iRacing email and password, or generate a SHA‑256 API key from your password and email for enhanced security.

How is cookie management handled?

The server automatically stores cookies in the path set by COOKIE_JAR, refreshes expired sessions, and handles authentication errors gracefully.

What are the prerequisites to run this server?

Node.js 24+, npm, and an active iRacing account with a valid subscription.

Can I use this MCP server with Claude Desktop?

Yes—add the provided configuration json to Claude Desktop’s MCP settings file, including your credentials and cookie jar path.

What data can I access through this server?

Member profiles, team information, career statistics, season recaps, driver lookup, and the iRacing API documentation.