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

Connector pinouts (fast)

When ALLDATA has no single pinout article for a harness connector (e.g. Toyota IA8):

# Offline fixtures / local Non-OE SVGs
python -m alldata_mcp_server.pinout_cli --connector IA8 \
  --fixture-dir tests/fixtures/pinout --carid 54401

# Live Non-OE multi-system scan (cookies required)
python -m alldata_mcp_server.pinout_cli --connector IA8 --live \
  --year 2015 --make Toyota --model Camry --engine "L4-2.5L (2AR-FE)"

Or MCP: build_connector_pinout(connector="IA8", year=2015, make="Toyota", model="Camry", ...).

Output includes pin, wire color, and far end (module name, or other connector pin + color).
Cache: ~/.cache/alldata-pinouts (40 MiB cap). Disk hygiene: live scans set ALLDATA_WIRING_EPHEMERAL=1 so SVGs land under ~/.cache/alldata-pinouts/work, are deleted after each diagram extract, and the work/raw dirs + carid wiring dumps are wiped at the end of every pinout run (keep_raw=False default). Only small extract JSON + connector→systems index is retained (for faster re-scans).

Related MCP server: agentify-desktop

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.