autozonepro-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 MCP server for your AutoZone Pro commercial account. HTTP-first catalog/session client that returns commercial cost and list price for shop quoting.

What it does

Tool	Purpose
get_session_status	Auth, shop, store, sticky vehicle
list_vehicles	Garage / VIN-saved vehicles
lookup_vin	VIN → YMME + ACES ids
search_parts	Keyword/PN search; cost + list_price
list_group_products	Part-group catalog (pads, rotors, etc.)
get_prices	Refresh cost/list/core/store qty
list_categories	Top-level categories
import_browser_cookies	Optional local auth from a browser you name

Quote rule: when building a job quote, always show cost and list side-by-side. Cost = what the shop pays; list = street/list.

Requirements

• Python ≥ 3.10
• AutoZone Pro commercial access you are authorized to use
• Optional: browser-cookie3 for one-shot cookie export

Install

git clone <this-repo-url> autozonepro-mcp-server
cd autozonepro-mcp-server
pip install -e .
pip install browser-cookie3   # for cookie import

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

hermes mcp add azpro --command azpro-mcp

Authentication (local cookies)

Do not commit cookie files. Default path:

~/.config/autozonepro_cookies.json

Recommended: AI-assisted browser import

1. Log into https://www.autozonepro.com in a browser on this computer.
2. When asked, name that browser (brave, chrome, firefox, …).
3. Agent runs import_browser_cookies(browser="brave") only after you say yes.
4. Session JWT is obtained via AZ Pro session APIs using those cookies—still local config + HTTPS to AutoZone.

CLI

python scripts/export_browser_cookies.py --browser brave

Env

Variable	Meaning
AZPRO_COOKIES_FILE	Cookie JSON path (default above)
AZPRO_COOKIES	Inline JSON (prefer file)

Data handling

• Cookie export is local and opt-in.
• Traffic goes to AutoZone Pro APIs for your commercial account.
• Authors do not collect or resell your credentials.
• Full terms: DISCLAIMER.md.

Pair with labor + RO skill

• alldata MCP → labor hours
• shop-quote skill → dual-price RO templates

Development

pytest -q

License

MIT — see LICENSE.