get_contextLABSCO SUMMARY
The allocation happens before the question, not during it.
Feeding raw billing lines into a prompt does not work, and the shared and untagged cost is exactly the part that needs explaining. Costory allocates from real usage metrics first, so the assistant is querying numbers that already add up rather than reasoning its way toward them.
What it is
The FinOps skills that sit on top of Costory's hosted MCP server. Costory normalises AWS, GCP, Azure, Snowflake, Datadog, OpenAI and Anthropic billing into one schema, allocates shared and untagged cost from real usage metrics, and correlates spend with deploy events and incidents.
What you get
- Orientation — get_context, search, get, suggest_groupby, suggest_usage_metrics and suggest_actions discover the dimensions, dashboards and the right way to slice a question
- Query — query, list_metrics and list_virtual_dimensions cover cost, usage, metric, formula and budget questions with period-over-period comparison
- Allocation — create_virtual_dimension_draft, update_virtual_dimension_draft, preview_virtual_dimension_draft, publish_virtual_dimension and virtual_dimension_overlap_matrix build custom cost axes from ordered CEL rules
- Reporting — create_report, update_report, preview_report_widget, run_report_now, create_dashboard and update_dashboard produce scheduled Slack, Teams and email reports plus dashboards built from chat
- Alerting and events — create_alert, preview_alert, list_alerts, create_event, update_event
- Skills that encode the workflow instead of leaving the assistant to rediscover it: query, virtual-dimensions, dashboards, reports and recipes
- Recipes cover budget-versus-actual dashboards, EC2 spike alerts, prod-versus-R&D splits, untagged coverage, marketplace spend, provider credits, namespace cost, compute drilldowns and period-change explanation
Requirements
Nothing to install: add https://app-api.costory.io/mcp as a custom connector in Claude Desktop, Claude Code, Cursor or VS Code and complete the OAuth login in the browser — no IAM credentials, no Docker, no local server. Clients without native remote MCP can proxy it with mcp-remote. You need a Costory workspace with billing data connected; a 15-day trial is available. Write tools act only inside your own workspace, and query scoping follows the calling user's workspace role.
Setup effort
One command — claude plugin marketplace add costory-io/costory-finops-mcp-skills && claude plugin install costory@costory
USE CASES
Explaining why cost jumped last week
Get oriented in the available dimensions, then query the period against the one before it.
Splitting spend along an axis your provider does not have
Draft ordered CEL rules, preview what they capture, and publish once the split looks right.
Getting a weekly cost digest into Slack
Build the report from chat, preview each widget, and run it once before scheduling it.
Being told when a service spikes
Define the alert and preview what it would have fired on before turning it on.
Correlating spend with a release
Annotate the deploy as an event, then read the cost curve against it.
25 tools
Listed in project docs. Your client may show a different list.
searchgetsuggest_groupbysuggest_usage_metricssuggest_actionsquerylist_metricslist_virtual_dimensionscreate_virtual_dimension_draftupdate_virtual_dimension_draftpreview_virtual_dimension_draftpublish_virtual_dimensionvirtual_dimension_overlap_matrixcreate_reportupdate_reportpreview_report_widgetrun_report_nowcreate_dashboardupdate_dashboardcreate_alertpreview_alertlist_alertscreate_eventupdate_eventBEFORE YOU INSTALL
What to know first
Tools you get
25 tools named in the project's documentation.
Requires
A client that can reach a remote MCP server over HTTP
INSTALLATION
Connect your client
Server setup
The command line the project publishes
claude plugin marketplace add costory-io/costory-finops-mcp-skills
claude plugin install costory@costoryHosted endpoint
https://app-api.costory.io/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Claude Code, Cursor
{
"mcpServers": {
"costory": {
"type": "http",
"url": "https://app-api.costory.io/mcp",
"oauth": {
"callbackPort": 8080
}
}
}
}VS Code
{
"servers": {
"costory": {
"type": "http",
"url": "https://app-api.costory.io/mcp",
"oauth": {
"callbackPort": 8080
}
}
}
}Codex
codex plugin marketplace add costory-io/costory-finops-mcp-skills
codex plugin add costory@costoryAny MCP client — mcp-remote
{
"mcpServers": {
"costory": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app-api.costory.io/mcp"
]
}
}
}