# Costory FinOps MCP

Costory FinOps MCP — an MCP server for analyzing cloud spend across AWS, GCP, Azure and LLM APIs. Explains bill jumps, breaks down Kubernetes costs by team and namespace.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3 repo stars
- Author: costory-io
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/costory-io/costory-finops-mcp-skills
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/costory-finops-mcp

## What it does

The server runs at `https://app-api.costory.io/mcp` with OAuth login in the browser. Tools are grouped into orientation (finding dimensions, metrics and split axes), queries (cost, usage, formulas, period comparison), allocation (defining custom cost axes with CEL rules), reporting (scheduled Slack, Teams posts) and alerts. The agent can explain why a bill jumped, break down Kubernetes spend by namespace, show combined AI spend across providers and models, split shared Cloud SQL cost by usage or create an alert for daily BigQuery threshold.

A single command adds the remote server; login opens in the browser on first request. If the account has multiple organizations, the agent asks for the `slug`. Without a connected Costory workspace, the server will not work.

## Requirements
- Remote server: `https://app-api.costory.io/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http finops https://app-api.costory.io/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add costory-finops-mcp --url https://app-api.costory.io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "costory-finops-mcp": {
            "url": "https://app-api.costory.io/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "costory-finops-mcp": {
            "type": "http",
            "url": "https://app-api.costory.io/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http costory-finops-mcp https://app-api.costory.io/mcp
```

## When to use it
- explain a sudden cloud bill increase and find the cause
- split Kubernetes costs by team and namespace
- show AI API spend by model and team
- allocate shared infrastructure costs by usage
- set up an alert for daily BigQuery spend threshold

## Example prompts
- Use Costory to show why our AWS bill jumped last week
- Break down Kubernetes cost for the `payments` cluster by team and namespace
- What's our total spend on OpenAI, Anthropic and Bedrock this month by team

## Similar
- [Cloud FinOps Skill & MCP](https://affpapa.org/en/nevibecode/mcp/cloud-finops-skill-mcp.md) — MCP server · ★ 75 repo stars
- [cloud-finops](https://affpapa.org/en/nevibecode/plugins/cloud-finops.md) — plugin · ★ 75 repo stars
- [nable](https://affpapa.org/en/nevibecode/mcp/getnable-nable.md) — MCP server · ★ 20 repo stars
- [cloud-architect](https://affpapa.org/en/nevibecode/skills/cloud-architect.md) — skill · 157 installs
- [cloud-architect-master](https://affpapa.org/en/nevibecode/skills/cloud-architect-master.md) — skill · 1 install
- [cloud-logging-finops](https://affpapa.org/en/nevibecode/skills/cloud-logging-finops.md) — skill · 52 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
