MCP Server Introduction
The CloudYali MCP server is a local, read-only Model Context Protocol server that connects your CloudYali account to an AI assistant. It exposes 35 read-only actions across five areas: cost and usage, budgets, savings recommendations, cost anomalies, and asset inventory. You ask a question in plain English and the assistant answers from your own live CloudYali data, instead of sending you to a dashboard.
It runs on your machine, talks to the CloudYali API over HTTPS, and cannot change anything in CloudYali or in your cloud accounts.

Who it is for
Anyone who already works in an AI assistant and would rather ask a question than build a report. It suits three situations in particular:
- Cross-domain questions. "Spend jumped on RDS. Which accounts, and do we have open recommendations against them?" spans cost and recommendations, which are two separate screens in any console.
- Questions nobody built a screen for. The data is in CloudYali whether or not a view exists for that particular cut of it.
- Producing an artefact. The assistant holds the actual rows, so it can lay them out as a month-end review, a budget one-pager or an anomaly write-up rather than reciting a number.
What you can ask
Cost
- "Break down last month's AWS bill by service."
- "Which five services cost us the most this month, across every cloud?"
- "Compare this month's total spend to last month. What changed?"
Budgets
- "How are we tracking against our budgets?"
- "Which resources drove the production budget's spend in June?"
- "Has the data-transfer budget fired any alerts in the last month?"
Savings recommendations
- "What are our top savings opportunities right now?"
- "List open recommendations for EBS volumes with more than $50/month savings."
- "How much could we save in total if we actioned every recommendation?"
Anomalies
- "Any cost anomalies in the last seven days?"
- "Summarize anomaly count and impact for the quarter."
Inventory
- "How many EC2 instances do we have, per region?"
- "Find all resources tagged environment=prod that are still active."
- "What did instance i-0abc123 cost last month?"
The full list, with the action behind each one, is in Actions Reference.
Ask for the report, not the number
Because the assistant receives the underlying rows rather than a rendered chart, it can arrange them. That turns a question into a deliverable.

Requests that work well:
- "Pull August spend, budgets, anomalies and open savings, and build me a review I can send to the leadership team."
- "Show budget burn as of this morning, worst first, and flag anything over 90%."
- "Chart daily spend for this account around the 29th, mark the anomaly, and write two paragraphs on what changed."
- "Group open recommendations by how hard they are, not how much they save."
What it cannot do
- It cannot change anything. No creating or editing budgets, no changing recommendation status, no editing tags, no account settings, and no calls at all against AWS, Azure or Google Cloud. See Security and Permissions.
- It cannot see more than you can. It inherits your own CloudYali permissions exactly.
- It cannot run in a browser-only assistant. The server is a local process, so ChatGPT on the web and claude.ai in a tab cannot reach it. Desktop and terminal clients work today.
Two things to keep in mind
An empty result is not proof of zero spend. A filter that matched nothing and a period with no cost look identical in a chat reply. If a number surprises you, ask the assistant which filters it applied.
Spot-check any number you are about to quote to someone else. The data is identical to the console, but the assistant's choice of grouping, date range and cost types may not match the view you have in your head.
Next steps
- Setup Guide — install it and register it with your client.
- Actions Reference — all 35 actions, and how to prompt for them.
- Security and Permissions — the read-only guarantee, sign-in, and where credentials live.