MCP Azure Pricing

🚀 Azure Pricing MCP Server

This project offers a Model Context Protocol (MCP) server, enabling you to programmatically query the pricing of Azure resources. It provides a structured workflow to retrieve pricing information from the Azure Retail Prices API.

🚀 Quick Start

The MCP server offers a four - step structured workflow for getting Azure pricing information:

1. Get service families: Retrieve the list of available Azure service families.
2. Get service names: Get service names within a specific family.
3. Get products: Get products associated with a service.
4. Calculate monthly costs: Calculate the monthly cost for a specific product.

To start the MCP server:

source .venv/bin/activate  # Activate the virtual environment
python azure_pricing_mcp_server.py

The server will start at http://0.0.0.0:8080 by default.

✨ Features

• Query Azure pricing data via a simple, structured workflow.
• Obtain real - time pricing information from the Azure Retail Prices API.
• Navigate through Azure service families, service names, and products.
• Calculate monthly costs for Azure resources.

📦 Installation

1. Clone the repository:

   git clone https://github.com/sboludaf/mcp-azure-pricing.git
   cd mcp-azure-pricing
   

2. Create and activate a virtual environment:

   python -m venv .venv
   

   • Windows:

     .venv\Scripts\activate
     

   • macOS/Linux:

     source .venv/bin/activate
     

3. Install the dependencies:

   pip install -r requirements.txt
   

💻 Usage Examples

Basic Usage

The basic steps to use the MCP server are as described in the quick - start section.

Advanced Usage

To configure an MCP client to connect to this server, add the following to your mcp_config.json file:

"azure-pricing": {
  "serverUrl": "http://localhost:8080/sse"
}

This configuration tells the MCP client to connect to the local server on port 8080 using the SSE endpoint. Ensure the URL matches the address and port your server is running on.

📚 Documentation

Available Endpoints

• GET /sse: Server - Sent Events endpoint for MCP communication.
• GET /tools: Lists the available tools in the MCP server.

MCP Tools

The server provides four main tools for querying Azure pricing:

1. list_service_families

Description: Lists all available service families in Azure according to Microsoft's official documentation.

2. get_service_names

Description: Gets all unique service names within a specified service family.

Parameters:

• service_family: The service family to query (e.g., 'Compute', 'Storage').
• region: Azure region (default: 'westeurope').
• max_results: Maximum number of results to process.

3. get_products

Description: Gets product names from a specific service family.

Parameters:

• service_family: The service family to query.
• region: Azure region (default: 'westeurope').
• type: Price type (optional, e.g., 'Consumption', 'Reservation').
• service_name: Service name to filter by (optional).
• product_name_contains: Filter products whose name contains this text (optional).
• limit: Maximum number of products to return (optional).

4. get_monthly_cost

Description: Calculates the monthly cost of a specific Azure product.

Parameters:

• product_name: Exact name of the product (e.g., 'Azure App Service Premium v3 Plan').
• region: Azure region (default: 'westeurope').
• monthly_hours: Number of hours per month (default: 730).
• type: Price type (optional, e.g., 'Consumption').

🔧 Technical Details

Error Handling

The MCP server has a robust error - handling system that:

• Provides descriptive error messages when resources cannot be found.
• Properly handles Azure API errors.
• Logs detailed information for debugging purposes.

Common Error Scenarios

• Product not found: When a product name doesn't exist in the specified region.
• Service family not found: When an invalid service family is specified.
• API rate limits: When the Azure Retail Prices API rate limits are exceeded.
• Network errors: When the server cannot connect to the Azure API.

Limitations

• Prices are estimates based on public information from the Azure Retail Prices API.
• Does not include all possible discounts, account - specific offers, or additional costs like taxes or support.
• The Azure Retail Prices API has rate limits that can affect performance with a high volume of requests.
• Prices may vary depending on the region and currency selected.
• Not all Azure resources are available in all regions.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Contributing

Contributions are welcome! Here's how you can contribute to this project:

1. Fork the repository.
2. Create a feature branch: git checkout -b feature/amazing - feature.
3. Commit your changes: git commit -m 'Add some amazing feature'.
4. Push to the branch: git push origin feature/amazing - feature.
5. Open a Pull Request.