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)
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
- Website: https://wheelfitmentdb.com/mcp/
- MCP Documentation & Tool Reference: https://wheelfitmentdb.com/docs/mcp/
- Full 12,902-Vehicle Master Dataset (CSV/JSON): https://wheelfitmentdb.com/dataset/
- Visual Web Calculators: Offset & Tire Visualizer · Wheel Interchange Finder
Available MCP Tools
| Tool Name | Purpose | Data Required |
|---|---|---|
calculate_wheel_offset_comparison | Compare 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_backspacing | Bidirectional wheel offset (ET mm) ↔ backspacing (inches) converter accounting for standard 1.0" flange width. | Pure physics math |
convert_bolt_pattern_pcd | Metric ↔ Imperial bolt pattern converter (e.g. 5x114.3 ↔ 5x4.5"). | Pure math |
calculate_hub_centric_ring | Compute required hub-centric ring OD/ID dimensions and compatibility status. | Pure math |
lookup_vehicle_fitment | Deterministic 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