<<<<<<< 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