alldata-mcp-server

Notice: Open-source local tooling provided AS IS by the authors and contributors; not affiliated with ALLDATA, AutoZone, PartsGeek, or any OEM—use only with accounts you control and at your own risk (see DISCLAIMER.md).

License: MIT

Local Model Context Protocol server for your ALLDATA repair subscription. Runs on your machine, uses your login/session, and exposes search, labor times, procedures, TSBs, DTCs, and wiring helpers to an AI agent (Grok, Hermes, Claude, etc.).

What it does

Requirements

• Python ≥ 3.10

• Active ALLDATA subscription you are authorized to use

• Optional: Playwright Chromium for SPA-heavy paths

Install

git clone <this-repo-url> alldata-mcp-server
cd alldata-mcp-server
pip install -e .
# optional SPA support:
pip install playwright browser-cookie3
playwright install chromium

Register with your agent host (examples):

# ~/.grok/config.toml
[mcp_servers.alldata]
command = "alldata-mcp"
enabled = true

hermes mcp add alldata --command alldata-mcp

Authentication (local cookies)

Secrets never belong in git. Default cookie file:

~/.config/alldata_cookies.json

Recommended: AI-assisted browser import

1. Log into https://my.alldata.com in a browser on this computer.

2. When the agent asks, tell it which browser (e.g. brave, chrome, firefox).

3. Agent calls import_browser_cookies(browser="brave") only after you consent.

4. Cookies are written on disk under your home directory and used for subsequent API calls.

CLI (same thing)

python scripts/export_browser_cookies.py --browser brave
# → ~/.config/alldata_cookies.json

Env (optional)

Data handling

• Cookie export and session files stay on your device.

• Network calls go to ALLDATA hosts for the subscription you already use.

• The authors do not operate a backend that harvests your credentials.

• Full terms: DISCLAIMER.md.

Honda / truck note

For CR-V, Pilot, Ridgeline, Odyssey, Passport, HR-V, etc., pass make="Honda Truck".

Pair with shop quoting

Use with azpro (commercial cost + list) and the shop-quote skill for full RO format.

Development

pytest -q

License

MIT — see LICENSE.