mcp-publix

An MCP (Model Context Protocol) connector for Publix grocery stores. Provides tools for searching products, finding store locations, and browsing weekly deals.

Tools

product_search

Search for products available at Publix grocery stores.

Input:

• query (string, required): The product name or category to search for.

Example:

{ "query": "chicken" }

Returns: A list of matching products with name, price, and aisle location.

store_finder

Find Publix store locations near a zip code or city.

Input:

• location (string, required): A zip code or city name.

Example:

{ "location": "Atlanta" }

Returns: A list of nearby Publix stores with address, phone number, and hours.

weekly_deals

Get the current weekly deals and specials at Publix.

Input:

• category (string, optional): Filter deals by category. Available categories: produce, meat, dairy, snacks, beverages, bakery. Omit to retrieve deals across all categories.

Example:

{ "category": "produce" }

Returns: A list of sale items with original price, sale price, and savings amount.

Installation

From npm (once published)

npm install -g @striderlabs/mcp-publix

From source

git clone <repo-url>
cd mcp-publix
npm install
npm run build

Usage

As a standalone MCP server (stdio transport)

npx @striderlabs/mcp-publix
# or after global install:
mcp-publix

Claude Desktop configuration

Add the following to your claude_desktop_config.json:

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

Claude Code / MCP CLI

mcp add publix -- npx -y @striderlabs/mcp-publix

Development

npm install        # install dependencies
npm run build      # compile TypeScript with esbuild
npm pack           # create distributable tarball

License

MIT