<<<<<<< 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
Metadata
Release files for iflow-mcp_grahammcbain_mcpizza 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_grahammcbain_mcpizza-0.1.3.tar.gz | 7.4 kB | Without provenance | Details for iflow_mcp_grahammcbain_mcpizza-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_grahammcbain_mcpizza-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_grahammcbain_mcpizza-0.1.3-py3-none-any.whl |
Total release size: 15.9 kB
Release files / iflow_mcp_grahammcbain_mcpizza-0.1.3.tar.gz
| Download URL | iflow_mcp_grahammcbain_mcpizza-0.1.3.tar.gz |
|---|---|
| Size | 7.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2f0c31ad32567690e936d595fadd97fd75ddfd07ee3445e697629267eb81b7c9
|
|
BLAKE2b-256 checksum How to use checksums |
7d2aee4e0507db3fd12a643e50bbe04d2e143e2f7126e5da6ff3fd1f3e9d093b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_grahammcbain_mcpizza-0.1.3-py3-none-any.whl
| Download URL | iflow_mcp_grahammcbain_mcpizza-0.1.3-py3-none-any.whl |
|---|---|
| Size | 8.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dc58bb42af1de0f88b18adaef1f6fc56b8ebde139492fd29e54936c137755356
|
|
BLAKE2b-256 checksum How to use checksums |
7793246b0614641598476fa17eb1159ef43da809e895b4cdada97ab9c194de32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_grahammcbain_mcpizza 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.