🌂 Umbrella MCP Server

A Model Context Protocol (MCP) server that provides read-only access to the Umbrella Cost finops SaaS platform. This server enables natural language querying of your cloud cost and usage data through LLM clients.

🚀 Features

• 🔐 Secure Authentication: Support for both MSP and Direct customer accounts

• 📊 Cost Analysis: Query cost and usage data across AWS, Azure, and GCP

• 🎯 Cost Optimization: Access recommendations and savings opportunities

• 🚨 Anomaly Detection: Monitor cost spikes and unusual spending patterns

• 💰 Budget Management: Track budgets and alerts

• 📈 Resource Analytics: Analyze EC2, S3, RDS, and Kubernetes costs

• 🏢 Multi-Tenant Support: MSP customer management capabilities

• 🔍 Read-Only Access: Safe querying without risk of data modification

📋 Prerequisites

• Node.js 18+ and npm

• Valid Umbrella Cost account credentials

• MCP-compatible client (Claude Desktop, etc.)

⚡ Quick Start

1. Install Dependencies

npm install

2. Build the Server

npm run build

3. Test the Server

npm run test-runner

4. Run the MCP Server

npm start
# or for development
npm run dev

🔧 Configuration

Environment Variables

Create a .env file with:

# API Base URL (defaults to https://api.umbrellacost.io/api/v1)
UMBRELLA_API_BASE_URL=https://api.umbrellacost.io/api/v1

# Server Configuration
MCP_SERVER_NAME=Umbrella MCP
MCP_SERVER_VERSION=1.0.0

Test Credentials

For testing and validation, use these provided credentials:

MSP Customer:

• Username: elisha@umbrellacost.cloud

• Password: 6K2UX6DoYSgV%E

Direct Customer:

• Username: elisha@umbrellacost.net

• Password: G37oi57Kp@cNzx

Usage

Authentication

Before making any API calls, authenticate with your Umbrella Cost credentials:

// Using the authenticate tool
authenticate(username="your-email@domain.com", password="your-password")

Test Credentials

For testing and demonstration, you can use these provided credentials:

MSP Customer:

• Username: elisha@umbrellacost.cloud

• Password: 6K2UX6DoYSgV%E

Direct Customer:

• Username: elisha@umbrellacost.net

• Password: G37oi57Kp@cNzx

Available Tools

The MCP server provides the following tools:

Core Tools

• authenticate - Authenticate with Umbrella Cost API

• list_endpoints - List all available API endpoints

• help - Get help and usage information

API Endpoint Tools

All Umbrella Cost API endpoints are available as tools with the prefix api_. For example:

• api__invoices_caui - Get cost and usage data

• api__usage_rds_instance_costs - Get RDS instance costs

• api__recommendations - Get cost optimization recommendations

• api__budgets - Get budget information

• api__anomaly_detection - Get cost anomaly detection results

Example Queries

Once connected to an LLM client, you can ask natural language questions like:

• "Show me my AWS costs for the last 30 days"

• "What are my biggest cost optimization opportunities?"

• "Which RDS instances are costing the most?"

• "Are there any cost anomalies I should be aware of?"

• "What's my current budget status?"

• "Show me my Kubernetes cluster costs"

API Categories

The server organizes endpoints into the following categories:

Cost Analysis

• Cost and usage data retrieval

• Service cost breakdowns

• Historical cost trends

Usage Analysis

• RDS instance costs

• S3 bucket costs

• Resource utilization data

Resource Explorer

• Resource-level cost breakdown

• Resource operations data

Dashboards

• Dashboard configurations

• Custom dashboard data

Budget Management

• Budget tracking

• Budget alerts and notifications

Recommendations

• Cost optimization suggestions

• Right-sizing recommendations

Anomaly Detection

• Cost anomaly identification

• Unusual spending patterns

Commitment Analysis

• Reserved instances analysis

• Savings plans utilization

Kubernetes

• Container cost analysis

• Cluster cost breakdown

User Management

• User information

• Customer management (MSP)

Development

Building

npm run build

Development Mode

npm run dev

Type Checking

npm run type-check

Linting

npm run lint

Security

• Read-Only Access: The MCP server only provides read access to prevent accidental modifications

• Credential Security: Authentication credentials are only used to obtain tokens and are not stored

• Token-Based: All API requests use secure authentication tokens

• Rate Limiting: Respects Umbrella Cost API rate limits

Error Handling

The server provides comprehensive error handling for:

• Authentication failures

• Network connectivity issues

• API rate limiting

• Invalid parameters

• Permission errors

Support

For issues and questions:

1. Check the built-in help: Use the help tool with topics like authentication, endpoints, or parameters

2. Review the API documentation at Umbrella Cost

3. Contact your Umbrella Cost support team

License

Copyright © 2024 Umbrella Cost. All rights reserved.