Xplorr MCP Tools Reference: All 28 Tools for Cloud Cost Management

Xplorr MCP Tools Reference

The Xplorr MCP server exposes 28 tools across 7 categories. Claude calls these automatically based on your natural language request. This page documents every tool with its parameters and example output.

Cost Analysis (7 tools)

`get_cost_summary`

Get cloud cost breakdown grouped by provider, service, region, or date. Returns total spend and a breakdown for the selected period.

Parameters:

Name	Type	Required	Default	Description
`startDate`	string	No	30 days ago	Start date (YYYY-MM-DD)
`endDate`	string	No	Today	End date (YYYY-MM-DD)
`groupBy`	string	No	`provider`	One of: `provider`, `service`, `region`, `date`, `account`
`provider`	string	No	—	Filter: `aws`, `azure`, or `gcp`
`accountId`	string	No	—	Filter to a specific cloud account

Example prompt: “What’s our total cloud spend this month?”

Example response:

{
  "total_cost": 12450.32,
  "currency": "USD",
  "period": "2026-03-01 to 2026-03-21",
  "breakdown": [
    { "provider": "aws", "cost": 8200.15 },
    { "provider": "azure", "cost": 3100.50 },
    { "provider": "gcp", "cost": 1149.67 }
  ]
}

`get_cost_trend`

Get daily cost trend over a time range, optionally filtered by provider or account.

Parameters:

Name	Type	Required	Default	Description
`startDate`	string	No	30 days ago	Start date (YYYY-MM-DD)
`endDate`	string	No	Today	End date (YYYY-MM-DD)
`provider`	string	No	—	Filter: `aws`, `azure`, or `gcp`
`accountId`	string	No	—	Filter to a specific cloud account

Example prompt: “Show me daily AWS costs for the last 2 weeks”

`get_top_services`

Get the top cloud services by cost. Useful for identifying the biggest cost drivers.

Parameters:

Name	Type	Required	Default	Description
`startDate`	string	No	30 days ago	Start date (YYYY-MM-DD)
`endDate`	string	No	Today	End date (YYYY-MM-DD)
`limit`	number	No	10	Number of services to return
`accountId`	string	No	—	Filter to a specific cloud account

Example prompt: “What are the top 5 most expensive services?”

`get_cost_forecast`

Forecast end-of-month spend based on historical trend. Returns projected total, daily average, and trend direction.

Parameters:

Name	Type	Required	Default	Description
`accountId`	string	No	—	Filter to a specific cloud account
`days_ahead`	number	No	30	Number of days to forecast

Example prompt: “What will our AWS bill be at the end of the month?”

`get_mom_comparison`

Month-over-month cost comparison by service. Shows which services grew or shrank vs last month.

Parameters:

Name	Type	Required	Default	Description
`accountId`	string	No	—	Filter to a specific cloud account

Example prompt: “Which services increased the most compared to last month?”

`compare_periods`

Compare cloud costs between two date ranges side by side. Also supports comparing two accounts head-to-head.

Parameters:

Name	Type	Required	Default	Description
`startA`	string	Yes	—	Period A start date (YYYY-MM-DD)
`endA`	string	Yes	—	Period A end date (YYYY-MM-DD)
`startB`	string	Yes	—	Period B start date (YYYY-MM-DD)
`endB`	string	Yes	—	Period B end date (YYYY-MM-DD)
`accountA`	string	No	—	Account ID for period A
`accountB`	string	No	—	Account ID for period B

Example prompt: “Compare our spend in January vs February”

`get_top_resources`

Get the most expensive individual cloud resources (e.g., specific EC2 instances, S3 buckets).

Parameters:

Name	Type	Required	Default	Description
`days`	number	No	30	Lookback period in days
`limit`	number	No	20	Number of resources to return
`accountId`	string	No	—	Filter to a specific cloud account

Example prompt: “What are our most expensive individual resources?”

Optimization (5 tools)

`get_recommendations`

Get cost optimization recommendations — right-sizing, idle resources, reserved instances. Filter by status, type, or provider.

Parameters:

Name	Type	Required	Default	Description
`status`	string	No	`open`	One of: `open`, `in_progress`, `applied`, `dismissed`
`type`	string	No	—	Recommendation type filter
`provider`	string	No	—	Filter: `aws`, `azure`, or `gcp`
`accountId`	string	No	—	Filter to a specific cloud account
`limit`	number	No	50	Max results

Example prompt: “Show me all open recommendations for AWS”

`get_savings_summary`

Get a summary of potential savings grouped by recommendation type.

Parameters:

Name	Type	Required	Default	Description
`accountId`	string	No	—	Filter to a specific cloud account

Example prompt: “How much could we save in total?”

`get_anomalies`

Get detected cost anomalies — unexpected spikes or drops in cloud spend.

Parameters:

Name	Type	Required	Default	Description
`accountId`	string	No	—	Filter to a specific cloud account

Example prompt: “Are there any cost anomalies this week?”

`get_ai_recommendations`

Get AI-powered cost optimization recommendations generated by analysing your spend patterns.

Parameters: None

Example prompt: “Give me AI-generated insights about our cloud spending”

`update_recommendation_status`

Mark a recommendation as in_progress, applied, or dismissed.

Parameters:

Name	Type	Required	Default	Description
`id`	string	Yes	—	Recommendation UUID
`status`	string	Yes	—	One of: `open`, `in_progress`, `applied`, `archived`, `dismissed`

Example prompt: “Mark recommendation abc123 as applied”

Budgets (4 tools)

`list_budgets`

List all budgets with their current spend, limit, and alert thresholds.

Parameters: None

Example prompt: “Show me all our budgets and how we’re tracking”

`create_budget`

Create a new budget with optional email/Slack alerts at 80% and 100% of the limit.

Parameters:

Name	Type	Required	Default	Description
`name`	string	Yes	—	Budget name
`amount`	number	Yes	—	Monthly limit in USD
`currency`	string	No	`USD`	Currency code
`cloud_account_id`	string	No	—	Scope to a specific account
`alert_at_80`	boolean	No	`true`	Alert at 80% threshold
`alert_at_100`	boolean	No	`true`	Alert at 100% threshold

Example prompt: “Create a $5,000 budget for our AWS production account”

`update_budget`

Update an existing budget name, amount, or alert thresholds.

Parameters:

Name	Type	Required	Default	Description
`id`	string	Yes	—	Budget UUID
`name`	string	No	—	New name
`amount`	number	No	—	New amount
`alert_at_80`	boolean	No	—	Update 80% threshold
`alert_at_100`	boolean	No	—	Update 100% threshold

`delete_budget`

Delete a budget by ID.

Parameters:

Name	Type	Required	Default	Description
`id`	string	Yes	—	Budget UUID

Alerts (3 tools)

`list_alerts`

List all cost alert rules (e.g., “alert when daily AWS spend exceeds $500”).

Parameters: None

Example prompt: “What alert rules do we have?”

`create_alert`

Create a cost alert rule. Triggers an email or Slack notification when a metric crosses a threshold.

Parameters:

Name	Type	Required	Default	Description
`name`	string	Yes	—	Alert rule name
`metric`	string	Yes	—	Metric to monitor (e.g., `daily_spend`, `monthly_spend`, `service_spend`)
`conditionOp`	string	Yes	—	Operator: `>`, `>=`, `<`, `<=`
`threshold`	number	Yes	—	Threshold value in USD
`notifyEmails`	array	Yes	—	Email addresses to notify
`currency`	string	No	`USD`	Currency code
`serviceFilter`	string	No	—	Filter to a specific service
`regionFilter`	string	No	—	Filter to a specific region
`slackWebhookUrl`	string	No	—	Slack webhook for notifications
`cloudAccountId`	string	No	—	Scope to a specific account

Example prompt: “Alert me when daily AWS spend exceeds $500”

`delete_alert`

Delete a cost alert rule by ID.

Parameters:

Name	Type	Required	Default	Description
`id`	string	Yes	—	Alert rule UUID

Accounts (3 tools)

`list_cloud_accounts`

List all connected cloud accounts (AWS, Azure, GCP) with their sync status.

Parameters: None

Example prompt: “Show me all connected cloud accounts”

`trigger_sync`

Trigger a cost data sync for a specific cloud account or all accounts.

Parameters:

Name	Type	Required	Default	Description
`accountId`	string	No	—	Account to sync. Omit for all accounts.
`startDate`	string	No	30 days ago	Sync start date (YYYY-MM-DD)
`endDate`	string	No	Today	Sync end date (YYYY-MM-DD)

Example prompt: “Sync our AWS production account”

`get_sync_status`

Get the sync status of all cloud accounts — last sync time, errors, and health.

Parameters: None

Example prompt: “Is our data up to date? When was the last sync?”

Reports (3 tools)

`get_report_preview`

Get a JSON preview of report data — org summary, cost by provider, top services, and optimization recommendations.

Parameters:

Name	Type	Required	Default	Description
`startDate`	string	No	30 days ago	Report start date (YYYY-MM-DD)
`endDate`	string	No	Today	Report end date (YYYY-MM-DD)
`accountId`	string	No	—	Scope to a specific account

Example prompt: “Give me a summary report for February”

`list_scheduled_reports`

List all scheduled reports (daily, weekly, monthly) configured for the organization.

Parameters: None

Example prompt: “What scheduled reports do we have?”

`create_scheduled_report`

Create a new scheduled report that is automatically emailed to recipients on a recurring basis.

Parameters:

Name	Type	Required	Default	Description
`name`	string	Yes	—	Report name
`frequency`	string	Yes	—	One of: `daily`, `weekly`, `monthly`
`recipients`	array	Yes	—	Email addresses
`cloudAccountId`	string	No	—	Scope to a specific account
`dayOfWeek`	number	No	1	Day for weekly reports (1=Monday)
`dayOfMonth`	number	No	1	Day for monthly reports

Example prompt: “Create a weekly report sent to [email protected] every Monday”

Tagging & Allocation (3 tools)

`list_tagging_policies`

List all tagging policies configured for the organization. Tagging policies enforce that cloud resources have required tags.

Parameters: None

Example prompt: “What tagging policies do we have?”

`get_tagging_violations`

Get cloud resources that violate the organization’s tagging policies (missing required tags).

Parameters: None

Example prompt: “Which resources are missing required tags?”

`list_allocation_rules`

List cost allocation tag keys available in the organization and their untagged cost percentage.

Parameters:

Name	Type	Required	Default	Description
`accountId`	string	No	—	Filter to a specific account

Example prompt: “What percentage of our spend is untagged?”