Connection guide
How to connect Claude Code to your AWS costs
Connect Claude Code to your AWS costs through Costory's FinOps MCP. Claude Code gets AWS spend allocated to teams and features, next to the deploys and metrics that explain it.
What you can ask Claude Code about AWS
“Why did EC2 go up last week, and which deploy explains it?”
“Show Savings Plan coverage by team and environment.”
“Alert me if Amazon EC2 rises more than 10% vs the trailing 7 days.”
“Which team owns most of this month's increase?”
“Set up a weekly Slack report of this spend for #finops.”
What Claude Code sees
Costory ingests AWS cost through CUR 2.0 (BCM Data Exports) via CloudFormation or Terraform, normalizes it into one cost model alongside your other providers, and allocates it with accounts, cost allocation tags, Split Cost Allocation for EKS, Virtual Dimensions. Through the MCP server, Claude Code can query that allocated cost, compare periods, look up deploys and other events in the same window, and create alerts, reports and dashboards in Costory. It has no write access to your cloud accounts.
Good to know for this setup
If Claude Code reports that the server “does not support dynamic client registration”, check that the config uses the native HTTP transport (type "http") with the Costory URL.
Savings Plan discount sharing makes billed cost move between teams; use Contracted Cost for stable allocation.
Set up in about 30 minutes
1. Connect AWS to Costory. Follow the AWS setup guide in the docs.
2. Map spend to owners. Use Virtual Dimensions to group accounts, projects, labels and tags into teams, products and environments, even where tagging is incomplete.
3. Add Costory to Claude Code.
Run in your terminal:
Then run /mcp inside Claude Code and select Authenticate to log in with your Costory account.
Full client instructions: MCP setup guide.
Good to know
Savings Plan discount sharing makes billed cost move between teams; use Contracted Cost for stable allocation.
AWS tools compared
AWS Billing and Cost Management MCP | Costory MCP | |
|---|---|---|
Scope | AWS only | AWS, GCP, Azure, Kubernetes, data platforms, LLM APIs |
Allocation to teams | Not built in | Virtual Dimensions |
Deploys and events next to cost | No | Yes (GitHub, CI/CD, custom events) |
Actions | Provider-specific | Alerts, reports, dashboards, events in Costory |
Based on each tool's public documentation; check current docs before deciding.
FAQ
Does Claude Code get write access to my AWS account?
No. Costory reads billing data you export to it. MCP actions create Costory objects (alerts, reports, dashboards, events) and never change your cloud resources.
What AWS permissions does Costory need?
Read access to billing data only. The exact permissions are listed in the AWS setup guide.
Where is the data stored?
Costory stores and processes data in the EU.
How much does it cost?
Plans start at €250/month (up to €10M annual cloud spend), billed annually, with a 30-day free trial. See pricing.
Playbooks
Playbooks for AWS
What the Costory agent can watch, investigate and report on for you, with this in the loop.
All playbooks
Costory notices
Every Monday at 9:00, for each team.
Weekly showback per team, posted in each team's Slack channel
Every engineering team gets its own weekly cost report in its own Slack channel, scoped to the services it owns.
See the playbook
Costory notices
Daily, as Datadog usage and the EKS bill refresh.
Dynamic cost reallocation for EKS using Datadog usage
Split shared EKS cluster costs across teams in proportion to what each team's workloads actually use, measured in Datadog.
See the playbook
Costory notices
A service runs well below its capacity for 30 days.
Rightsizing recommendations grounded in real usage
The agent compares what you pay for compute with what services actually use in CloudWatch or Datadog, then recommends instance sizes to the owning team, with the deploy history attached.
See the playbook
Costory notices
Coverage drops, or the steady on-demand baseline grows.
Savings Plans and Reserved Instances coverage review
The agent watches covered versus uncovered spend and utilization, and recommends where additional commitments could make sense as your steady baseline grows.
See the playbook
Connect in under 30 minutes. Get your first optimization recommendation the next day.
30-day free trial. Copilot, €250/month, or Copilot Pro, €1,000/month, billed annually.
First optimization recommendation
The next day
ROI
Pays for itself with the first recommendation you act on
Setup
About 30 minutes
Data residency
EU
Access
Read-only on your cloud