wheelfitmentdb-mcp

Official MCP server for WheelFitmentDB — automotive wheel fitment calculators (offset, backspacing, PCD, hub rings) and offline OEM vehicle spec lookup for Claude, Cursor & AI agents.

Documentation

WheelFitmentDB MCP Server (wheelfitmentdb-mcp)

License: MIT Node.js >= 18

Model Context Protocol (MCP) server for automotive wheel fitment engineering and OEM-verified vehicle spec lookups, built by WheelFitmentDB.

Give Claude, Cursor, Codex, and custom automotive AI agents deterministic wheel fitment math and structured hub geometry — eliminating LLM bolt pattern and lug hardware hallucinations.

Quick Links


Available MCP Tools

Tool NamePurposeData Required
calculate_wheel_offset_comparisonCompare stock vs. aftermarket rim width, offset (ET) & tire size: inner strut clearance, outer poke, rolling diameter %, and 60 mph speedo error.Pure physics math (0 external deps)
convert_offset_backspacingBidirectional wheel offset (ET mm) ↔ backspacing (inches) converter accounting for standard 1.0" flange width.Pure physics math
convert_bolt_pattern_pcdMetric ↔ Imperial bolt pattern converter (e.g. 5x114.3 ↔ 5x4.5").Pure math
calculate_hub_centric_ringCompute required hub-centric ring OD/ID dimensions and compatibility status.Pure math
lookup_vehicle_fitmentDeterministic OEM vehicle spec lookup (PCD, center bore, offset, thread size, seat type, hex size).50-model preview built-in, or full 12,902-vehicle local JSON

Installation

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "wheelfitmentdb": {
      "command": "npx",
      "args": ["-y", "wheelfitmentdb-mcp"]
    }
  }
}

Cursor / Windsurf / VS Code (.cursor/mcp.json)

{
  "mcpServers": {
    "wheelfitmentdb": {
      "command": "npx",
      "args": ["-y", "wheelfitmentdb-mcp"]
    }
  }
}

Unlock All 12,902 Vehicles Offline (Business Pro)

By default, lookup_vehicle_fitment ships with a 50-model public preview of 2026 flagship vehicles. To enable zero-latency offline queries across all 12,902 verified vehicles (1992–2026, incl. 553 MY2026 models), download the WheelFitmentDB Business Pro JSON ($89 one-time) and pass WHEELFITMENTDB_DATA_PATH:

{
  "mcpServers": {
    "wheelfitmentdb": {
      "command": "npx",
      "args": ["-y", "wheelfitmentdb-mcp"],
      "env": {
        "WHEELFITMENTDB_DATA_PATH": "/absolute/path/to/WheelFitmentDB_Master_Database_v2.6.json"
      }
    }
  }
}

Local Development

npm install
npm run build
npm start

License

MIT © WheelFitmentDB