iracing-data

This MCP server provides programmatic access to iRacing data via a set of typed, schema-validated tools. It runs as a Node.js-based MCP server and can be integrated with AI assistants or used directly via its CLI tool. The server handles authentication cookies automatically and exposes tools such as login, get_members_profile, get_team, get_member_recap, get_member_career, and driver_lookup. To use it with a model or assistant, configure your MCP client to point to this server, then invoke the available tools to query iRacing data in a structured, type-safe way.

Prerequisites:

• Node.js 24+ installed on your system
• npm installed alongside Node.js
• An iRacing account (subscription) for data access

Steps:

1. Clone the repository (or install via npm if published): git clone https://github.com/yourusername/iracing-data-mcp-server.git cd iracing-data-mcp-server

2. Install dependencies: npm install

3. Run the MCP server (example): npm run start

4. (Optional) Use the CLI for direct data access: npm run login npm run api member 123456

5. Configure your MCP client to connect to the server using the provided mcp_config example at the top of this document.

Notes and tips:

• The server uses a cookie jar to manage iRacing authentication automatically. Store cookies at the path specified by COOKIE_JAR.
• For security, consider using an API key (API_KEY) instead of password-based login where supported.
• Environment variables you may need:
  • COOKIE_JAR: path to the cookie storage file
  • EMAIL: iRacing account email
  • API_KEY: optional pre-generated API key for authentication
• When integrating with an AI assistant, ensure the model context supports the provided tool set and that your environment passes the necessary parameters for each tool (e.g., member_id, year, season, etc.).
• If you encounter login expiration, the server should refresh sessions automatically; no manual intervention is typically required.
• The npm package name for this server is iracing-data-mcp-server.