Back to Browse

Harristeeter MCP Server

Developer ToolsModerate7.2LocalNew
Free

Harris Teeter grocery pickup — search, cart, pickup times and checkout via your browser

About

Harris Teeter grocery pickup — search, cart, pickup times and checkout via your browser

Security Report

7.2
Moderate7.2Low Risk

The harristeeter-mcp server drives the user's own signed-in harristeeter.com browser tab through the ContextMint Bridge rather than storing credentials, and it explicitly stops short of placing orders, with confirmation gating on writes. Findings are limited to code-quality and disclosure items: a dependency on a third-party bridge extension that carries session cookies, pharmacy data access, and the truncated pharmacy file that could not be fully reviewed. Permissions broadly match a grocery and pharmacy assistant's purpose. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

5 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Override the fetchproxy WebSocket port (default 37149).Optional

Environment variable: HARRISTEETER_WS_PORT

Set to 1 for verbose bridge logging to stderr.Optional

Environment variable: HARRISTEETER_DEBUG

IANA time zone sent with pickup-time requests (default America/New_York).Optional

Environment variable: MCP_USER_TZ

Optional Kroger developer app id: product search and prices without the browser.Optional

Environment variable: KROGER_API_CLIENT_ID

Optional Kroger developer app secret.Required

Environment variable: KROGER_API_CLIENT_SECRET

Optional 8-digit store id for bridge-free search; a store saved with ht_set_store wins.Optional

Environment variable: HARRISTEETER_LOCATION_ID

Where the saved and remembered store live (default ~/.harristeeter-mcp).Optional

Environment variable: HARRISTEETER_STATE_DIR

Bind interface for the fetchproxy concentrator (default 127.0.0.1; a literal IP only). For a hosted child in its own network namespace only — never bind a laptop's concentrator to the network.Optional

Environment variable: FETCHPROXY_WS_HOST

Absolute path where fetchproxy stores its long-term identity keypair (default ~/.fetchproxy/identity/). For a host that runs a separate child per caller, so they share one identity.Optional

Environment variable: FETCHPROXY_IDENTITY_DIR

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "harristeeter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/harristeeter-mcp@0.3.0"
      ],
      "env": {
        "MCP_USER_TZ": "your-mcp-user-tz-here",
        "FETCHPROXY_WS_HOST": "your-fetchproxy-ws-host-here",
        "HARRISTEETER_DEBUG": "your-harristeeter-debug-here",
        "HARRISTEETER_WS_PORT": "your-harristeeter-ws-port-here",
        "KROGER_API_CLIENT_ID": "your-kroger-api-client-id-here",
        "HARRISTEETER_STATE_DIR": "your-harristeeter-state-dir-here",
        "FETCHPROXY_IDENTITY_DIR": "your-fetchproxy-identity-dir-here",
        "HARRISTEETER_LOCATION_ID": "your-harristeeter-location-id-here",
        "KROGER_API_CLIENT_SECRET": "your-kroger-api-client-secret-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

harristeeter-mcp

Harris Teeter for Claude: search groceries with prices at your store, build the cart, pick a pickup window and start checkout, clip digital coupons, read the weekly ad and your specials, check fuel points and past receipts, find recipes, manage shopping lists, browse and order from Order Ahead (deli, subs, pizza, platters), and check your prescriptions. You place grocery orders yourself on harristeeter.com. The MCP stops at a draft checkout with the real totals and hands you the link.

This project was developed and is maintained by AI (Claude Code). Use at your own discretion.

How it reaches Harris Teeter

harristeeter.com is Kroger's web platform behind Akamai bot protection, and it answers only a real browser. Every request therefore runs inside your own signed-in harristeeter.com tab through the ContextMint Bridge extension (the fetchproxy bridge), reusing your session. There are no credentials to configure.

  1. Install the ContextMint Bridge extension and sign in at https://www.harristeeter.com.
  2. Add the server (below) and call ht_healthcheck.
  3. Approve the pair code it shows in the extension popup, once.

If a second browser also runs ContextMint Bridge, stderr will show a fresh pair code on every call even though the call succeeds. Don't approve those; that's the other browser being refused.

Without the browser: Kroger's official API (optional)

Product search, prices and store lookup can run without the bridge through Kroger's official API. Register an app at developer.kroger.com and set KROGER_API_CLIENT_ID and KROGER_API_CLIENT_SECRET. ht_search_products, ht_get_products and ht_find_stores then call api.kroger.com directly, pricing against a store chosen in this order:

  1. a zip or locationId you pass for that one search;
  2. the store you saved with ht_set_store ("use my Park Road store");
  3. HARRISTEETER_LOCATION_ID;
  4. the store last seen in your browser, remembered whenever the bridge reads it, so the server keeps pricing at your store when the browser is closed;
  5. your browser's store, read live through the bridge.

ht_get_store shows which one is in use and why. Cart, pickup times and checkout always use the store chosen on harristeeter.com. Results have the same fields either way and say which source served them; the API prices produce per pound, and each API result says so. Everything else (cart, checkout, coupons, lists, Order Ahead, pharmacy) still needs the bridge: Kroger's API sign-in doesn't accept Harris Teeter accounts, so it can't act on your account.

Install

{
  "mcpServers": {
    "harristeeter": { "command": "npx", "args": ["-y", "@chrischall/harristeeter-mcp"] }
  }
}

Tools

ToolWhat it does
ht_search_productsSearch at your pickup store: UPC, name, brand, size, price, sale price, unit price, stock
ht_get_productsLook up UPCs
ht_find_storesHarris Teeter stores near a ZIP, with the 8-digit location id (needs Kroger API credentials)
ht_get_cartCart with names, prices, estimated subtotal
ht_add_to_cartAdd items by UPC (adds to existing quantity)
ht_update_cart_itemSet quantity / substitution preference (0 removes)
ht_remove_from_cartRemove items
ht_get_storeYour pickup store, and the store search prices against
ht_set_storeChoose the search store by ZIP, name or location id (or clear it)
ht_list_timeslotsOpen pickup windows and fees for the cart
ht_start_checkoutConfirmation-gated. Reserve a window and create the checkout, returning totals and the place-order link
ht_get_checkoutThe current checkout draft
ht_list_ordersPast purchases and receipts (each with a receiptKey)
ht_get_receiptOne purchase in full: items, price paid, savings, totals
ht_list_upcoming_ordersOrders placed but not yet picked up
ht_list_coupons / ht_clip_coupon / ht_unclip_coupone-VIC digital coupons
ht_list_specialsYour personalised My Specials
ht_get_weekly_adThis week's ad, by department or text
ht_get_fuel_pointsFuel points balance and expiry
ht_search_recipes / ht_get_recipeRecipes, with store products matched to ingredients
ht_list_shopping_lists / ht_get_shopping_list / ht_create_shopping_list / ht_rename_shopping_list / ht_delete_shopping_listShopping lists (delete is confirmation-gated)
ht_add_to_shopping_list / ht_remove_from_shopping_listAdd or remove list items by UPC
ht_oa_list_departments / ht_oa_list_menu / ht_oa_get_item / ht_oa_list_pickup_timesOrder Ahead menus and pickup times
ht_oa_place_orderConfirmation-gated. Place an Order Ahead order, paid at pickup. Not yet verified against a live order.
ht_rx_session / ht_rx_list_prescriptionsPharmacy: session status, prescriptions, refills remaining, due dates
ht_rx_request_refillConfirmation-gated. Request a refill, paid at the pharmacy. Not yet verified against a live refill.
ht_healthcheckBridge status

Cart tools change only your cart and can be undone, so they run without confirmation. ht_start_checkout reserves a pickup window, so it previews first and acts only when called again with the returned confirmToken.

Pharmacy needs its own sign-in

Opening harristeeter.com/rx asks you to sign in again (with a one-time code the first time on a browser). Pharmacy access then lasts one hour from sign-in, and nothing extends it. When it lapses the ht_rx_* tools say so; sign in again at https://www.harristeeter.com/rx/dashboard. If a pharmacy tab is open when the hour ends, the site signs you out of harristeeter.com entirely, so the grocery tools need a fresh sign-in too. Keep a regular harristeeter.com tab open as well, because the bridge can't send some requests from a pharmacy page.

Why it can't press "Place Order"

The site submits orders to a separate payment host from a hosted payment frame that attaches its own token plus fraud-screening and bot-detection data. Sending that from a server would mean faking those signals, so the final click stays with you. See docs/HT-API.md.

Configuration

VariableDefault
HARRISTEETER_WS_PORT37149fetchproxy concentrator port, shared by the whole fleet. Change only if you know why.
KROGER_API_CLIENT_ID / KROGER_API_CLIENT_SECRETunsetOptional Kroger developer app: search and prices without the browser
HARRISTEETER_LOCATION_IDunset8-digit store id for bridge-free search (below a saved ht_set_store choice)
HARRISTEETER_STATE_DIR~/.harristeeter-mcpWhere the saved and remembered store are kept
HARRISTEETER_DEBUGunset1 for verbose bridge logging to stderr
MCP_USER_TZAmerica/New_YorkIANA zone sent with pickup-time requests
MCP_CONFIRM_MODEask-userask-user (the model must get your OK in chat before using a token), auto, or refuse
MCP_CONFIRM_ELICITATIONonoff skips the client's confirmation prompt even when it supports one
MCP_CONFIRM_SECRETrandom per processFixed key for confirm tokens, so a token survives a restart

Skill

skills/harristeeter-fpx does the same reads and cart changes from a shell with the fpx CLI, with no MCP server.

License

MIT

Reviews

No reviews yet

Be the first to review this server!