Azure Pricing MCP Server 💰
A Model Context Protocol (MCP) server that provides tools for querying Azure retail pricing information using the Azure Retail Prices API.
🚀 Quick Start
- Clone/Download this repository
- Run setup:
setup.ps1(Windows PowerShell) orpython setup.py(Cross-platform) - Configure Claude Desktop (see QUICK_START.md)
- Ask Claude: "What's the price of a Standard_D2s_v3 VM in East US?"
✨ Features
- 🔍 Azure Price Search: Search for Azure service prices with flexible filtering
- ⚖️ Service Comparison: Compare prices across different regions and SKUs
- 💡 Cost Estimation: Calculate estimated costs based on usage patterns
- 💰 Savings Plan Information: Get Azure savings plan pricing when available
- 🌍 Multi-Currency: Support for multiple currencies (USD, EUR, etc.)
- 📊 Real-time Data: Uses live Azure Retail Prices API
🛠️ Tools Available
| Tool | Description | Example Use |
|---|---|---|
azure_price_search | Search Azure retail prices with filters | Find VM prices in specific regions |
azure_price_compare | Compare prices across regions/SKUs | Compare storage costs across regions |
azure_cost_estimate | Estimate costs based on usage | Calculate monthly costs for 8hr/day usage |
azure_discover_skus | Discover available SKUs for a service | Find all VM types for a service |
azure_sku_discovery | Intelligent SKU discovery with fuzzy matching | "Find app service plans" or "web app pricing" |
📋 Installation
Automated Setup (Recommended)
# Windows PowerShell
.\setup.ps1
# Cross-platform (Python)
python setup.py
Manual Setup
# Create virtual environment
python -m venv .venv
# Activate virtual environment
.venv\Scripts\activate # Windows
source .venv/bin/activate # Linux/Mac
# Install dependencies
pip install -r requirements.txt
🔧 Configuration
Add to your Claude Desktop config file:
{
"mcpServers": {
"azure-pricing": {
"command": "python",
"args": ["-m", "azure_pricing_server"],
"cwd": "/path/to/azure_pricing"
}
}
}
💬 Example Queries
Once configured with Claude, you can ask:
- Basic Pricing: "What's the price of Azure SQL Database?"
- Comparisons: "Compare VM prices between East US and West Europe"
- Cost Estimation: "Estimate costs for running a D4s_v3 VM 12 hours per day"
- Savings: "What are the reserved instance savings for virtual machines?"
- GPU Pricing: "Show me all GPU-enabled VMs with pricing"
- Service Discovery: "Find all App Service plan pricing" or "What storage options are available?"
- SKU Discovery: "Show me all web app hosting plans"
🧪 Testing
Test setup and connectivity:
# Windows PowerShell
.\test_setup.ps1
# Cross-platform test
python -m azure_pricing_server --test
📚 Documentation
- QUICK_START.md - Step-by-step setup guide
- USAGE_EXAMPLES.md - Detailed usage examples and API responses
- config_examples.json - Example configurations for Claude Desktop and VS Code
🔌 API Integration
This server uses the official Azure Retail Prices API:
- Endpoint:
https://prices.azure.com/api/retail/prices - Version:
2023-01-01-preview(supports savings plans) - Authentication: None required (public API)
- Rate Limits: Generous limits for retail pricing data
🌟 Key Features
Smart Filtering
- Filter by service name, family, region, SKU
- Support for partial matches and contains operations
- Case-sensitive filtering for precise results
Cost Optimization
- Automatic savings plan detection
- Reserved instance pricing comparisons
- Multi-region cost analysis
- Intelligent SKU discovery for finding the best pricing options
Developer Friendly
- Comprehensive error handling
- Detailed logging for troubleshooting
- Flexible parameter support
- Cross-platform setup scripts (PowerShell and Python)
🤝 Contributing
This project follows the Spec-Driven Development (SDD) methodology. Contributions are welcome!
- Fork the repository
- Create a feature branch
- Add tests for new functionality
- Submit a pull request
📄 License
MIT License - see LICENSE file for details
🙋♂️ Support
- Check QUICK_START.md for setup issues
- Review USAGE_EXAMPLES.md for query patterns
- Open an issue for bugs or feature requests
Built with the Model Context Protocol (MCP) for seamless integration with Claude and other AI assistants.