Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Harristeeter MCP

by chrischallversion 0.3.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.chrischall/harristeeter-mcp

How to install

What it does

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

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Online shops & payments

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Harristeeter MCP. Follow https://mcp.popnx.com/i/chrischall-harristeeter-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Harristeeter MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "harristeeter": { "command": "npx", "args": [ "-y", "@chrischall/harristeeter-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Harristeeter MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "harristeeter": {
          "command": "npx",
          "args": [
            "-y",
            "@chrischall/harristeeter-mcp"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use Harristeeter MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Harristeeter MCP or shows a Harristeeter MCP tool in the answer, you are connected

9 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • HARRISTEETER_WS_PORT Override the fetchproxy WebSocket port (default 37149).
  • HARRISTEETER_DEBUG Set to 1 for verbose bridge logging to stderr.
  • MCP_USER_TZ IANA time zone sent with pickup-time requests (default America/New_York).
  • KROGER_API_CLIENT_ID Optional Kroger developer app id: product search and prices without the browser.
  • KROGER_API_CLIENT_SECRET Optional Kroger developer app secret.
  • HARRISTEETER_LOCATION_ID Optional 8-digit store id for bridge-free search; a store saved with ht_set_store wins.
  • HARRISTEETER_STATE_DIR Where the saved and remembered store live (default ~/.harristeeter-mcp).
  • FETCHPROXY_WS_HOST 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.
  • FETCHPROXY_IDENTITY_DIR 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.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Harristeeter MCP yet

Harristeeter MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Harristeeter MCP

  • Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)
  • Install Node.js on your computer first (one time)

B · Others in Online shops & payments that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Harristeeter MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user harristeeter -- npx -y @chrischall/harristeeter-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Harristeeter MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user harristeeter -- npx -y @chrischall/harristeeter-mcp
  4. Type /mcp in Claude Code

    You should see Harristeeter MCP listed as connected

  5. Try it

    Use Harristeeter MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Harristeeter MCP or shows a Harristeeter MCP tool in the answer, you are connected

9 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • HARRISTEETER_WS_PORT Override the fetchproxy WebSocket port (default 37149).
  • HARRISTEETER_DEBUG Set to 1 for verbose bridge logging to stderr.
  • MCP_USER_TZ IANA time zone sent with pickup-time requests (default America/New_York).
  • KROGER_API_CLIENT_ID Optional Kroger developer app id: product search and prices without the browser.
  • KROGER_API_CLIENT_SECRET Optional Kroger developer app secret.
  • HARRISTEETER_LOCATION_ID Optional 8-digit store id for bridge-free search; a store saved with ht_set_store wins.
  • HARRISTEETER_STATE_DIR Where the saved and remembered store live (default ~/.harristeeter-mcp).
  • FETCHPROXY_WS_HOST 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.
  • FETCHPROXY_IDENTITY_DIR 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.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Harristeeter MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "harristeeter": { "command": "npx", "args": [ "-y", "@chrischall/harristeeter-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Harristeeter MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use Harristeeter MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Harristeeter MCP or shows a Harristeeter MCP tool in the answer, you are connected

9 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • HARRISTEETER_WS_PORT Override the fetchproxy WebSocket port (default 37149).
  • HARRISTEETER_DEBUG Set to 1 for verbose bridge logging to stderr.
  • MCP_USER_TZ IANA time zone sent with pickup-time requests (default America/New_York).
  • KROGER_API_CLIENT_ID Optional Kroger developer app id: product search and prices without the browser.
  • KROGER_API_CLIENT_SECRET Optional Kroger developer app secret.
  • HARRISTEETER_LOCATION_ID Optional 8-digit store id for bridge-free search; a store saved with ht_set_store wins.
  • HARRISTEETER_STATE_DIR Where the saved and remembered store live (default ~/.harristeeter-mcp).
  • FETCHPROXY_WS_HOST 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.
  • FETCHPROXY_IDENTITY_DIR 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.

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Harristeeter MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "harristeeter": { "type": "stdio", "command": "npx", "args": [ "-y", "@chrischall/harristeeter-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Harristeeter MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use Harristeeter MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Harristeeter MCP or shows a Harristeeter MCP tool in the answer, you are connected

9 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • HARRISTEETER_WS_PORT Override the fetchproxy WebSocket port (default 37149).
  • HARRISTEETER_DEBUG Set to 1 for verbose bridge logging to stderr.
  • MCP_USER_TZ IANA time zone sent with pickup-time requests (default America/New_York).
  • KROGER_API_CLIENT_ID Optional Kroger developer app id: product search and prices without the browser.
  • KROGER_API_CLIENT_SECRET Optional Kroger developer app secret.
  • HARRISTEETER_LOCATION_ID Optional 8-digit store id for bridge-free search; a store saved with ht_set_store wins.
  • HARRISTEETER_STATE_DIR Where the saved and remembered store live (default ~/.harristeeter-mcp).
  • FETCHPROXY_WS_HOST 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.
  • FETCHPROXY_IDENTITY_DIR 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.

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Harristeeter MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user harristeeter -- npx -y @chrischall/harristeeter-mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

Values you fill in

  • HARRISTEETER_WS_PORT env
    Override the fetchproxy WebSocket port (default 37149).
  • HARRISTEETER_DEBUG env
    Set to 1 for verbose bridge logging to stderr.
  • MCP_USER_TZ env
    IANA time zone sent with pickup-time requests (default America/New_York).
  • KROGER_API_CLIENT_ID env
    Optional Kroger developer app id: product search and prices without the browser.
  • KROGER_API_CLIENT_SECRET secret env
    Optional Kroger developer app secret.
  • HARRISTEETER_LOCATION_ID env
    Optional 8-digit store id for bridge-free search; a store saved with ht_set_store wins.
  • HARRISTEETER_STATE_DIR env
    Where the saved and remembered store live (default ~/.harristeeter-mcp).
  • FETCHPROXY_WS_HOST env
    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.
  • FETCHPROXY_IDENTITY_DIR env
    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.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
0.3.0
Published to registryi
Nov 12, 2026
Code last changedi
Nov 18, 2026
Maker
chrischall
Packages
npm: @chrischall/harristeeter-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account chrischall, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for @chrischall/harristeeter-mcp@0.3.0

Checks only this package version, not every dependency · checked Nov 16, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/chrischall-harristeeter-mcp.svg)](https://mcp.popnx.com/en/servers/chrischall-harristeeter-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Online shops & paymentsi

  • More stars than 0% of the other 2985 servers in this category
  • Published to the registry more recently than 79% of the other 2985 servers in this category
  • Basic checks equal to or better than 99% of the other 2985 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Harristeeter MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 2 days ago, and the latest version (0.3.0) reached the registry 8 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Stripe MCP

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

by stripeWidely used★ 2.1KUpdated 13 months ago

Runs in the cloud✓ service owner · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

by flightclawGrowing★ 87Updated 2 months ago

Runs in the cloud✓ service owner · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

by trade-it-incGrowing★ 62Updated 35 days ago

Runs in the cloud✓ service owner · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

by idealoEarly★ 28Updated 6 months ago

Runs in the cloud✓ service owner · mcp.idealo.com
Compared with similar ones
This one
Harristeeter MCP
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesNoNoNoNo
Basic checks3/34/44/45/54/44/4
LicenseMITMITMITCC0-1.0MITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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