Mcpizza

🚀 MCPizza - Domino's Pizza Ordering MCP Server

An MCP (Model Context Protocol) server that allows AI assistants to order pizza via the unofficial Domino's API.

✨ Features

• Store Locator: Locate the nearest Domino's stores by address or zip code.
• Menu Browsing: Search for pizzas, wings, sides, and other items.
• Order Management: Add items to the cart and calculate the total cost.
• Customer Info: Manage delivery addresses and contact information.
• Safe Preview: Prepare orders without actually placing them (safety first!).

🚀 Quick Start

# See it in action with mock data
python mcpizza/demo_no_real_api.py

📦 Installation

For detailed setup instructions, refer to INSTALLATION.md.

Quick start:

# Install uv package manager
curl -LsSf https://astral.sh/uv/install.sh | sh

# Setup environment
uv venv && source .venv/bin/activate
uv pip install pizzapi requests pydantic

# Run demo
python mcpizza/demo_no_real_api.py

💻 Available MCP Tools

💻 Usage Examples

Basic Usage

# Find store
result = server.call_tool("find_dominos_store", {"address": "10001"})

# Search for pizza
result = server.call_tool("search_menu", {"query": "pepperoni pizza"})

# Add to order
result = server.call_tool("add_to_order", {
    "item_code": "M_PEPPERONI", 
    "quantity": 1
})

⚠️ Important Note

• Real order placement is DISABLED by default for safety reasons.
• This server uses the unofficial Domino's API for educational purposes only.
• All order functionality works except for the final placement step.
• Use this tool responsibly and in accordance with Domino's terms of service.

🔧 Integration

Ready to integrate with MCP clients! The server offers a complete pizza ordering workflow while ensuring safety by disabling order placement.

📋 Requirements

• Python 3.9+
• pizzapi package for Domino's API access
• A valid address for store lookup
• An internet connection for API calls

Built with ❤️ for the MCP ecosystem