Skip to main content
Glama

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

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.


Related MCP server: mcp-plu-upc

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

Available Tools

3 tools
store_finderA

Find Publix grocery store locations near a zip code or city. Returns store address, hours, and phone number.

NameRequiredDescriptionDefault
locationYesA zip code or city name to search near (e.g., "33130", "Miami", "Atlanta")
weekly_dealsA

Get the current weekly deals and specials at Publix. Optionally filter by category. Returns item name, original price, sale price, and savings.

NameRequiredDescriptionDefault
categoryNoOptional category to filter deals by (e.g., "produce", "meat", "dairy", "snacks", "beverages", "bakery"). Omit to get deals across all categories.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 3 tool updatesv1.0.0
    • First observedproduct_search
    • First observedstore_finder
    • First observedweekly_deals

TDQS

A3.7/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: product_search focuses on product details, store_finder on store locations, and weekly_deals on promotions. There is no overlap in functionality, making tool selection straightforward for an agent.

Naming Consistency5/5

All tool names follow a consistent snake_case pattern with clear, descriptive verb_noun combinations (product_search, store_finder, weekly_deals). This uniformity enhances readability and predictability.

Tool Count5/5

With 3 tools, this server is well-scoped for a grocery store assistant, covering key areas like product lookup, store location, and deals. Each tool earns its place without being overly sparse or bloated.

Completeness4/5

The toolset covers core grocery shopping needs—finding products, stores, and deals—with no obvious dead ends. A minor gap might be the lack of tools for managing a shopping list or checking inventory, but the existing tools support basic workflows effectively.

Related MCP Connectors

Related MCP Servers