<<<<<<< HEAD

MCPizza - Domino's Pizza Ordering MCP Server

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

🍕 Features

Store Locator: Find nearest Domino's stores by address/zip code
Menu Browsing: Search for pizzas, wings, sides, and more
Order Management: Add items to cart and calculate totals
Customer Info: Handle delivery addresses and contact information
Safe Preview: Prepare orders without placing them (safety first!)

🚀 Quick Demo

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

📦 Installation

See INSTALLATION.md for detailed setup instructions.

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

Tool	Description
`find_dominos_store`	Find nearest Domino's location
`get_store_menu_categories`	Get menu categories
`search_menu`	Search for specific menu items
`add_to_order`	Add items to your pizza order
`view_order`	View current order contents
`set_customer_info`	Set delivery information
`calculate_order_total`	Get order total with tax/fees
`prepare_order`	Prepare order for placement (safe mode)

🎯 Usage Examples

# 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
})

⚠️ Safety & Disclaimers

Real order placement is DISABLED by default for safety
Uses unofficial Domino's API for educational purposes only
All order functionality works except final placement step
Use responsibly and in accordance with Domino's terms of service

🔧 Integration

Ready to integrate with MCP clients! The server provides a complete pizza ordering workflow while maintaining safety through disabled order placement.

📝 Requirements

Python 3.9+
pizzapi package for Domino's API access
Valid address for store lookup
Internet connection for API calls

Built with ❤️ for the MCP ecosystem

MCPizza

README Documentation