Azure FinOps Optimizer MCP

Azure FinOps Elite

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://github.com/jlowin/fastmcp)

Production-grade Azure FinOps MCP Server for Enterprise Cost Optimization

> 💰 Proven Results: Organizations using Azure FinOps Elite achieve an average 20% reduction in cloud costs within the first 90 days.

---

⭐ Star This Repository

If you find Azure FinOps Elite valuable, please star this repository to help others discover it!

💖 Support This Project

Azure FinOps Elite is free and open-source. If it saves you money or time, please consider:

• ⭐ Starring this repository
• 💰 Sponsoring via GitHub Sponsors
• 🐛 Reporting bugs and suggesting features
• 📝 Contributing code or documentation

Your support helps maintain and improve this project!

---

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/YOUR_USERNAME/azure-finops-elite.git
cd azure-finops-elite

# Install dependencies
pip install -r requirements.txt

# Configure credentials
cp .env.example .env
# Edit .env with your Azure credentials

Web Dashboard (Recommended)

# Start the web dashboard
python web_dashboard.py

# Open browser to http://localhost:5000

MCP Server (For AI Assistants)

# Start the MCP server
python server.py

---

✨ Features

🔍 Enterprise Anomaly Detection

Detect daily spend spikes across multiple subscriptions by comparing actual costs vs. 7-day historical averages.

🏢 CSP Multi-Tenant Audit

Audit delegated sub-tenants to identify unattached disks and idle public IPs with immediate ROI.

💰 Pre-Deployment Budget Validation

Validate ARM/Bicep templates against Azure Price Sheet API before execution.

🛡️ Governance & Compliance Advisor

Azure Advisor integration with custom risk scoring based on NIA Qatar and ISO 27001 frameworks.

📊 Executive Summary Generator

Generate Markdown-formatted FinOps ROI reports for non-technical stakeholders.

⚖️ Compliance Overlay

Automatically flag cost-saving recommendations that may impact ISO 27001 or NIA Qatar controls.

🚀 One-Click Setup

Generate ready-to-use Azure Custom Role JSON with least-privilege read-only access.

---

🌐 Web Dashboard

Beautiful GUI for all FinOps tools:

• Configuration Management - Set Azure credentials via web interface
• Real-time Analysis - Run tools and see results instantly
• Report Generation - Create and download executive summaries
• Report History - Browse and manage all generated reports

---

🔐 Enterprise Security

• ✅ Zero Trust Architecture
• ✅ Certificate-based Authentication
• ✅ ISO 27001 Compliant
• ✅ NIA Qatar Framework Support
• ✅ Least-Privilege RBAC
• ✅ Comprehensive Audit Logging

---

📚 Documentation

• [Quick Start](QUICKSTART.md) - Get started in 5 minutes
• [Windows Testing Guide](WINDOWS_TESTING.md) - Complete Windows setup
• [Web Dashboard Guide](WEB_DASHBOARD.md) - Using the GUI
• [Security Guide](security_guide.md) - Authentication & compliance
• [Customer Experience](CUSTOMER_EXPERIENCE.md) - Advanced features
• [Agent Guide](agent.md) - FinOps automation workflows

---

🎯 Use Cases

For Enterprises

• Monitor cloud costs across multiple subscriptions
• Detect anomalies before they impact budgets
• Ensure compliance with ISO 27001 and regional frameworks
• Generate executive reports for stakeholders

For CSPs (Cloud Service Providers)

• Audit customer tenants for cost optimization
• Demonstrate value through savings reports
• Automate resource cleanup recommendations
• Maintain compliance across customer environments

For DevOps Teams

• Validate infrastructure costs in CI/CD pipelines
• Prevent budget overruns before deployment
• Integrate cost governance into workflows
• Track and optimize resource usage

---

🏗️ Architecture

azure-finops-elite/
├── server.py                    # FastMCP server (for AI assistants)
├── web_dashboard.py             # Flask web dashboard (for humans)
├── auth.py                      # Certificate + Managed Identity auth
├── azure_clients.py             # Azure SDK client factory
├── tools/
│   ├── anomaly_detector.py     # Spend spike detection
│   ├── csp_auditor.py          # Multi-tenant resource audit
│   ├── budget_validator.py     # ARM/Bicep cost validation
│   ├── governance_advisor.py   # Risk-scored recommendations
│   ├── executive_summary.py    # Executive ROI reports
│   └── compliance_overlay.py   # Compliance impact checker
├── utils/
│   ├── error_handling.py       # Retry logic & rate limiting
│   ├── logging_config.py       # Structured logging
│   └── pricing.py              # Cost estimation
└── templates/
    └── dashboard.html          # Web dashboard UI

---

🤝 Contributing

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

Development Setup

# Install dev dependencies
pip install -r requirements.txt
pip install pytest black isort mypy

# Run tests
pytest

# Format code
black .
isort .

---

📊 Metrics & KPIs

Track your FinOps success:

• Cost Optimization: Anomalies detected, excess spend prevented
• Resource Efficiency: Unattached resources identified and removed
• Compliance: Risk score improvements, control coverage
• ROI: Total savings vs. tool investment

---

🌟 Success Stories

> "Azure FinOps Elite helped us identify $50K/month in wasteful spending within the first week. The executive summaries made it easy to get buy-in from leadership." > — Enterprise Customer

> "As a CSP, this tool helps us demonstrate value to our customers. The compliance overlay ensures we never compromise security for cost savings." > — Cloud Service Provider

---

📜 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

💬 Support

• 📖 Documentation: Check the [docs](README.md)
• 🐛 Bug Reports: Open an issue
• 💡 Feature Requests: Open an issue
• 💰 Sponsorship: GitHub Sponsors

---

🙏 Acknowledgments

Built with:

• FastMCP - Model Context Protocol framework
• Azure SDK for Python - Azure API integration
• Flask - Web dashboard framework

---

⚡ Quick Links

• [Installation](#installation)
• [Web Dashboard](#web-dashboard)
• [Documentation](#documentation)
• [Contributing](#contributing)
• [Support This Project](#support-this-project)

---

Made with ❤️ for the FinOps community

⭐ Star this repo | 💰 Sponsor | [📖 Docs](README.md)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: mazhar480
• Source: mazhar480/Azure-FinOps-Optimizer-MCP
• License: MIT

Install and usage instructions live in the source repository linked above.