# Costfluent

> Costfluent is a paid MCP server for cloud and infrastructure. Ask an assistant about cloud costs, budgets, anomalies and savings in Costfluent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://docs.costfluent.com/developers/mcp
- **Repository:** https://github.com/costfluent/costfluent-mcp
- **MCP Registry name:** io.github.costfluent/costfluent-mcp
- **Categories:** cloud and infrastructure, analytics and data
- **Listing updated:** 2026-11-14

## About

A Costfluent API token decides what this server can do, and it starts from the Read only preset. The server runs on your machine, talks to your assistant over stdin and stdout and calls the Costfluent Public API, so questions about spend can be answered without opening the app.

It covers costs over time, saved cost reports, budgets, anomalies, the savings queue, commitments and their coverage, and Kubernetes efficiency. Write tools for annotations, cost reports, budgets, cost alerts and dashboards, acknowledging anomalies, and setting a savings finding's status and owner are offered only after an Owner switches on Let AI agents create and change objects. No tool deletes anything or touches a cloud account.

The server offers only the tools the token's capabilities allow. Two documentation tools read the public docs without the token. Install from a release archive, with Go, or as an MCPB bundle for Claude Desktop. MCP access is included in the Pro, Business and Custom plans.

## Features

- **Capability-gated tools:** Only tools the token allows are offered to the assistant.
- **Read by default:** Write tools stay off until an Owner enables agent changes.
- **Cost and savings data:** Costs, reports, budgets, anomalies, savings and commitments.
- **Kubernetes efficiency:** Includes Kubernetes efficiency data.
- **Docs search:** search_docs and get_doc_page read the public documentation.
- **CLI included:** The same tools run as the costfluent command-line tool.

## Good for

- Ask which service drove last week's cost increase
- Check budget status before a planning meeting
- Review the savings queue and set owners
- Acknowledge anomalies from a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add costfluent-mcp --env COSTFLUENT_API_TOKEN='<COSTFLUENT_API_TOKEN>' -- npx -y https://github.com/costfluent/costfluent-mcp/releases/download/v0.4.0/costfluent-mcp_0.4.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "costfluent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/costfluent/costfluent-mcp/releases/download/v0.4.0/costfluent-mcp_0.4.0.mcpb"
      ],
      "env": {
        "COSTFLUENT_API_TOKEN": "<COSTFLUENT_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "costfluent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/costfluent/costfluent-mcp/releases/download/v0.4.0/costfluent-mcp_0.4.0.mcpb"
      ],
      "env": {
        "COSTFLUENT_API_TOKEN": "<COSTFLUENT_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "costfluent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/costfluent/costfluent-mcp/releases/download/v0.4.0/costfluent-mcp_0.4.0.mcpb"
      ],
      "env": {
        "COSTFLUENT_API_TOKEN": "<COSTFLUENT_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "costfluent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/costfluent/costfluent-mcp/releases/download/v0.4.0/costfluent-mcp_0.4.0.mcpb"
      ],
      "env": {
        "COSTFLUENT_API_TOKEN": "<COSTFLUENT_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "costfluent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/costfluent/costfluent-mcp/releases/download/v0.4.0/costfluent-mcp_0.4.0.mcpb"
      ],
      "env": {
        "COSTFLUENT_API_TOKEN": "<COSTFLUENT_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `search_docs`: Searches the public Costfluent documentation
- `get_doc_page`: Reads a page of the public documentation

## FAQ

### What do I need to use it?

A Costfluent plan that includes it (Pro, Business or Custom) and an API token created by an Owner, Integration Owner or Editor.

### Can the assistant change things?

Only if an Owner turns on Let AI agents create and change objects and the token carries write capabilities.

### Can it delete data or touch my cloud account?

No. The README says no tool deletes anything or touches a cloud account.

### How is it installed?

Download a release archive, build with Go, or open the MCPB bundle in Claude Desktop.

### Is Costfluent free?

No. Costfluent is a paid product.

### How do I add Costfluent to Claude Code?

Run this command in your terminal: claude mcp add costfluent-mcp --env COSTFLUENT_API_TOKEN='<COSTFLUENT_API_TOKEN>' -- npx -y https://github.com/costfluent/costfluent-mcp/releases/download/v0.4.0/costfluent-mcp_0.4.0.mcpb

### What are the best alternatives to Costfluent?

The closest alternatives to Costfluent are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/costfluent
