MCP ExplorerExplorer

Mcpizza

@GrahamMcBainon 15 days ago
1 MIT
FreeCommunity
AI Systems
An MCP server for ordering Pizza

Overview

What is Mcpizza

MCPizza is an MCP server designed for ordering pizza through the unofficial Domino’s API, enabling AI assistants to facilitate the ordering process.

Use cases

Use cases for MCPizza include finding nearby Domino’s locations, searching for specific menu items, adding items to an order, and preparing orders in a safe mode without finalizing them.

How to use

To use MCPizza, install the necessary packages, set up the environment, and run the demo script to see its functionalities in action. You can interact with the server using predefined tools to find stores, browse menus, and manage orders.

Key features

Key features include a store locator, menu browsing capabilities, order management tools, customer information handling, and a safe preview mode for preparing orders without placing them.

Where to use

MCPizza can be used in various domains including AI development, chatbot integration, and educational projects focused on API interactions and order management systems.

Content

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

Tools

No tools

Comments