partsgeek-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 public catalog / cart estimate workflows on PartsGeek. Designed for price comparison against shop commercial pricing—not for placing orders.

Safety hard rules

• Never checkout. No PayPal, Fastlane, cards, or Place Order.
• Cart page only (/cart/) for shipping / fee estimates.
• Do not open /checkout/ or payment UI.

What it does

Tool	Purpose
search_parts	Y/M/M + keyword → hits with clickable URLs + prices
get_product	Product detail (SKU, fitment, ships note, url)
cart_estimate	Add product URLs to cart; return subtotal + expedited + protection + S&H
clear_browser	Drop Playwright session / cookies

Default ship-to note for estimates (override when calling the tool):
18440 Paulson Drive, Port Charlotte, FL 33954 (example shop address—change for your shop).

Requirements

• Python ≥ 3.10
• Playwright Chromium
• No PartsGeek account required for basic search/cart estimate

Install

git clone <this-repo-url> partsgeek-mcp-server
cd partsgeek-mcp-server
pip install -e .
playwright install chromium

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

[mcp_servers.partsgeek.env]
PARTSGEEK_HEADLESS = "1"
PARTSGEEK_TIMEOUT = "180"

hermes mcp add partsgeek --command partsgeek-mcp \
  --env PARTSGEEK_HEADLESS=1 PARTSGEEK_TIMEOUT=180

Authentication

PartsGeek catalog browsing does not require a shop login. The tool drives a local headless browser on your machine for search/cart DOM only.

There is no import_browser_cookies step for PartsGeek accounts. If you ever log into PartsGeek in that browser profile, treat it like any other local session and do not commit cookie jars.

Data handling

• Runs entirely on your device (Playwright + HTTPS to PartsGeek).
• Authors do not operate a credential-collection backend.
• Full terms: DISCLAIMER.md.

Pair with shop quoting

Use azpro for commercial cost/list and alldata for labor. The shop-quote skill documents dual-source RO format and requires clickable product links for PartsGeek lines.

Development

pytest -q

License

MIT — see LICENSE.