Cloudability Api Server

Name: Cloudability Api Server
Author: eelzinaty

@eelzinaty

About Cloudability Api Server

A comprehensive Model Context Protocol (MCP) server for the Cloudability API, providing advanced cost management, Kubernetes container analytics, and budget forecasting capabilities

#kkubernetes #ibm #finops #cloudability

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "cloudability": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "main.py"
      ],
      "cwd": "/path/to/cloudability-mcp-server",
      "env": {
        "CLOUDABILITY_API_URL": "https://api.cloudability.com/v3",
        "CLOUDABILITY_ENVIRONMENT_ID": "your-environment-id",
        "CLOUDABILITY_DEFAULT_VIEW_ID": "12345",
        "CLOUDABILITY_KEY_ACCESS": "your-public-key",
        "CLOUDABILITY_KEY_SECRET": "your-private-key",
        "CLOUDABILITY_FRONTDOOR_URL": "https://frontdoor.apptio.com/service/apikeylogin"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Cloudability Api Server?

Cloudability Api Server is a Model Context Protocol (MCP) server that wraps the Cloudability API, providing advanced cost management, Kubernetes container analytics, and budget forecasting capabilities. It is intended for teams managing cloud costs and containerized workloads across AWS, Azure, GCP, IBM, and OCI.

How to use Cloudability Api Server?

Clone the repository, install dependencies with uv sync, copy the .env.example to .env and set Cloudability credentials (API URL, environment ID, and optionally Frontdoor API keys), then run uv run python main.py. Configure your MCP client to point to the server with the uv run python main.py command and appropriate environment variables.

Key features of Cloudability Api Server

Container cost allocation, provisioning, analytics, and label discovery
Cost reporting with 15 dimensions and 8 metrics
Budget lifecycle management with forecasting and alerts
Current month spending estimates and multi-month predictive forecasts
Vendor account listing for AWS, Azure, GCP, IBM, OCI
Flexible authentication: Bearer token, Frontdoor API keys, or Basic auth
Multi-region support: US, EU, APAC, ME
Resource caching with configurable TTL (default 15 minutes)

Use cases of Cloudability Api Server

Allocate Kubernetes container costs by namespace, workload, or label
Manage cloud budget lifecycles and receive forecast alerts
Generate current-month spending estimates with service-level breakdowns
Retrieve vendor accounts from multiple cloud providers for cost analysis
Build custom cost reports with advanced filtering and grouping

FAQ from Cloudability Api Server

What are the runtime requirements?

Python 3.14+ and the uv package manager. You also need Cloudability API access (Bearer token, API key, or Frontdoor API keys).

How does authentication work?

Three methods: 1) Frontdoor API keys automatically acquire an apptio‑opentoken when set in environment variables; 2) Bearer token with a manually provided apptio‑opentoken; 3) Legacy Basic auth with an API key.

What tools does the server expose?

Tools for container management (provision cluster, get deployment YAML, containers report, resource usage, label discovery, cluster info), budgets (list, get, get spending estimate), forecasts, and vendor account listing (AWS, Azure, GCP, IBM, OCI).