mcpizza

GrahamMcBain/mcpizza

3.3

If you are the rightful owner of mcpizza and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCPizza is an MCP server designed to facilitate AI assistants in ordering pizza through the unofficial Domino's API.

Tools

  1. find_dominos_store

    Find nearest Domino's location

  2. get_store_menu_categories

    Get menu categories

  3. search_menu

    Search for specific menu items

  4. add_to_order

    Add items to your pizza order

  5. view_order

    View current order contents

  6. set_customer_info

    Set delivery information

  7. calculate_order_total

    Get order total with tax/fees

  8. prepare_order

    Prepare order for placement (safe mode)

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

ToolDescription
find_dominos_storeFind nearest Domino's location
get_store_menu_categoriesGet menu categories
search_menuSearch for specific menu items
add_to_orderAdd items to your pizza order
view_orderView current order contents
set_customer_infoSet delivery information
calculate_order_totalGet order total with tax/fees
prepare_orderPrepare 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