Costory FinOps MCP — Claude Code MCP server: what it does
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.
Apache-2.0 ★ 3 updated 2026-10-21
claude mcp add --transport http finops https://app-api.costory.io/mcpWhat Costory FinOps MCP 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.
What it helps with
- 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 for the agent
- Use Costory to show why our AWS bill jumped last week
- Break down Kubernetes cost for the
paymentscluster by team and namespace - What's our total spend on OpenAI, Anthropic and Bedrock this month by team
How to install Costory FinOps MCP
Platform CLI: remote server
claude mcp add --transport http finops https://app-api.costory.io/mcpPlatform CLI: remote server
codex mcp add costory-finops-mcp --url https://app-api.costory.io/mcpConfig file
{
"mcpServers": {
"costory-finops-mcp": {
"url": "https://app-api.costory.io/mcp"
}
}
}Config file
{
"servers": {
"costory-finops-mcp": {
"type": "http",
"url": "https://app-api.costory.io/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http costory-finops-mcp https://app-api.costory.io/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Costory FinOps MCP
How to install Costory FinOps MCP in Claude Code?
Run claude mcp add --transport http finops https://app-api.costory.io/mcp. A browser window opens for OAuth login on first request.
What does Costory FinOps MCP do?
Analyzes cloud spend in AWS, GCP, Azure, LLM APIs and data clouds, splits it by team and feature, explains bill changes and allocates shared costs by usage via Kubernetes, Datadog and dbt telemetry.
What does Costory FinOps MCP need to work?
A Costory workspace with billing data connected. Subscription starts at $300 per month, 30-day trial available. The server is hosted remotely, no local setup required.