Texas MCP Server

MCP server for HEB grocery store integration - search products, manage carts, clip coupons, and more

Local serverstdio

What is the Texas MCP server?

Texas MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. MCP server for HEB grocery store integration - search products, manage carts, clip coupons, and more.

What you get

⚠️ This project is not affiliated with H-E-B. It uses unofficial web APIs and browser automation against HEB.com; use responsibly and ensure your usage complies with applicable terms and laws.

What the assistant can call

Once Texas is connected, these are the calls the assistant has available:

  • store_search — Find stores by address
  • store_change — Set preferred store
  • store_get_default — Get current default store
  • product_search — Search products with pricing
  • product_search_batch — Search multiple products (up to 20)
  • product_get — Get detailed product info
  • cart_check_auth — Check authentication status
  • cart_get — View cart contents
  • cart_add — Add item (requires confirmation)
  • cart_add_many — Bulk add multiple items
  • cart_remove — Remove item
  • coupon_list — List available coupons

Configuration and credentials

You will need 2 environment variables: HEB_DEFAULT_STORE, REDIS_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

For cart operations and session management, you'll also need Playwright MCP: ---

Setting it up

Installation goes through your MCP client rather than a global install: point it at @anthropic-ai/mcp-playwright on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Texas's toolset — store_search, store_change, store_get_default and 11 more — is a fair guide to whether it matches your workflow. It is maintained by mgwalkerjr95; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Texas's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Texas.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the texas mcp server does with a few real requests.

Available tools

ToolWhat it does
store_searchFind stores by address
store_changeSet preferred store
store_get_defaultGet current default store
product_searchSearch products with pricing
product_search_batchSearch multiple products (up to 20)
product_getGet detailed product info
cart_check_authCheck authentication status
cart_getView cart contents
cart_addAdd item (requires confirmation)
cart_add_manyBulk add multiple items
cart_removeRemove item
coupon_listList available coupons
coupon_searchSearch coupons by keyword
coupon_clipClip a coupon

How to install the Texas MCP server

{
  "mcpServers": {
    "texas-grocery": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-playwright"],
      "env": {
        "HEB_DEFAULT_STORE": "your-value",
        "REDIS_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

For cart operations and session management, you'll also need Playwright MCP: ---

VariableDescriptionRequired
HEB_DEFAULT_STOREConfiguration value read at startup.Optional
REDIS_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Texas to store search.
  • Use Texas to store change.
  • Use Texas to store get default.

Frequently asked questions

It connects Texas to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (store_search, store_change, store_get_default, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Texas directly.