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
