Tools Reference

The DigiUsher MCP Server exposes 31 read-only tools organized across 9 domains. All tools require authentication and most require an organization_id — use list_organizations first to discover available organizations.

Organizations & Users

list_organizations

Entry-point tool. Returns organizations the authenticated user can access. Call this first when organization_id is unknown.

Example prompt: "What organizations do I have access to in DigiUsher?"

---

get_current_user

Returns the authenticated user's profile. Useful for confirming account context.

Example prompt: "Who am I in DigiUsher?"

---

Data Sources

list_data_sources

Lists cloud account and billing data sources for an organization. Useful for mapping data_source_id values in expense and recommendation results.

Example prompt: "What cloud accounts are connected to my organization?"

---

get_data_source

Get detailed information for a single data source by ID. Returns richer detail than the list view, including configuration and status. Use list_data_sources first to find the data_source_id.

Example prompt: "Show me the details and status of data source abc-123."

---

Expenses

The expense tools follow a recommended workflow:

1. get_expense_dimension_catalog — Discover available dimensions
2. query_expense_dimension_values — Get valid filter values for a dimension
3. query_expense_data — Run the expense query
4. get_expense_dimension_lookups — Translate IDs in results to friendly names

get_expense_dimension_catalog

Lists available expense dimensions and their capabilities for filtering or grouping.

Example prompt: "What dimensions can I use to break down my cloud costs?"

---

query_expense_dimension_values

Returns valid values for a selected expense dimension. Use the returned values in query_expense_data filters to avoid invalid filter errors.

Body fields:

Example prompt: "What services are available in my expense data?"

---

query_expense_data

Query aggregated expense data with grouping, filtering, and sorting.

Body fields:

Example prompt: "Show me our AWS spending for January 2026 broken down by service, sorted by cost descending, top 10."

---

get_expense_dimension_lookups

Returns lookup tables to translate IDs (like data_source_id and pool_id) into user-friendly names. Use after query_expense_data when results contain IDs.

Example prompt: "Translate the data source IDs in my expense results to names."

---

Anomaly Detection

get_anomaly_summary

Get aggregated anomaly counts by severity, type, and group. Use as a dashboard-style overview before drilling into individual anomalies.

Example prompt: "Give me a summary of cost anomalies detected this month."

---

list_anomalies

List anomalies with filtering, sorting, and pagination. Use after get_anomaly_summary to inspect matching anomalies in detail.

Body fields:

Example prompt: "Show me all high-severity cost anomalies from the last 30 days."

---

get_anomaly

Get a single anomaly by ID with computed impact metrics and metadata. Use after list_anomalies for deeper inspection.

Example prompt: "Show me the full details of anomaly abc-123."

---

Recommendations

list_all_scenarios

List recommendation scenarios and their configurable thresholds. Use to discover scenario IDs before filtering recommendations.

Example prompt: "What types of cost optimization scenarios does DigiUsher check for?"

---

get_scenario_by_id

Get one recommendation scenario by ID, including threshold definitions and optimization detection metadata.

Example prompt: "Show me the details of the rightsizing scenario."

---

list_threshold_overrides

List threshold overrides configured for the organization, optionally filtered by scenario.

Example prompt: "Are there any custom threshold overrides configured for our recommendations?"

---

get_threshold_override

Get a specific threshold override by ID.

Example prompt: "Show me override abc-123."

---

list_recommendations

List cost optimization recommendations with filtering, sorting, and pagination.

Body fields:

Example prompt: "Show me the top 5 open recommendations sorted by savings."

---

get_savings_summary

Get aggregated potential savings from recommendations, with optional filtering and grouping. Useful for executive summaries and trend breakdowns.

Body fields:

Example prompt: "What's the total potential savings from all open recommendations?"

---

get_recommendation

Get one recommendation by ID, including automation status and detailed payload.

Example prompt: "Show me the full details of recommendation abc-123."

---

KPIs

list_kpi_definitions

List available KPI definitions, including units, categories, and favorable direction. Use before snapshot or time-series calls to discover kpi_ids.

Available KPIs:

Example prompt: "What FinOps KPIs are available for my organization?"

---

get_kpi_snapshots

Get KPI values for a single date.

Example prompt: "What are our current KPI values?"

---

get_kpi_time_series

Get KPI values across a date range. start_date must be on or before end_date.

Example prompt: "How has our effective savings rate trended over the last 3 months?"

---

get_unit_economics

Calculate cost per unit of business value by combining pool costs with North Star Metric (NSM) values.

Body fields:

Example prompt: "What's our cost per transaction over the last quarter?"

---

Chargeback

get_chargeback_for_month

Get chargeback data for a specific month. Returns persisted runs when available, or on-the-fly computed results.

Example prompt: "Show me the chargeback data for January 2026."

---

get_cost_allocation_summary

Get showback or chargeback summaries across one or more months. start_date is automatically snapped to the start of the month; end_date is inclusive and can be any date.

Body fields:

Example prompt: "Show me cost allocation across teams for Q1 2026."

---

get_cost_allocation_dimensions

Get available filter dimension values (services, regions, data sources) for cost allocation queries. Use this to discover valid filter options before calling get_cost_allocation_summary.

Example prompt: "What services and regions are available for chargeback filtering?"

---

Forecasting

get_forecast_summary

Get a forecast overview for the organization or a specific showback pool. Returns projected totals, trend direction, and confidence range. Omit group_type and group_key for the org-level forecast.

Example prompt: "What's the cost forecast for my organization?"

---

get_forecast_series

Get daily forecast time-series data for charting: actuals, predicted values, and confidence bands. Use after get_forecast_summary to drill into the trend. Omit group_type and group_key for the org-level series.

Example prompt: "Show me the daily forecast trend with confidence bands for next month."

---

get_forecast_batch

Get per-entry forecast summaries for all entries of a given group_type in one call. Use group_type=SHOWBACK_POOL to get forecast summaries for every pool at once. ORGANIZATION is not a valid group_type here — use get_forecast_summary instead.

Example prompt: "Give me forecast summaries for all cost pools at once."

---

Resource Inventory

get_resource_types

List available resource types for resource inventory queries. Use before get_dimension_values to select a valid resource_type.

Example prompt: "What resource types are in my cloud inventory?"

---

get_dimension_values

Get values for resource inventory dimensions for a specific resource type. This is for resource dimensions, not expense dimensions.

Example prompt: "What regions do our EC2 instances run in?"

---

get_resource_time_series

Get metric time-series data for a specific discovered cloud resource. Returns daily metric values over the requested date range (default: last 30 days).

Example prompt: "Show me the CPU utilization metrics for resource abc-123 over the last 30 days."