Kubecost MCP Server

An implementation of Model Context Protocol (MCP) server for Kubecost, enabling AI assistants to interact with your Kubecost cost management platform through natural language. This server allows for seamless integration with Visual Studio Code, Cursor, and other MCP clients through stdio transport protocol.

Features

Transport Protocols: Supports stdio transport mode for flexible integration with different clients
Complete Kubecost API Integration: Provides comprehensive access to Kubecost resources and operations
Budget Management: Full CRUD operations for budget rules with notifications
Cost Analysis: Access to cost allocation and asset data
AI Assistant Ready: Pre-configured tools for AI assistants to interact with Kubecost in natural language

Installation

Prerequisites

Node.js (v18 or higher recommended)
pnpm package manager (for development)
Kubecost instance with API access
Kubecost API token or username/password

Usage with Cursor

Follow the Cursor documentation for MCP support, and create a .cursor/mcp.json file in your project:

{
  "mcpServers": {
    "kubecost-mcp": {
      "command": "npx",
      "args": [
        "kubecost-mcp@latest",
        "stdio"
      ],
      "env": {
        "KUBECOST_BASE_URL": "<kubecost_url>",
        "KUBECOST_API_TOKEN": "<kubecost_token>"
      }
    }
  }
}

Start a conversation with Agent mode to use the MCP.

Usage with VSCode

Follow the Use MCP servers in VS Code documentation, and create a .vscode/mcp.json file in your project:

{
  "servers": {
    "kubecost-mcp-stdio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "kubecost-mcp@latest",
        "stdio"
      ],
      "env": {
        "KUBECOST_BASE_URL": "<kubecost_url>",
        "KUBECOST_API_TOKEN": "<kubecost_token>"
      }
    }
  }
}

Start a conversation with an AI assistant in VS Code that supports MCP.

Usage with Claude Desktop

Follow the MCP in Claude Desktop documentation, and create a claude_desktop_config.json configuration file:

{
  "mcpServers": {
    "kubecost-mcp": {
      "command": "npx",
      "args": [
        "kubecost-mcp@latest",
        "stdio"
      ],
      "env": {
        "KUBECOST_BASE_URL": "<kubecost_url>",
        "KUBECOST_API_TOKEN": "<kubecost_token>"
      }
    }
  }
}

Configure Claude Desktop to use this configuration file in settings.

Authentication Options

You can authenticate with Kubecost using either:

API Token (recommended):
export KUBECOST_API_TOKEN="your-api-token"
Username/Password:
export KUBECOST_USERNAME="your-username" export KUBECOST_PASSWORD="your-password"

Self-signed Certificates

If your Kubecost instance uses self-signed certificates or certificates from a private Certificate Authority (CA), you may need to add the following environment variable to your configuration:

"NODE_TLS_REJECT_UNAUTHORIZED": "0"

This disables TLS certificate validation for Node.js when connecting to Kubecost instances using self-signed certificates or certificates from private CAs that aren't trusted by your system's certificate store.

Warning: Disabling SSL verification reduces security. Use this setting only in development environments or when you understand the security implications.

Available Tools

The server provides the following Kubecost management tools:

Budget Management

list_budgets: List all budget rules
get_budget: Get detailed information about a specific budget rule
create_budget: Create a new budget rule
update_budget: Update an existing budget rule
delete_budget: Delete a budget rule

Cost Analysis

get_cost_allocation: Get cost allocation data with filtering and aggregation
get_assets: Get asset data with filtering and aggregation
health_check: Check if Kubecost API is healthy and accessible

Budget API Examples

Create a Weekly Budget

Create a budget that resets every Wednesday with a budget of $100.00 USD, and will send an alert via email when spending has exceeded 75% of the spend limit:

{
  "name": "budget-rule",
  "values": {
    "cluster": ["test"]
  },
  "kind": "soft",
  "interval": "weekly",
  "intervalDay": 3,
  "spendLimit": 100,
  "actions": [
    {
      "percentage": 75,
      "emails": [
        "admin@company.com"
      ]
    }
  ]
}

Create a Monthly Budget

Create a budget for the kubecost namespace which resets on the 1st of every month with a budget of $400.00 USD, and will send alerts via Slack and Microsoft Teams when spending has exceeded $100.00 of the spend limit:

{
  "name": "budget-rule-2",
  "values": {
    "namespace": ["kubecost"]
  },
  "kind": "soft",
  "interval": "monthly",
  "intervalDay": 1,
  "spendLimit": 400,
  "actions": [
    {
      "percentage": 25,
      "slackWebhooks": [
        "<example Slack webhook>"
      ],
      "msTeamsWebhooks": [
        "<example Teams webhook>"
      ]
    }
  ]
}

For Development

Clone the repository:

git clone https://github.com/your-username/kubecost-mcp.git
cd kubecost-mcp

Install project dependencies:

pnpm install

Start the development server with hot reloading enabled:

pnpm run dev

Once the server is running, you can utilize the MCP server within Visual Studio Code or other MCP client.

Environment Variables

Variable	Required	Description
`KUBECOST_BASE_URL`	Yes	The base URL of your Kubecost instance
`KUBECOST_API_TOKEN`	No*	API token for authentication
`KUBECOST_USERNAME`	No*	Username for basic authentication
`KUBECOST_PASSWORD`	No*	Password for basic authentication

*Either API token or username/password combination is required.

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request

License

MIT License

About

This project provides a Model Context Protocol (MCP) server for Kubecost, enabling AI assistants to interact with cost management data through natural language.

Topics

kubernetes devops ai cost-management mcp kubecost model-context-protocol mcp-server budget-api cost-analysis

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An implementation that enables AI assistants to interact with Kubecost cost management platform through natural language, providing access to budget management and cost analysis features.

Related MCP Servers

MCP Calc Tools
nbiish
A
security
F
license
A
quality
A server that provides advanced mathematical and financial calculation capabilities for AI code assistants, enabling them to perform complex calculations like symbolic calculus, numerical methods, and financial analysis without implementing algorithms directly.
Last updated -
18
3
JavaScript
Ethereum RPC MCP Server
0xKoda
A
security
A
license
A
quality
Provides tools for AI assistants to interact with the Ethereum blockchain through standard JSON-RPC methods, enabling queries for account balances, gas prices, and smart contract code.
Last updated -
6
8
JavaScript
MIT License
AWS Cost Explorer MCP Server
aarora79
A
security
A
license
A
quality
A command-line interface and API that allows users to analyze and visualize AWS cloud spending data by enabling Claude to query AWS Cost Explorer through natural language conversations.
Last updated -
4
121
Python
MIT License
You Need A Budget (YNAB) MCP
Jtewen
A
security
A
license
A
quality
An MCP to give AI agents extensive knowledge of your personal finances and control of your budgeting.
Last updated -
14
2
Python
MIT License

View all related MCP servers

Kubecost MCP Server