{"report":"{\"v\":1,\"package\":\"@doitintl/doit-mcp-server\",\"version\":\"5.0.0\",\"ranAt\":\"2026-11-16T11:29:04.784Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-PbVxcmRN7zUxYXA5nWfJUEpumhOGDXxQp9SZ24zr8IRAPgputgaYUl7M4L60Ueg/bV7gcJ5Mvw+4Zr3b7b2a7g==\",\"deps\":4,\"scripts\":[],\"bins\":[\"@doitintl/doit-mcp-server\"],\"license\":\"MIT\",\"engines\":\"node >=20\",\"repository\":\"git+https://github.com/doitintl/doit-mcp-server.git\",\"bin\":\"@doitintl/doit-mcp-server\"},\"start\":{\"ok\":true,\"ms\":293,\"serverName\":\"doit-mcp-server\",\"serverVersion\":\"5.0.0\",\"protocol\":\"2025-06-18\",\"stderr\":\"DoiT MCP Server running on stdio\\n\"},\"tools\":[{\"name\":\"get_cloud_connect_requirements\",\"description\":\"Resolve fresh customer-specific AWS, GCP or Azure Cloud Connect prerequisites, identity trust, per-feature permissions, inputs and deployment artifacts. Read-only. Azure management-group requirements return an inline Azure CLI plan/apply script with exact selected roles and a customer binding; it grants access without registering and does not elevate the operator. GCP organization, project and dataset scopes use the returned inline shell artifact. AWS account scopes return the account CloudFormation template and per-account Terraform module. AWS organization scopes return one management StackSet artifact with entrypoint, a flat files list (path, URL and SHA-256 for both templates) and parameters for one root/OU; no fleet connection or rollout operation is created. AWS membership, Organizations/StackSets prerequisites, deployment success and access remain separate checks. AWS organization real-time bucket/enrollment configuration is unsupported by the pinned artifact. Artifacts are reference implementations for adaptation to customer tooling; their requirements and registration behavior remain relevant when adapted. The selected artifact's requirementsSatisfied and findings determine artifact readiness; feature-level flags or preconditions alone do not. Discovery and blocked artifacts have requirementsSatisfied=false and empty parameters. Returned parameters preserve the artifact's exact spelling and structure. Does not enable billing exports. Full Cloud Connect workflow: MCP resource skill://doit-cloud-connect/SKILL.md.\",\"params\":[\"scope\",\"featureIds\",\"featureInputs\",\"identityInputs\",\"discoveryInputs\"]},{\"name\":\"list_cloud_connections\",\"description\":\"Discover existing Cloud Connect records by structured provider, scope and featureId filters. Pass provider azure or gcp, or that provider’s exact scope, for non-AWS discovery; omitting both provider and scope defaults to AWS. An empty list means no matching registration, not that cloud resources are absent. Subsequent pages use pageToken with the same filters.\",\"params\":[\"provider\",\"scope\",\"featureId\",\"maxResults\",\"pageToken\"]},{\"name\":\"get_cloud_connection\",\"description\":\"Read a connection's bindings, desired features, last verification summary and named follow-ups. Returns the etag for conditional writes. Stored state is not a fresh access probe; fresh checks are available through verify_cloud_connect.\",\"params\":[\"connectionId\"]},{\"name\":\"register_cloud_connection\",\"description\":\"Register a deployed AWS IAM role, GCP service account or Azure DoiT enterprise application explicitly when the final deployment does not register it automatically and no connection exists yet. For AWS, retained DoiT Terraform provider resources and CloudFormation callbacks perform registration through their own workflow; an additional registration duplicates that operation. An existing connection for the scope returns 409 connection_exists; changes to that record use a conditional update. Fresh requirements describe prerequisites, and dry_run_cloud_connection_change previews the request. GCP setup scripts grant access but do not register: use descriptor metadata and the selected GCP scope. Azure uses identity.kind azure_service_principal with tenantId and one management-group binding; the live selected grants must carry the setup-written customer binding. The response returns the authoritative connection id, bindingId and registered scope identifiers for subsequent operations. Registration records an existing cloud target; it does not create an account, project, organization or Azure tenant/group. Registration alone does not establish feature readiness or data arrival. Full Cloud Connect workflow: MCP resource skill://doit-cloud-connect/SKILL.md.\",\"params\":[\"identity\",\"bindings\",\"catalogVersion\",\"idempotencyKey\"]},{\"name\":\"update_cloud_connection\",\"description\":\"Change a binding's desired features/inputs, or retry failed follow-ups by re-sending the current desired state. Requires the latest connection etag; 412 indicates a stale value and a change that needs re-evaluation. dry_run_cloud_connection_change previews the exact request and its effects, including removals. Does not change IAM or the identity. Full Cloud Connect workflow: MCP resource skill://doit-cloud-connect/SKILL.md.\",\"params\":[\"connectionId\",\"expectedEtag\",\"catalogVersion\",\"bindings\",\"idempotencyKey\"]},{\"name\":\"remove_cloud_connection\",\"description\":\"Disconnect the DoiT record using its exact etag and cleanupScope doit_only; customer IAM/IaC cleanup remains separate. dry_run_cloud_connection_change previews removal effects. 204 means the record is gone; a 409 cleanup_failed keeps it, and another removal attempt requires a fresh etag. A later 404 means already absent. Full Cloud Connect workflow: MCP resource skill://doit-cloud-connect/SKILL.md.\",\"params\":[\"connectionId\",\"expectedEtag\",\"cleanupScope\",\"idempotencyKey\"]},{\"name\":\"dry_run_cloud_connection_change\",\"description\":\"Validate a register, update or remove request and run available live checks without committing (dryRun=true). A new, unregistered AWS role returns aws_broker_requires_registration because the broker cannot probe it before registration; this result does not verify access. Returns preconditions, DoiT side effects, follow-ups and customer cleanup for review. wouldApply is informational, not a reservation or approval. Full Cloud Connect workflow: MCP resource skill://doit-cloud-connect/SKILL.md.\",\"params\":[]},{\"name\":\"verify_cloud_connect\",\"description\":\"Run fresh synchronous access checks for a registered connection. Results include authentication, per-feature checks and coverage, and `recorded` indicating whether the observation was stored. partial, not_checked and failed checks are not passed; a failed authentication leaves every feature not_checked. AWS declared-policy checks do not prove effective access. GCP checks effective scope permissions; BigQuery dataset results expose sampled table coverage. Azure checks fresh management-group access and unconditional role assignments held by the DoiT application at that exact scope; this does not evaluate every effective permission or deny assignment. Access never proves billing data arrived. Nothing is stored as a run; requestId provides correlation. Full Cloud Connect workflow: MCP resource skill://doit-cloud-connect/SKILL.md.\",\"params\":[\"connectionId\",\"bindingIds\",\"featureIds\"]},{\"name\":\"get_cloud_overview\",\"description\":\"Use this when the user wants a high-level overview or dashboard of their entire cloud infrastructure. Returns cost by cloud provider, top services per cloud, top projects per cloud, recent cost anomalies, and recent cloud incidents — all in a single call. Costs cover the last 30 days including today as totals per cloud, per service, and per project (no daily rows); services and projects are limited to the top 5 values per cloud across that range. Returns at most 5 anomalies and 5 AWS/Google Cloud provider incidents (not account-specific incidents). Failed sections silently return empty arrays, so empty data does not establish zero spend or no incidents. Do NOT use this for detailed drill-downs (use run_query), single-provider analysis, or anomaly-only queries.\",\"params\":[]},{\"name\":\"get_cloud_incidents\",\"description\":\"Use this when the user wants to check for active cloud platform outages, service disruptions, or incidents from AWS or Google Cloud. Both active and archived incidents are included unless status is filtered. Do NOT use this for cost anomalies (use get_anomalies) or support tickets (use list_tickets).\",\"params\":[\"platform\",\"filter\",\"pageToken\"]},{\"name\":\"get_cloud_incident\",\"description\":\"Use this when the user wants to view details of a specific cloud platform incident. Accepts either the incident ID or a partial title match (case-insensitive). Do NOT use this for listing all incidents (use get_cloud_incidents) or anomalies (use get_anomalies).\",\"params\":[\"id\",\"title\"]},{\"name\":\"get_anomalies\",\"description\":\"Use this when the user wants to check for unexpected cost spikes, billing anomalies, or unusual spending patterns. Returns recent anomalies with severity and impact. Do NOT use this for optimization recommendations or savings opportunities (use list_optimization_recommendations), regular cost analysis (use run_query), or viewing alerts (use list_alerts).\",\"params\":[\"pageToken\"]},{\"name\":\"get_anomaly\",\"description\":\"Use this when the user wants to view details of a specific cost anomaly by its ID. Returns full anomaly data including affected resources and cost impact. Do NOT use this for listing all anomalies (use get_anomalies).\",\"params\":[\"id\"]},{\"name\":\"list_reports\",\"description\":\"Use this when the user wants to see their saved Cloud Analytics reports or browse available reports. Returns pages of up to 40 reports with IDs and metadata, newest creation first. rowCount counts this page; pageToken retrieves the next page and is null at the end. Empty results return an error. Supports server-side, case-insensitive partial name filtering through name. Do NOT use this for running queries (use run_query) or getting report results (use get_report_results).\",\"params\":[\"filter\",\"pageToken\",\"name\"]},{\"name\":\"run_query\",\"description\":\"Use this when the user wants to analyze cloud costs, generate a cost breakdown, view spending trends, or run a custom analytics query across their cloud providers. Runs the config through the DoiT Cloud Analytics API query endpoint (https://developer.doit.com/reference/query) and returns the result rows. Accepts a structured config with data source, metrics, dimensions, time range, and filters. Do NOT use this for listing saved reports (use list_reports), checking anomalies (use get_anomalies), or viewing budgets (use list_budgets).\\n    Unpopulated fields take API defaults: basic cost, last 7 days including today, daily time rows (year/month/day), and billing (or billing-datahub for customers with DataHub metrics).\\n    Each `config.group[].limit.value` selects top/bottom N dimension values per parent group, ranked across the range; it does not cap result rows and has no tool-enforced maximum of 25. Time columns can produce multiple rows per group.\\n    `timeRange` covers relative periods; explicit dates require `timeRange: {mode: \\\"custom\\\"}` and sibling `config.customTimeRange: {from, to}`, with no unit.\\n    For mode \\\"last\\\", \\\"includeCurrent\\\": true includes the current partial period within amount; false selects fully completed periods. One month with true is current month-to-date.\\n    \\\"metrics\\\" (array) supersedes the deprecated \\\"metric\\\" (object).\\n\\n    A \\\"group\\\" with id \\\"service_description\\\" and type \\\"fixed\\\" returns a per-service cost breakdown, the most common shape for cost questions.\\n\\n    Common grouping dimension IDs (all type \\\"fixed\\\"):\\n      \\\"service_description\\\" — cloud service\\n      \\\"project_id\\\"          — GCP project / AWS account / Azure subscription\\n      \\\"cloud_provider\\\"      — cloud provider (AWS / GCP / Azure)\\n\\n    In default mode \\\"is\\\", filter values must exactly match stored dimension values (case-sensitive): cloud_provider uses provider IDs, while service_description uses service names. Common cloud-provider aliases such as aws/gcp/azure are normalized by run_query. get_dimension({type, id}) returns the valid values for a dimension for this customer.\\n    Known cloud provider IDs (cloud_provider, type \\\"fixed\\\"):\\n      \\\"amazon-web-services\\\" = AWS, \\\"google-cloud\\\" = GCP, \\\"microsoft-azure\\\" = Azure\\n\\n    Example — top AWS services last month:\\n    {\\n      \\\"config\\\": {\\n        \\\"dataSource\\\": \\\"billing\\\",\\n        \\\"metrics\\\": [{\\\"type\\\": \\\"basic\\\", \\\"value\\\": \\\"cost\\\"}],\\n        \\\"timeRange\\\": {\\\"mode\\\": \\\"last\\\", \\\"amount\\\": 1, \\\"unit\\\": \\\"month\\\", \\\"includeCurrent\\\": false},\\n        \\\"filters\\\": [{\\\"id\\\": \\\"cloud_provider\\\", \\\"type\\\": \\\"fixed\\\", \\\"values\\\": [\\\"amazon-web-services\\\"]}],\\n        \\\"group\\\": [{\\\"id\\\": \\\"service_description\\\", \\\"type\\\": \\\"fixed\\\", \\\"limit\\\": {\\\"metric\\\": {\\\"type\\\": \\\"basic\\\", \\\"value\\\": \\\"cost\\\"}, \\\"sort\\\": \\\"desc\\\", \\\"value\\\": 10}}]\\n      }\\n    }\",\"params\":[\"config\"]},{\"name\":\"cost_breakdown\",\"description\":\"Use this when the user wants a simple cost breakdown by service, project, or cloud provider (e.g. 'What are my top services by cost?', 'Which projects cost the most?'). Selects the top-N groups by total cost across the range and returns monthly rows for each. The range includes the partial current month; months=1 means month-to-date. Output row order is not a cost ranking. For complex multi-filter or multi-metric queries, use run_query instead.\",\"params\":[\"groupBy\",\"cloud\",\"months\",\"topN\"]},{\"name\":\"cost_trend\",\"description\":\"Use this when the user wants to see monthly spend over time (e.g. 'Show me my cost trend', 'How has my spend changed over the last 6 months?'). Returns monthly cost data points, optionally broken down by service/project/cloud. The last point is the partial current month; months=1 means month-to-date. For daily granularity or custom time intervals, use run_query instead.\",\"params\":[\"months\",\"cloud\",\"groupBy\",\"topN\"]},{\"name\":\"compare_spend\",\"description\":\"Use this when the user wants to compare spend between two time periods (e.g. 'Compare the latest three months including this month with January through March'). Period 1 is N-1 full calendar months plus current month-to-date; period 2 is an explicit date range. Returns two separate sets of monthly rows, each independently limited to its top 10 groups across that period. Groups can differ; no difference or percentage change is computed. For more than two periods or advanced comparative analysis, use run_query instead.\",\"params\":[\"period1Months\",\"period2\",\"cloud\",\"groupBy\"]},{\"name\":\"list_optimization_recommendations\",\"description\":\"Use this when the user asks about optimization, recommendations, insights, savings opportunities, rightsizing, idle resources, security findings, or cost reduction suggestions. Also use this when the user asks 'what insights are available?' or 'show me insights'. This is the primary tool for 'what can I optimize?', 'how can I save money?', and 'what insights do I have?' questions. Returns insights ordered within each page by estimated daily savings, not priority. All statuses are included unless filtered, including dismissed. easyWin is derived from easyWinDescription when present, otherwise null. Follow pageToken for more results. Do NOT use this for cost anomalies/spikes (use get_anomalies) or budget tracking (use list_budgets).\",\"params\":[\"category\",\"priority\",\"displayStatus\",\"provider\",\"easyWin\",\"searchTerm\",\"page\",\"pageToken\",\"maxResults\",\"pageSize\"]},{\"name\":\"get_insight_resources\",\"description\":\"Use this when the user wants to see which specific resources are affected by an optimization insight. Returns a page of resourceResults with rowCount and pageToken, resource IDs, accounts, savings or risk counts. There is no dedicated remediation field. Default page size is 1000; follow pageToken for more resources. Do NOT use this for listing all insights (use list_optimization_recommendations).\",\"params\":[\"pageToken\",\"maxResults\",\"source\",\"key\"]},{\"name\":\"get_insight\",\"description\":\"Use this when the user wants the details and aggregate summary (savings, risk counts, status, description) of a single optimization insight identified by its source and key. Returns the insight metadata only — it does NOT include the individual affected resources (use get_insight_resources for those) and is not for listing all insights (use list_optimization_recommendations).\",\"params\":[\"source\",\"key\"]},{\"name\":\"post_insight_result\",\"description\":\"Use this when the user wants to create a new custom insight or update an existing one's metadata (title, description, categories, status, remediation links). Only insights owned by the 'public-api' source can be managed (the default source). Requires key, title, shortDescription, cloudProvider and categories on every call. This replaces insight metadata: omitted optional fields such as detailedDescriptionMdx, reportUrl, easyWinDescription and cloudFlowTemplateId are cleared. Affected resources are managed separately (post_insight_resource_results). For a status-only change, use update_insight_status to preserve metadata despite that endpoint's deprecation.\",\"params\":[\"source\",\"key\",\"title\",\"shortDescription\",\"cloudProvider\",\"categories\",\"detailedDescriptionMdx\",\"reportUrl\",\"cloudFlowTemplateId\",\"easyWinDescription\",\"status\",\"dismissalDetails\"]},{\"name\":\"update_insight_status\",\"description\":\"Use this when the user wants to change the display status of an existing insight (e.g. mark it acknowledged, in progress, optimized, or dismissed). This endpoint is deprecated but remains the safe choice for status-only changes because it preserves optional insight metadata; post_insight_result replaces it. Only insights owned by the 'public-api' source can be managed. When dismissing, dismissalDetails.reason is required; comment is optional. Do NOT use this to edit an insight's title/description or create one (use post_insight_result).\",\"params\":[\"source\",\"key\",\"status\",\"dismissalDetails\"]},{\"name\":\"get_report_results\",\"description\":\"Use this when the user wants to retrieve the data results of a specific saved report. Uses the report's saved time range, resolved at execution for relative ranges. Accepts an ID or a case-insensitive substring name lookup within the first 200 newest reports; multiple matches return an ambiguity error and id takes precedence. Do NOT use this for listing all reports (use list_reports) or running ad-hoc queries (use run_query).\",\"params\":[\"id\",\"name\"]},{\"name\":\"get_report_config\",\"description\":\"Get the configuration of a specific Cloud Analytics report by ID. Returns the stored report object including name, type, and a nested 'config' field containing data source, metrics, dimensions, time range, filters, and visualization settings.\",\"params\":[\"id\"]},{\"name\":\"create_report\",\"description\":\"Use this when the user wants to save a new Cloud Analytics report with a specific configuration. Creates a new custom report immediately without replacing existing reports, optionally inside a folder (folderId). Omitted config fields take API defaults: basic cost, last 7 days including today, daily time rows, and billing (or billing-datahub when the customer has DataHub metrics). System labels are rejected. Do NOT use this for one-time queries without saving (use run_query).\",\"params\":[\"name\",\"description\",\"labels\",\"folderId\",\"config\"]},{\"name\":\"update_report\",\"description\":\"Use this when the user wants to modify an existing saved Cloud Analytics report. Only custom reports the caller can edit are supported. Supports partial updates with array replacement and config reset semantics described on config. Omitted top-level fields are unchanged; labels replaces non-system labels; folderId moves the report to another folder. Changes apply immediately. Do NOT use this for running ad-hoc queries (use run_query).\",\"params\":[\"id\",\"name\",\"description\",\"labels\",\"folderId\",\"config\"]},{\"name\":\"validate_user\",\"description\":\"Use this when the user asks to verify their account connection or check who they are logged in as. Returns the authenticated user's email and the primary domain of the customer the session is scoped to. Authentication is already established by the connection, so other tools do not depend on this call. Do NOT use this for listing users in the organization (use list_users).\",\"params\":[]},{\"name\":\"list_dimensions\",\"description\":\"Use this when the user wants to see available dimensions for cost analysis queries. Returns id, label and type metadata only (no values), up to 200 dimensions per page, sorted by id. GKE dimensions are omitted. pageToken retrieves subsequent pages; rowCount counts this page. get_dimension retrieves values. Empty results return an error. Do NOT use this for running cost queries directly (use run_query) or viewing allocations (use list_allocations).\",\"params\":[\"filter\",\"pageToken\"]},{\"name\":\"get_dimension\",\"description\":\"Use this when the valid filter values for a specific dimension are needed, such as for a run_query filter, or when the user wants to view dimension details. Returns id, label, type and all available value/cloud pairs in one response, without pagination. For example, get_dimension({type: 'fixed', id: 'cloud_provider'}) returns the exact provider IDs available for this customer. Do NOT use this for listing all dimensions (use list_dimensions) or running queries (use run_query).\",\"params\":[\"type\",\"id\"]},{\"name\":\"list_tickets\",\"description\":\"Use this when the user wants to view their support tickets, check ticket status, or review open issues. Returns tickets with status, severity, and platform. Customers see their own tickets; organization tickets are visible when ticket sharing is enabled. Subject filtering is case-insensitive and applies only to the returned page. The API cursor and unfiltered rowCount are preserved, including on pages with no matches. Each ticket's fields array lists only custom fields that have a value; unset fields are omitted. Do NOT use this for cloud incidents (use get_cloud_incidents) or cost alerts (use list_alerts).\",\"params\":[\"pageToken\",\"pageSize\",\"subject\"]},{\"name\":\"get_ticket\",\"description\":\"Returns details of a specific support ticket from the DoiT API by its ID.\",\"params\":[\"id\"]},{\"name\":\"list_ticket_comments\",\"description\":\"Returns all comments on a support ticket. For customers, only public comments are returned. For DoiT employees, both public and private comments are returned.\",\"params\":[\"ticketId\",\"pageToken\"]},{\"name\":\"create_ticket_comment\",\"description\":\"Adds a comment to an existing support ticket. For customers, comments are always public. For DoiT employees, comments can be marked as private (internal notes) by setting the private field to true.\",\"params\":[\"ticketId\",\"body\",\"private\"]},{\"name\":\"create_ticket\",\"description\":\"Use this when the user wants to create a new support ticket. The ticket is opened with DoiT support immediately. Do NOT use this for viewing existing tickets (use list_tickets) or cloud incidents (use get_cloud_incidents).\",\"params\":[\"ticket\"]},{\"name\":\"list_invoices\",\"description\":\"Use this when the user wants to see their invoices, check billing history, or review payment records. Returns a list of invoices with amounts, dates, and status. Do NOT use this for cost analysis (use run_query) or budget tracking (use list_budgets).\",\"params\":[\"pageToken\"]},{\"name\":\"get_invoice\",\"description\":\"Use this when the user wants to view details of a specific invoice by its ID. Returns full invoice data including line items and status. Do NOT use this for listing all invoices (use list_invoices) or cost analysis (use run_query).\",\"params\":[\"id\"]},{\"name\":\"list_allocations\",\"description\":\"Use this when the user wants to see their cost allocation rules or configurations. Returns a list of allocations. Returns pages of 40; pass the returned pageToken for another page (null means no next page). The case-insensitive partial name filter applies only to that returned page. Do NOT use this for cost queries (use run_query) or labels (use list_labels).\",\"params\":[\"pageToken\",\"name\"]},{\"name\":\"get_allocation\",\"description\":\"Use this when the user wants to view details of a specific cost allocation. Accepts either the allocation ID or a case-insensitive partial name. Name lookup searches only the first 200 allocations; multiple matches return an error listing names, and id takes precedence. Do NOT use this for listing all allocations (use list_allocations) or running queries (use run_query).\",\"params\":[\"id\",\"name\"]},{\"name\":\"create_allocation\",\"description\":\"Use this when the user wants to create a new cost allocation rule. Changes apply immediately. Do NOT use this for viewing existing allocations (use list_allocations) or labels (use create_label).\",\"params\":[\"name\",\"description\",\"rule\",\"rules\",\"unallocatedCosts\"]},{\"name\":\"update_allocation\",\"description\":\"Use this when the user wants to modify an existing cost allocation. Omitted fields are preserved. Use rule for an existing single allocation and rules for an existing group; the type cannot change. A supplied rules list replaces the entire group membership. Changes apply immediately. Do NOT use this for creating new allocations (use create_allocation) or viewing allocations (use list_allocations).\",\"params\":[\"name\",\"description\",\"rule\",\"rules\",\"unallocatedCosts\",\"id\"]},{\"name\":\"list_assets\",\"description\":\"Use this when the user wants to browse their cloud assets, subscriptions, or resources. Returns a paginated list of assets. Name filtering is case-insensitive and applies only to the returned page. The API cursor and unfiltered rowCount are preserved, including on pages with no matches. Do NOT use this for cost analysis (use run_query) or checking invoices (use list_invoices).\",\"params\":[\"maxResults\",\"pageToken\",\"filter\",\"name\"]},{\"name\":\"get_asset\",\"description\":\"Use this when the user wants to view details of a specific cloud asset. Accepts an asset ID, which takes precedence over name, or a case-insensitive partial name lookup within the first 249 assets only. Multiple name matches return an ambiguity error. Do NOT use this for listing all assets (use list_assets) or cost analysis (use run_query).\",\"params\":[\"id\",\"name\"]},{\"name\":\"list_alerts\",\"description\":\"Use this when the user wants to see their cost alerts or check alert configurations. Returns a paginated list of alerts. Do NOT use this for anomaly detection (use get_anomalies) or budget tracking (use list_budgets).\",\"params\":[\"sortBy\",\"sortOrder\",\"maxResults\",\"pageToken\",\"filter\"]},{\"name\":\"get_alert\",\"description\":\"Use this when the user wants to view the details of a specific cost alert. Accepts either the alert ID or a partial name (case-insensitive). Do NOT use this for listing all alerts (use list_alerts) or anomalies (use get_anomalies).\",\"params\":[\"id\",\"name\"]},{\"name\":\"create_alert\",\"description\":\"Use this when the user wants to set up a new cost alert with thresholds and notification settings. Changes apply immediately. Do NOT use this for creating budgets (use create_budget) or viewing existing alerts (use list_alerts).\",\"params\":[\"name\",\"config\",\"recipients\"]},{\"name\":\"update_alert\",\"description\":\"Use this when the user wants to modify an existing cost alert. Supports partial updates, including name-only, recipients-only, or individual config fields. Omitted fields are preserved; scopes: [] clears scopes. Changes apply immediately. Do NOT use this for creating new alerts (use create_alert) or budgets (use create_budget).\",\"params\":[\"id\",\"config\",\"name\",\"recipients\"]},{\"name\":\"trigger_cloud_flow\",\"description\":\"Triggers a published CloudFlow with a webhook trigger by flow ID or trigger URL. Executes real actions immediately and returns executionLink. Drafts fail with 403, flows without a webhook trigger with 400, and already-running flows with 409. Manual or scheduled flows use trigger_cloudflow_flow instead. This may modify external cloud resources.\",\"params\":[\"flowID\",\"requestBodyJson\"]},{\"name\":\"list_cloudflows\",\"description\":\"Use this when the user wants to see their CloudFlow automation flows. Returns a cursor-paginated list of flows with their metadata, status, and last execution info.\",\"params\":[\"maxResults\",\"pageToken\"]},{\"name\":\"list_cloudflow_connections\",\"description\":\"Use this when the user wants to see their CloudFlow cloud provider connections (the GCP/AWS accounts connected for automation). Returns a cursor-paginated list of connections with their config and status. Do NOT use this to trigger a flow (use trigger_cloud_flow) or to view a single connection's details (use get_cloudflow_connection).\",\"params\":[\"maxResults\",\"pageToken\"]},{\"name\":\"get_cloudflow_connection\",\"description\":\"Use this when the user wants to view the details of a specific CloudFlow cloud provider connection by its ID, including its GCP/AWS configuration, collaborators, and status. Do NOT use this to list all connections (use list_cloudflow_connections) or to trigger a flow (use trigger_cloud_flow).\",\"params\":[\"connectionId\"]},{\"name\":\"create_cloudflow_connection\",\"description\":\"Use this when the user wants to create a new CloudFlow cloud provider connection (a GCP or AWS account connected for automation). Exactly one of gcpConfig or awsConfig must be supplied. Changes apply immediately. Do NOT use this to update an existing connection (use update_cloudflow_connection) or to trigger a flow (use trigger_cloud_flow).\",\"params\":[\"idempotencyKey\",\"name\",\"description\",\"gcpConfig\",\"awsConfig\",\"collaborators\",\"enabled\"]},{\"name\":\"update_cloudflow_connection\",\"description\":\"Updates a CloudFlow connection immediately using connectionId and the last observed ETag (ifMatch). A stale ETag fails with 412. Other fields are optional; supplied gcpConfig/awsConfig and collaborators replace their stored values wholesale. Retain exactly one owner when replacing collaborators. At most one provider config may be supplied. Serialize updates because the API version check is not atomic with the write. If an HTTP failure has only generic text, do not infer its status or retry automatically.\",\"params\":[\"ifMatch\",\"connectionId\",\"name\",\"description\",\"enabled\",\"gcpConfig\",\"awsConfig\",\"collaborators\"]},{\"name\":\"list_cloudflow_templates\",\"description\":\"Use this when the user wants to see the catalogue of available CloudFlow templates (read-only blueprints they can build a flow from). Returns a cursor-paginated list of templates with their id, name, description, and instructions. Do NOT use this to view a single template's details (use get_cloudflow_template) or to trigger a flow (use trigger_cloud_flow).\",\"params\":[\"maxResults\",\"pageToken\"]},{\"name\":\"get_cloudflow_template\",\"description\":\"Use this when the user wants to view the details of a specific CloudFlow template by its ID, including its name, description, and configuration instructions. Do NOT use this to list all templates (use list_cloudflow_templates) or to trigger a flow (use trigger_cloud_flow).\",\"params\":[\"templateId\"]},{\"name\":\"refine_cloudflow\",\"description\":\"Refines an existing CloudFlow using natural language. Streams progress and returns the answer and conversationId; normally no flowId is returned. A plan or clarification question may save nothing. Reusing conversationId continues that conversation. Generated codeNode code can pass validation and fail silently or error at run time, so a successful build shows only that a draft was saved. export_cloudflow_flow returns the saved code; a completed test run's per-node output shows whether it works. Test runs execute real actions, including on drafts. Full CloudFlow authoring guide: MCP resource doit://docs/cloudflow-authoring.\",\"params\":[\"question\",\"flowId\",\"conversationId\"]},{\"name\":\"build_cloud_flow\",\"description\":\"Use this when the user wants to build a brand-new CloudFlow automation from scratch using natural language. Creates the draft before planning, so flowId can be returned even if the builder stops early. Streams progress and returns flowId, conversationId, the answer, and any build steps. Reusing conversationId continues the conversation but this endpoint still creates a new draft; refine_cloudflow targets an existing flow. Generated codeNode code can pass validation and fail silently or error at run time, so a successful build shows only that a draft was saved. export_cloudflow_flow returns the saved code; a completed test run's per-node output shows whether it works. Test runs execute real actions, including on drafts. Full CloudFlow authoring guide: MCP resource doit://docs/cloudflow-authoring.\",\"params\":[\"question\",\"conversationId\"]},{\"name\":\"list_organizations\",\"description\":\"Use this when the user wants to see the organizations in their DoiT account. Returns a list of organizations. Do NOT use this for listing users (use list_users) or platforms (use list_platforms).\",\"params\":[\"pageToken\"]},{\"name\":\"list_platforms\",\"description\":\"Use this when the user wants to see the support-ticket platform catalog. Returns platform IDs and display names for create_ticket; this catalog does not list connected cloud accounts. Do NOT use this for cloud incidents (use get_cloud_incidents) or products (use list_products).\",\"params\":[\"pageToken\"]},{\"name\":\"list_users\",\"description\":\"Use this when the user wants to see users in their DoiT organization or check who has access. Includes active users and pending invitations. Returns roleId values, which resolve to role details in list_roles. Do NOT use this for listing roles (use list_roles) or validating the current user (use validate_user).\",\"params\":[\"pageToken\"]},{\"name\":\"update_user\",\"description\":\"Use this when the user wants to update a user's information such as name, job function, phone, language, or role. Changes apply immediately. Do NOT use this for inviting new users (use invite_user) or listing users (use list_users).\",\"params\":[\"id\",\"firstName\",\"lastName\",\"jobFunction\",\"phone\",\"phoneExtension\",\"language\",\"roleId\"]},{\"name\":\"invite_user\",\"description\":\"Use this when the user wants to invite a new person to the organization. The invitation email is sent immediately. Omitted roleId defaults to Support User. The email domain must be permitted by the customer's invitation policy; existing users and pending invitees cannot be re-invited. Do NOT use this for updating existing users (use update_user) or listing users (use list_users).\",\"params\":[\"email\",\"roleId\",\"organizationId\"]},{\"name\":\"list_roles\",\"description\":\"Use this when the user wants to see available roles in their DoiT organization. Returns a list of roles with permissions. Do NOT use this for listing users (use list_users) or organizations (use list_organizations).\",\"params\":[\"pageToken\"]},{\"name\":\"list_products\",\"description\":\"Use this when the user wants to see the support-ticket product catalog for one platform. Returns product IDs, display names, and platform IDs. create_ticket uses the product displayName and the platform ID. Requires platform: the full catalog spans several hundred products across all platforms and exceeds the MCP result size limit, so products are listed one platform at a time. Customers do not see private products. This catalog does not list products purchased by the account. Do NOT use this for cloud incidents (use get_cloud_incidents) or platforms (use list_platforms).\",\"params\":[\"platform\",\"pageToken\"]},{\"name\":\"list_labels\",\"description\":\"Use this when the user wants to see their DoiT console labels for organizing reports, budgets, alerts, allocations, metrics and annotations. Returns label metadata; these are not cloud resource labels. Do NOT use this for annotations (use list_annotations) or label assignments (use get_label_assignments).\",\"params\":[\"maxResults\",\"pageToken\",\"filter\",\"sortBy\",\"sortOrder\"]},{\"name\":\"get_label\",\"description\":\"Use this when the user wants to view details of a specific DoiT console label (not a cloud resource label). Accepts either the label ID or a case-insensitive partial name. Name lookup searches only the first 200 labels; multiple matches return an error listing names, and id takes precedence. Do NOT use this for listing all labels (use list_labels) or annotations (use list_annotations).\",\"params\":[\"id\",\"name\"]},{\"name\":\"create_label\",\"description\":\"Use this when the user wants to create a new DoiT console label for organizing analytics objects. Names must be unique within the customer. Requires Cloud Analytics Admin. Changes apply immediately. Do NOT use this for viewing existing labels (use list_labels) or annotations (use create_annotation).\",\"params\":[\"name\",\"color\"]},{\"name\":\"update_label\",\"description\":\"Use this when the user wants to modify an existing custom DoiT console label. Requires Cloud Analytics Admin; preset labels cannot be edited. Supports partial updates; null leaves a field unchanged. Changes apply immediately. Do NOT use this for creating new labels (use create_label) or annotations (use update_annotation).\",\"params\":[\"id\",\"name\",\"color\"]},{\"name\":\"get_label_assignments\",\"description\":\"Use this when the user wants to see which DoiT console objects are assigned to a label. Returns objectId and objectType pairs, without object details. Do NOT use this for viewing label details (use get_label) or allocations (use list_allocations).\",\"params\":[\"id\",\"pageToken\"]},{\"name\":\"assign_objects_to_label\",\"description\":\"Use this when the user wants to assign or unassign DoiT console objects (reports, budgets, alerts, allocations, metrics or annotations) to a custom console label. Preset labels cannot be assigned. Requires edit permission on every object; validation is all-or-nothing. add/remove modify associations, not a replacement list. Changes apply immediately. Do NOT use this for creating labels (use create_label) or viewing assignments (use get_label_assignments).\",\"params\":[\"id\",\"add\",\"remove\"]},{\"name\":\"list_folders\",\"description\":\"Use this when the user wants to see their Cloud Analytics folders, which organize reports and allocations into a hierarchy. Returns a list of folders with their metadata. Do NOT use this for listing reports (use list_reports) or labels (use list_labels).\",\"params\":[\"maxResults\",\"pageToken\"]},{\"name\":\"get_folder\",\"description\":\"Use this when the user wants to view details of a specific Cloud Analytics folder. Accepts either the folder ID or a case-insensitive partial name. Name lookup searches only the first 200 folders; multiple matches return an error listing names, and id takes precedence. Do NOT use this for listing all folders (use list_folders) or viewing reports (use get_report_config).\",\"params\":[\"id\",\"name\"]},{\"name\":\"create_folder\",\"description\":\"Use this when the user wants to create a new Cloud Analytics folder to organize reports and allocations. A duplicate sibling name or invalid parent is rejected. Changes apply immediately. Do NOT use this for creating reports (use create_report) or labels (use create_label).\",\"params\":[\"name\",\"description\",\"parentFolderId\"]},{\"name\":\"update_folder\",\"description\":\"Use this when the user wants to rename, re-describe, or move (reparent) an existing Cloud Analytics folder. Changes apply immediately. Auto-renaming on collision applies only when moving to another parent; a rename that collides with a sibling is rejected. Invalid parents and moves into self or a descendant are rejected. Do NOT use this for creating new folders (use create_folder) or updating reports (use update_report).\",\"params\":[\"id\",\"name\",\"description\",\"parentFolderId\"]},{\"name\":\"list_themes\",\"description\":\"Use this when the user wants to see the custom color themes defined for their account, which control the colors applied to Cloud Analytics reports. Returns a list of themes with their metadata. Do NOT use this for listing reports (use list_reports) or labels (use list_labels).\",\"params\":[\"pageToken\"]},{\"name\":\"get_theme\",\"description\":\"Use this when the user wants to view details of a specific custom color theme. Accepts either the custom theme ID or a partial name (case-insensitive) across all custom themes. Multiple matches return an error listing names; id takes precedence. Preset themes cannot be fetched with this tool. Do NOT use this for listing all themes (use list_themes).\",\"params\":[\"id\",\"name\"]},{\"name\":\"get_active_theme\",\"description\":\"Use this when the user wants to know which color theme is currently active for the authenticated user (the theme applied to Cloud Analytics reports). Returns the active theme id; the reserved sentinel \\\"default\\\" means no custom or preset theme is selected and the built-in default is in use. Do NOT use this to list all themes (use list_themes) or to fetch a specific theme by id (use get_theme).\",\"params\":[]},{\"name\":\"set_active_theme\",\"description\":\"Use this when the user wants to change the authenticated user’s active Cloud Analytics color theme. Accepts a custom theme ID or supported preset ID or the sentinel \\\"default\\\" to revert to the built-in default. Changes apply immediately. Requires Cloud Analytics edit permission. Create new themes with create_custom_theme. Do NOT use this to retrieve the current active theme (use get_active_theme) or to update theme colors (use update_theme).\",\"params\":[\"themeId\"]},{\"name\":\"update_theme\",\"description\":\"Use this when the user wants to modify an existing custom color theme — rename it, change its primary color, or update its color palette. Accepts either the theme ID or a partial name match across all custom themes; ambiguous matches return an error, and id takes precedence. Requires Cloud Analytics Admin; preset themes cannot be updated. Changes apply immediately to all users who have this theme active. Omitted fields are preserved; colors replaces both palettes. Create new themes with create_custom_theme; change the current user's active theme with set_active_theme.\",\"params\":[\"id\",\"name\",\"newName\",\"primaryColor\",\"colors\"]},{\"name\":\"get_aws_account\",\"description\":\"Use this when the user wants the CloudConnect details of a specific connected AWS account, such as its IAM role ARN, S3 bucket for real-time data, and which DoiT features are enabled or supported. Requires the 12-digit AWS account ID. Do NOT use this for Google Cloud or Azure accounts.\",\"params\":[\"accountID\"]},{\"name\":\"get_cloud_connect_supported_features\",\"description\":\"Use this when the user wants to know which DoiT CloudConnect features a connected AWS account supports and whether the account currently has the required permissions for each feature. Accepts a 12-digit AWS account ID, including AWS standalone accounts. Azure tenant IDs are unsupported. Returns the list of supported features with their permission status.\",\"params\":[\"accountID\"]},{\"name\":\"list_datahub_datasets\",\"description\":\"Use this when the user wants to see available DataHub datasets. Returns a list of datasets with metadata. Do NOT use this for billing data (use run_query) or assets (use list_assets).\",\"params\":[\"pageToken\"]},{\"name\":\"get_datahub_dataset\",\"description\":\"Use this when the user wants to view details of a specific DataHub dataset by its name. Returns dataset metadata, including the schemaTemplate identifier when present, rather than the full column schema. Do NOT use this for listing all datasets (use list_datahub_datasets) or cost queries (use run_query).\",\"params\":[\"name\"]},{\"name\":\"create_datahub_dataset\",\"description\":\"Use this when the user wants to create a new DataHub dataset. Changes apply immediately. Do NOT use this for viewing datasets (use list_datahub_datasets) or sending events (use send_datahub_events).\",\"params\":[\"name\",\"description\"]},{\"name\":\"update_datahub_dataset\",\"description\":\"Use this when the user wants to modify an existing DataHub dataset's description, displayName, or logoName. The dataset name identifies the dataset and cannot be changed. Omitted fields are kept; empty strings clear the supplied fields. At least one updatable field is required. Changes apply immediately. Do NOT use this for creating datasets (use create_datahub_dataset) or listing datasets (use list_datahub_datasets).\",\"params\":[\"name\",\"description\",\"displayName\",\"logoName\"]},{\"name\":\"send_datahub_events\",\"description\":\"Use this when the user wants to send DataHub events for ingestion (1–50,000 events per call). Each event requires a provider name and an RFC 3339 timestamp, and can optionally include dimensions and metrics. The API validates the entire request atomically, including duplicate event IDs anywhere in the request; a validation failure rejects the whole request. Success means accepted for asynchronous processing, not that records are already queryable. No processing latency is guaranteed. Do NOT use this for creating datasets (use create_datahub_dataset) or viewing datasets (use list_datahub_datasets).\",\"params\":[\"events\"]},{\"name\":\"find_cloud_diagrams\",\"description\":\"Use this when the user wants to find architecture diagrams or cloud infrastructure diagrams. Matches cloud resource IDs (cld_id or props.id) and returns diagram viewer URLs and image URLs. Creates a sheet filter and queues image rendering. Do NOT use this for cost analysis (use run_query) or incidents (use get_cloud_incidents).\",\"params\":[\"resources\"]},{\"name\":\"get_cloud_diagrams_stats\",\"description\":\"Use this when the user wants activity statistics for their cloud infrastructure diagrams over a time period — node create/update/delete change counts grouped by cloud service, plus each diagram's import/sync state. Useful for change auditing and drift detection. Requires a start and end RFC3339 date-time.\",\"params\":[\"start\",\"end\",\"pageToken\"]},{\"name\":\"search_cloud_diagrams\",\"description\":\"Use this when the user wants to search their cloud infrastructure diagrams and components by name or property. Returns matching diagram layers (scheme), components, and components matched by property value (prop). ss_id scopes only component and prop results, not scheme results. from/size page each category independently. Do NOT use this for cost analysis (use run_query) or incidents (use get_cloud_incidents).\",\"params\":[\"query\",\"ss_id\",\"from\",\"size\"]},{\"name\":\"get_cloud_diagram_cost_snapshot\",\"description\":\"Use this when the user wants a cost snapshot for a specific cloud infrastructure diagram layer over a time period — the API-reported total, trendingPct as a percentage (25 means 25%, null when no prior value is available), the top five resources and top five services by cost, and the last twelve trend buckets. Both dates are inclusive. Requires the diagram layer ID and a startDate/endDate (YYYY-MM-DD). Do NOT use this for account-wide cost analysis (use run_query) or budgets (use list_budgets).\",\"params\":[\"layerId\",\"startDate\",\"endDate\",\"interval\"]},{\"name\":\"get_cloud_diagram_resource_relationships\",\"description\":\"Use this when the user wants to understand how a specific resource in a cloud infrastructure diagram is connected to other resources — its upstream/downstream edges and optional group membership (only when kind is group_members or both). Returns the anchor resource plus up to 200 relations with their type and hop distance; truncated is true when more than 200 relations exist. Requires the diagram layer ID and the resource ID. Do NOT use this for cost analysis (use get_cloud_diagram_cost_snapshot or run_query).\",\"params\":[\"layerId\",\"resourceId\",\"direction\",\"depth\",\"kind\"]},{\"name\":\"list_cloud_diagram_activity_groups\",\"description\":\"Use this when the user wants the activity history of a cloud diagram layer. Without tags, returns ALARM, COMMIT, EVENT, and SNAPSHOT activity groups for the given layer (ss_id), ordered by timestamp descending; snapshot groups reference a snapshot and contain their individual activity records. Supplying non-empty tags restricts results to snapshots. Page with offset/limit and filter with tags. Do NOT use this for cost analysis (use run_query) or incidents (use get_cloud_incidents).\",\"params\":[\"ss_id\",\"limit\",\"offset\",\"tags\",\"pageToken\"]},{\"name\":\"list_cloud_diagram_node_activities\",\"description\":\"Use this when the user wants the change history of a single component node in a cloud diagram layer. Returns individual activity records (NODE_CREATE/NODE_UPDATE/NODE_DELETE) for the given node (ss_id + nodeId), ordered by timestamp descending, each including user as the ID of the user who made the change. Page with offset/limit. Do NOT use this for cost analysis (use run_query) or incidents (use get_cloud_incidents).\",\"params\":[\"ss_id\",\"nodeId\",\"limit\",\"offset\",\"pageToken\"]},{\"name\":\"get_cloud_diagram_components\",\"description\":\"Use this when the user wants to discover all cloud infrastructure diagrams and their layers (statussheets), or to look up layer IDs needed for other diagram endpoints. With no filters, returns accessible application and infrastructure diagrams with layer metadata and no component data. Returns maps keyed by diagram and layer IDs. Selectors must belong to diagrams accessible to the authenticated customer and user. scheme_ids and the diagrams owning layer_ids are combined, not intersected. The layer IDs required by other diagram tools come from this tool. Optionally filter by diagram IDs (scheme_ids) or layer IDs (layer_ids), and set include_components=true to load projected component maps for up to five requested or resolved layers. Larger selections return an error before loading components; discover metadata first, then request batches of at most five layer_ids. Do NOT use this for cost analysis (use run_query) or diagram search (use search_cloud_diagrams).\",\"params\":[\"scheme_ids\",\"layer_ids\",\"include_components\",\"skip_empty\",\"pageToken\"]},{\"name\":\"list_budgets\",\"description\":\"Use this when the user wants to see their cloud spending budgets or check budget status. Returns a paginated list of budgets with names, amounts, and utilization. Do NOT use this for cost analysis (use run_query) or spending alerts (use list_alerts).\",\"params\":[\"maxResults\",\"pageToken\",\"filter\",\"name\",\"minCreationTime\",\"maxCreationTime\"]},{\"name\":\"get_budget\",\"description\":\"Use this when the user wants to view the details and current utilization of a specific budget. Accepts either the budget ID or a partial name (case-insensitive). Do NOT use this for listing all budgets (use list_budgets) or cost analysis (use run_query).\",\"params\":[\"id\",\"name\"]},{\"name\":\"create_budget\",\"description\":\"Use this when the user wants to create a new cloud budget with spending limits and alert thresholds. Requires name, currency, type, startPeriod, and exactly one of scope/scopes. Requires amount unless usePrevSpend is true, endPeriod for fixed budgets, and timeInterval for recurring budgets (ignored for fixed). Changes apply immediately. Do NOT use this for viewing existing budgets (use list_budgets or get_budget) or creating alerts (use create_alert).\",\"params\":[\"name\",\"amount\",\"currency\",\"type\",\"timeInterval\",\"startPeriod\",\"endPeriod\",\"description\",\"usePrevSpend\",\"growthPerPeriod\",\"metric\",\"public\",\"scopes\",\"scope\",\"collaborators\",\"alerts\",\"recipients\",\"recipientsSlackChannels\",\"seasonalAmounts\"]},{\"name\":\"update_budget\",\"description\":\"Use this when the user wants to modify an existing budget. Supports partial updates; omitted fields retain their current values. Setting type to fixed requires endPeriod; setting type to recurring requires timeInterval and forbids endPeriod; setting usePrevSpend to false requires amount. Changes apply immediately. Do NOT use this for viewing budgets (use list_budgets) or creating new budgets (use create_budget).\",\"params\":[\"name\",\"amount\",\"currency\",\"type\",\"timeInterval\",\"startPeriod\",\"endPeriod\",\"description\",\"usePrevSpend\",\"growthPerPeriod\",\"metric\",\"public\",\"scopes\",\"scope\",\"collaborators\",\"alerts\",\"recipients\",\"recipientsSlackChannels\",\"seasonalAmounts\",\"id\"]},{\"name\":\"list_annotations\",\"description\":\"Use this when the user wants to see calendar annotations or notes on cost data. Returns a list of annotations. Do NOT use this for labels (use list_labels) or alerts (use list_alerts).\",\"params\":[\"maxResults\",\"pageToken\",\"filter\",\"sortBy\",\"sortOrder\"]},{\"name\":\"get_annotation\",\"description\":\"Use this when the user wants to view details of a specific annotation. Accepts either the annotation ID or a partial content match (case-insensitive) within the first 200 annotations. Multiple matches return an ambiguity error listing content; id takes precedence. Do NOT use this for listing all annotations (use list_annotations) or labels (use list_labels).\",\"params\":[\"id\",\"content\"]},{\"name\":\"create_annotation\",\"description\":\"Use this when the user wants to add a new annotation to mark a specific date or event in cost data. Changes apply immediately. Do NOT use this for creating labels (use create_label) or alerts (use create_alert).\",\"params\":[\"content\",\"timestamp\",\"reports\",\"labels\"]},{\"name\":\"update_annotation\",\"description\":\"Use this when the user wants to modify an existing annotation. Nonempty content is required on every update. Omitted or null timestamp/reports/labels remain unchanged; reports and labels replace their lists, and [] clears them. Changes apply immediately. Do NOT use this for creating new annotations (use create_annotation) or labels (use update_label).\",\"params\":[\"id\",\"content\",\"timestamp\",\"reports\",\"labels\"]},{\"name\":\"list_commitments\",\"description\":\"Returns a paginated list of spend commitment contracts from the DoiT Commitment Manager for Google Cloud, AWS, and Azure. These are negotiated spend commitments, rather than resource usage commitments; AWS agreements may be called Enterprise Discount Programs (EDP).\",\"params\":[\"maxResults\",\"pageToken\",\"filter\",\"sortBy\",\"sortOrder\"]},{\"name\":\"get_commitment\",\"description\":\"Returns details of a specific spend commitment contract for Google Cloud, AWS, or Azure, identified by its ID. Includes the full breakdown of commitment periods, per-period contracted values, and current spend attainment against the committed amount.\",\"params\":[\"id\"]},{\"name\":\"list_account_team\",\"description\":\"Use this when the user wants to know who their DoiT account team / account managers are. Returns the list of account managers assigned to the customer, including name, email, role, and Calendly scheduling link. Do NOT use this for listing platform users (use list_users) or organizations (use list_organizations).\",\"params\":[\"pageToken\"]},{\"name\":\"get_resource_permissions\",\"description\":\"Use this when the user wants to see who a Cloud Analytics resource is shared with and at what access level. Returns the sharing settings (per-user roles and public visibility) for a specific alert, budget, report, or allocation. Requires resourceType (alerts, budgets, reports, or allocations) and resourceId. Do NOT use this to list the resources themselves (use list_alerts, list_budgets, list_reports, or list_allocations).\",\"params\":[\"resourceType\",\"resourceId\"]},{\"name\":\"update_resource_permissions\",\"description\":\"Use this when the user wants to change who a Cloud Analytics resource is shared with or update access levels. Replaces sharing settings with PUT for a specific alert, budget, custom report, or allocation. Requires resourceType, resourceId and a nonempty permissions list with exactly one owner. Read current permissions first and retain all intended entries. Only the current owner or a user with Ownership assignment permission may transfer ownership. Omitted public makes reports, alerts and budgets private; allocations reject omitted/null public. Do NOT use this to view current permissions (use get_resource_permissions).\",\"params\":[\"resourceType\",\"resourceId\",\"permissions\",\"public\"]},{\"name\":\"ask_ava_sync\",\"description\":\"Ask DoiT AVA, DoiT's AI assistant for cloud cost and infrastructure, a question about the user's DoiT account, cloud spending, anomalies, or optimization opportunities. AVA has access to the customer's billing data, usage patterns, and DoiT-specific features. It answers DoiT and cloud-specific questions, not general-purpose ones. Complex questions may take a long time. Timeouts and application error envelopes (including HTTP 200) return MCP errors.\",\"params\":[\"question\",\"conversationId\",\"ephemeral\"]},{\"name\":\"confirm_action\",\"description\":\"Runs a generated DELETE operation that another tool staged and returned as `status: \\\"approval_required\\\"` with a summary and a one-time approval token. Intended for use after the user approves that summary. It runs exactly the saved request, including its customer scope, and returns that operation's own result or error. A token that is never confirmed expires after 5 minutes, and the staged action does not run. The token is bound to the authenticated caller and must match exactly; a different caller cannot run the action. A token runs at most once, even if execution fails. Creates and updates are not staged by the current tool registry.\",\"params\":[\"approvalToken\"]},{\"name\":\"create_signup_request\",\"description\":\"Start a Cloud Intelligence trial for an organization that is not yet a DoiT customer. These operations require no API key: they are rate limited, idempotent, and provision nothing until the organization's admin verifies the request. Agents create a request and hand the returned consentUrl to the admin; the admin verifies by entering the emailed code (or signing the request on the console), after which the tenant is provisioned and the request reports its customer id. Starts a Cloud Intelligence trial signup for the organization owning the email domain. Idempotent per Idempotency-Key: a retried create returns the same request. Nothing is provisioned until the admin verifies the request. Human channels (console, web) additionally require a Cloudflare Turnstile token and an accepted Terms of Service version; the emailed 6-digit verification code is then the consent act. Agents should present consentUrl to the organization's admin and poll getSignupRequest. Existing accounts, customer domains and previous trials receive the same pending response as new organizations. Eligibility is evaluated after mailbox verification or authenticated human consent.\",\"params\":[\"Idempotency-Key\",\"email\",\"companyName\",\"source\",\"turnstileToken\",\"termsConsent\",\"customerContext\"]},{\"name\":\"get_signup_request\",\"description\":\"Start a Cloud Intelligence trial for an organization that is not yet a DoiT customer. These operations require no API key: they are rate limited, idempotent, and provision nothing until the organization's admin verifies the request. Agents create a request and hand the returned consentUrl to the admin; the admin verifies by entering the emailed code (or signing the request on the console), after which the tenant is provisioned and the request reports its customer id. Returns the current state of a signup request. Poll at the returned pollAfterSeconds cadence; once status is completed the response carries customerId, consoleUrl and signInUrl. The response never includes the requester's email or the verification code. A browser must send the Signup-Result-Token returned by verifySignupRequest to read results after email verification. Without it, the request remains pending until its consent window expires. Agents may read results after the matching authenticated human explicitly approves their request.\",\"params\":[\"signupRequestId\",\"Signup-Result-Token\",\"customerContext\"]},{\"name\":\"verify_signup_request\",\"description\":\"Start a Cloud Intelligence trial for an organization that is not yet a DoiT customer. These operations require no API key: they are rate limited, idempotent, and provision nothing until the organization's admin verifies the request. Agents create a request and hand the returned consentUrl to the admin; the admin verifies by entering the emailed code (or signing the request on the console), after which the tenant is provisioned and the request reports its customer id. Confirms ownership of the admin email by entering the 6-digit code that was emailed when the request was created (or resent). Success records consent and starts provisioning; the request moves to consented and then completed. Five wrong codes lock the current code; request a new one with resendSignupVerification.\",\"params\":[\"signupRequestId\",\"code\",\"customerContext\"]},{\"name\":\"create_signup_session\",\"description\":\"Start a Cloud Intelligence trial for an organization that is not yet a DoiT customer. These operations require no API key: they are rate limited, idempotent, and provision nothing until the organization's admin verifies the request. Agents create a request and hand the returned consentUrl to the admin; the admin verifies by entering the emailed code (or signing the request on the console), after which the tenant is provisioned and the request reports its customer id. Exchanges the one-time activationToken returned by verifySignupRequest for a Firebase custom token once the request is completed, so the browser that entered the code lands in the new tenant without a second email. The token is bound to the request, single-use and valid for 10 minutes. Sign in with signInWithCustomToken against tenantId, then open consoleUrl.\",\"params\":[\"signupRequestId\",\"activationToken\",\"customerContext\"]},{\"name\":\"resend_signup_verification\",\"description\":\"Start a Cloud Intelligence trial for an organization that is not yet a DoiT customer. These operations require no API key: they are rate limited, idempotent, and provision nothing until the organization's admin verifies the request. Agents create a request and hand the returned consentUrl to the admin; the admin verifies by entering the emailed code (or signing the request on the console), after which the tenant is provisioned and the request reports its customer id. Emails a fresh 6-digit code to the requester. At most three codes per request, at least 60 seconds apart.\",\"params\":[\"signupRequestId\",\"customerContext\"]},{\"name\":\"list_alert_slack_channels\",\"description\":\"Notifications triggered when cloud costs exceed defined thresholds or meet specific conditions. Lists Slack destinations eligible for Alert notifications for the authenticated customer and caller. Returns canonical identifiers for recipientsSlackChannels and integration status. User credentials include visible private channels; service accounts return public/shared channels only. Results are sorted by stable destination identity. Keep nameContains unchanged when following pageToken. This endpoint is paginated: a response with a non-empty `pageToken` has more results, returned when that value is passed as the `pageToken` parameter. A missing, null, or empty `pageToken` marks the last page.\",\"params\":[\"nameContains\",\"maxResults\",\"pageToken\",\"customerContext\"]},{\"name\":\"delete_alert\",\"description\":\"Notifications triggered when cloud costs exceed defined thresholds or meet specific conditions. Deletes the alert specified by the Id. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_allocation\",\"description\":\"Define how costs are distributed across your organization. Deletes the allocation specified by the Id. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_annotation\",\"description\":\"Custom notes added to cost data to provide contextual information. Deletes the annotation specified by the Id. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_label\",\"description\":\"Create and manage labels to organize and categorize your cloud resources. Deletes the label specified by the Id. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"create_custom_theme\",\"description\":\"Configure presentation settings for Cloud Analytics reports, including custom color themes. Creates a new custom color theme. Requires Cloud Analytics Admin permission.\",\"params\":[\"name\",\"primaryColor\",\"colors\",\"customerContext\"]},{\"name\":\"delete_custom_theme\",\"description\":\"Configure presentation settings for Cloud Analytics reports, including custom color themes. Deletes the custom theme specified by the Id. Requires Cloud Analytics Admin permission. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_budget\",\"description\":\"Track actual cloud spend against planned spend. Deletes the specified budget. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"list_budget_suggestions\",\"description\":\"AI-generated budget recommendations you can accept (link to a budget you created) or dismiss. Returns the pending AI-generated budget suggestions for your account. The set is small (a handful\\nof pending suggestions) and is returned in full. Each suggestion can be accepted (after you create a\\nmatching budget via `POST /analytics/v1/budgets`) or dismissed.\",\"params\":[\"customerContext\",\"pageToken\"]},{\"name\":\"accept_budget_suggestion\",\"description\":\"AI-generated budget recommendations you can accept (link to a budget you created) or dismiss. Marks the suggestion as accepted and links it to an existing budget. Create the budget first via\\n`POST /analytics/v1/budgets`, then pass its `id` as `budgetId`. The budget must belong to your account.\",\"params\":[\"id\",\"budgetId\",\"editedBeforeAccept\",\"customerContext\"]},{\"name\":\"dismiss_budget_suggestion\",\"description\":\"AI-generated budget recommendations you can accept (link to a budget you created) or dismiss. Marks the suggestion as dismissed so it no longer appears in the pending list.\",\"params\":[\"id\",\"reason\",\"customerContext\"]},{\"name\":\"delete_folder\",\"description\":\"Organize Cloud Analytics resources (reports, allocations) into folders. Deletes the specified folder. All nested folders will be deleted. Any reports or allocations contained in the folder are moved to the root. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_report\",\"description\":\"Manage Cloud Analytics reports and get reports data in JSON format. Deletes the specified Cloud Analytics report. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"async_run_inline\",\"description\":\"Manage Cloud Analytics reports and get reports data in JSON format. Submits an async report execution job using an inline configuration. Returns 202 immediately with a Location header pointing to the operation status endpoint. Requires the Idempotency-Key header to ensure at-most-once submission. Duplicate requests with the same config for the same customer return the existing in-flight operation. Use ?dryRun=true to validate the config without creating an operation.\",\"params\":[\"dryRun\",\"Idempotency-Key\",\"config\",\"customerContext\"]},{\"name\":\"get_async_operation\",\"description\":\"Manage Cloud Analytics reports and get reports data in JSON format. Returns the current status of an async report operation. Non-terminal operations (pending, running) include a Retry-After header suggesting when to poll again. This endpoint does not return result data — once status is \\\"succeeded\\\", fetch the result from the operation's results endpoint. When status is \\\"failed\\\", the error field contains an RFC 9457-shaped error. Returns 404 if the operationId does not exist, belongs to a different tenant, or has expired.\",\"params\":[\"operationId\",\"customerContext\"]},{\"name\":\"async_run_report_by_id\",\"description\":\"Manage Cloud Analytics reports and get reports data in JSON format. Submits an async execution job for a saved report identified by ID. Returns 202 immediately with a Location header pointing to the operation status endpoint. Requires the Idempotency-Key header. Use ?dryRun=true to validate without creating an operation.\",\"params\":[\"id\",\"dryRun\",\"timeRange\",\"startDate\",\"endDate\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"cancel_async_operation\",\"description\":\"Manage Cloud Analytics reports and get reports data in JSON format. Cancels a pending or running async report operation. Already-terminal operations (succeeded, failed, canceled) are returned as-is without any state change (idempotent). Returns 404 if the operationId does not exist or belongs to a different tenant. Use ?dryRun=true to validate the request without modifying any state.\",\"params\":[\"operationId\",\"dryRun\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"get_async_operation_results\",\"description\":\"Manage Cloud Analytics reports and get reports data in JSON format. Returns the result of a succeeded async report operation, including report metadata (id, reportName, owner, type, createTime, updateTime, urlUI) when the operation was started against a saved report — the same shape as the sync GetReportResponse, instead of requiring a second call to GET /analytics/v1/reports/{id}/config for it. Returns 404 if the operationId does not exist, has expired, or belongs to a different tenant. Returns 425 Too Early if the operation has not yet reached a terminal state — poll the operation status endpoint, which returns its own Retry-After guidance, until it succeeds. Returns 422 if the operation terminated as failed or canceled. Returns 413 if the result is too large to return inline — request it again with `fileOutput=json`, or narrow the report. The poll status endpoint response does not include result data inline — this is the only endpoint that returns it.\",\"params\":[\"operationId\",\"fileOutput\",\"customerContext\"]},{\"name\":\"list_widgets\",\"description\":\"Beta. Read precomputed current-month cloud spend and forecast metrics. Widget results are\\nrefreshed in the background; reading a widget returns the latest cached result and never\\nstarts a synchronous refresh. Use the list operation to discover the complete catalogue. Returns the complete catalogue of preset widgets supported by the Analytics Widgets API.\\nEach entry contains a customer-specific `id` and a stable customer-facing `alias`; either\\nvalue can be passed to the get-widget operation. An `id` can vary by customer or service\\ntier, while an `alias` remains stable.\\n\\nAuthenticate with `Authorization: Bearer <token>`. Omit `X-Tenant-Id` when the credential\\nresolves to one customer. When the credential can act on multiple customers, send\\n`X-Tenant-Id: <tenant-id>` to select the customer. A `403` response means the caller or\\nselected customer is not authorized or entitled to use this API.\",\"params\":[\"X-Tenant-Id\",\"customerContext\",\"pageToken\"]},{\"name\":\"get_widget\",\"description\":\"Beta. Read precomputed current-month cloud spend and forecast metrics. Widget results are\\nrefreshed in the background; reading a widget returns the latest cached result and never\\nstarts a synchronous refresh. Use the list operation to discover the complete catalogue. Returns the latest precomputed cached result for one widget. This read does not refresh or\\nrecompute the widget synchronously.\\n\\nUse either the customer-specific `id` returned by the list-widgets operation or one of these\\nstable aliases:\\n\\n- `current-month-cloud-spend` — total cloud spend accumulated during the current calendar month.\\n- `current-month-cloud-forecast` — forecast of total cloud spend for the current calendar month.\\n\\nThe two concrete alias requests are:\\n\\n- `GET https://api.doit.com/analytics/v1/widgets/current-month-cloud-spend`\\n- `GET https://api.doit.com/analytics/v1/widgets/current-month-cloud-forecast`\\n\\nAuthenticate with `Authorization: Bearer <token>`. Omit `X-Tenant-Id` when the credential\\nresolves to one customer. When the credential can act on multiple customers, send\\n`X-Tenant-Id: <tenant-id>` to select the customer. A `403` response means the caller or\\nselected customer is not authorized or entitled to use this API.\\n\\nThe result's `period.endTime` is exclusive. Monetary `amount` values are decimal strings and\\n`currency` values are ISO 4217 currency codes. `monthToMonthGrowthPercentage` and\\n`monthToMonthGrowthAmount` are both `null` when no comparable prior-period value exists.\",\"params\":[\"widgetId\",\"X-Tenant-Id\",\"customerContext\"]},{\"name\":\"list_contracts\",\"description\":\"List and manage tenant-scoped contracts as a T1/T2 PartnerOps caller. Lists the contracts held by the specified customer. Callable by a T1/T2 PartnerOps principal for its own tenant or any descendant tenant. Read access requires the contractsViewer or contractsManager permission, plus the billing:contracts or channelops entitlement. User API tokens must include one of the permissions in their scope.\",\"params\":[\"customerID\",\"customerContext\",\"pageToken\"]},{\"name\":\"get_contract\",\"description\":\"List and manage tenant-scoped contracts as a T1/T2 PartnerOps caller. Returns the specified contract. Requires the contractsViewer or contractsManager permission. User API tokens must include one of them in their scope.\",\"params\":[\"customerID\",\"contractID\",\"customerContext\"]},{\"name\":\"patch_anomaly\",\"description\":\"Monitor cost spikes in your cloud environment. Updates the review status of the anomaly identified by `{id}`, the same identifier `getAnomaly` accepts. Mirrors the review workflow available in the console: set `reviewStatus`, and when resolving, qualify it with `resolution` and optionally a `resolutionNote` (feedback reason and comment). The change is recorded in the anomaly's review history exactly like a console update, and the actor is derived from the API credentials - never from the request body.\\n\\nValidation: `reviewStatus` is one of `NEEDS_REVIEW`, `UNDER_REVIEW`, `RESOLVED`; `resolution` (`ANOMALY_CONFIRMED` or `NOT_ANOMALY`) is required when `reviewStatus` is `RESOLVED` and forbidden otherwise; `resolutionNote.reason` must belong to the given `resolution` - `SECURITY_BREACH`, `MISCONFIGURATION`, `UNINTENTIONAL_PROVISIONING`, `EXPECTED_COST_SPIKE` or `ANOMALOUS_OTHER` for `ANOMALY_CONFIRMED`, and `FAULTY_ANOMALY_DETECTION_MODEL`, `INCORRECT_DATA`, `LOW_IMPACT` or `NON_ANOMALOUS_OTHER` for `NOT_ANOMALY`. Requires the `AnomaliesManager` permission and the `governance:costAnomalies` and `governance:costAnomalies:acknowledgement` entitlements.\",\"params\":[\"id\",\"customerFeedback\",\"customerContext\"]},{\"name\":\"get_anomaly_explanation\",\"description\":\"Monitor cost spikes in your cloud environment. Returns a likely-cause explanation for the specified anomaly, alongside the deterministic facts and evidence references it was generated from. The explanation itself is AI-generated; it is always returned separately from the deterministic `facts`, and is marked as such in the `explanation` object. Generation is ephemeral: no conversation is persisted on your behalf. Requires the `governance:costAnomalies` entitlement and the `AnomaliesViewer` permission.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"create_asset\",\"description\":\"Manage cloud resources or services in your cloud environment. Creates a new asset.\",\"params\":[\"type\",\"mode\",\"accountName\",\"rootEmail\",\"customerContext\"]},{\"name\":\"datahub_events_csv_file\",\"description\":\"Ingest third-party cost, usage, and metric-based data for analysis. Sends a batch of events to DataHub using a CSV file, either uncompressed or compressed in ZIP or GZ format. It may take up to 15 minutes for the data to become available in the DoiT console.\",\"params\":[\"provider\",\"file\",\"schemaTemplate\",\"periodStart\",\"periodEnd\",\"replace\",\"customerContext\"]},{\"name\":\"datahub_import_provider_records\",\"description\":\"Ingest third-party cost, usage, and metric-based data for analysis. Sends provider-native records as JSON instead of a CSV file. The records use the same columns as the template's CSV (currently `anthropic-spend-report@1` only) and are validated, normalized and booked on `periodEnd` exactly like a CSV upload. It may take up to 15 minutes for the data to become available in the DoiT console.\",\"params\":[\"provider\",\"schemaTemplate\",\"periodStart\",\"periodEnd\",\"replace\",\"records\",\"customerContext\"]},{\"name\":\"delete_datahub_events_by_filter\",\"description\":\"Ingest third-party cost, usage, and metric-based data for analysis. Deletes specific events using filters. Note that the two filters, `eventIds` and `time ranges`, are mutually exclusive.\",\"params\":[\"dataset\",\"eventIds\",\"startTime\",\"endTime\",\"customerContext\"]},{\"name\":\"delete_datahub_datasets\",\"description\":\"Ingest third-party cost, usage, and metric-based data for analysis. Deletes one or more DataHub datasets and all their associated data. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"datasets\",\"customerContext\"]},{\"name\":\"delete_datahub_dataset\",\"description\":\"Ingest third-party cost, usage, and metric-based data for analysis. Deletes a specific DataHub dataset. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"name\",\"customerContext\"]},{\"name\":\"export_datahub_dataset_records\",\"description\":\"Ingest third-party cost, usage, and metric-based data for analysis. Returns one page of the live records of a DataHub dataset, as CSV (default) or as newline-delimited JSON in the same shape as the `/datahub/v1/events` payload.\\n\\nA time window is required: `startTime` is inclusive, `endTime` is exclusive, and the window must not exceed 366 days. Rows are ordered by their event time and event id, and pages never overlap: read the `X-Next-Page-Token` response header and pass it back as `pageToken` until the header is absent. `X-Row-Count` carries the number of rows in the page. Only live rows are returned; rows deleted through the console or the delete endpoints are excluded.\\n\\nEvery row starts with five provenance columns (`event_id`, `batch`, `source`, `export_time`, `updated_by`) followed by the dataset's business columns in the CSV ingest vocabulary (`usage_date`, `fixed.<key>`, `label.<key>`, `project_label.<key>`, `system_label.<key>`, `metric.<type>`). The business columns are computed from the rows of each page, so consecutive pages can have different label and metric columns; union the headers when concatenating pages. Datasets created with the FOCUS schema template use the FOCUS column names instead and can only be exported as CSV.\\n\\nTo re-import an export into another dataset, drop the `batch`, `source`, `export_time` and `updated_by` columns, and either drop `event_id` or rename it to `id`. This tool returns a JSON envelope with data (the unchanged CSV or JSONL page body) and pageToken (from X-Next-Page-Token). Pass a non-empty pageToken back as pageToken to advance; null means the final page. MCP does not expose the HTTP headers directly.\",\"params\":[\"name\",\"format\",\"startTime\",\"endTime\",\"maxResults\",\"pageToken\",\"customerContext\"]},{\"name\":\"get_invoice_pdf\",\"description\":\"Access your current and historical billing documents. Returns the PDF document for the invoice specified by the invoice number, including a cancelled invoice or credit memo. The response body is the PDF bytes.\\nThe PDF is returned decompressed by default. It is only gzip-compressed when the request advertises `Accept-Encoding: gzip`, in which case the response carries `Content-Encoding: gzip` with a `Content-Length` for the compressed bytes and must be decoded as a standard `Content-Encoding: gzip` body. HTTP clients whose stack negotiates the encoding automatically also decode it automatically; a client that sets the header by hand may instead receive the raw gzip bytes (for example `curl` decodes only with `--compressed`). Omit `Accept-Encoding` (or send `identity`) to always receive the decompressed PDF. A very large invoice may exceed the decompressed-response size limit and respond with `500`; request it with `Accept-Encoding: gzip` to stream the compressed bytes without that limit.\\nA `404` is returned both when no invoice with the given number exists for the authenticated tenant and when the invoice exists but has no PDF document available.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"get_billing_explainer_per_payer\",\"description\":\"Explain month-over-month changes in invoiced cloud costs. Returns the invoiced cost changes for each payer in the authenticated tenant.\",\"params\":[\"invoiceMonth\",\"X-Tenant-Id\",\"customerContext\"]},{\"name\":\"get_entity_invoice_explainer\",\"description\":\"Explain month-over-month changes in invoiced cloud costs. Returns invoiced cost changes for an invoice owned by the specified billing profile in the authenticated tenant.\",\"params\":[\"billingProfileId\",\"invoiceNumber\",\"X-Tenant-Id\",\"customerContext\"]},{\"name\":\"list_service_quotas\",\"description\":\"Monitor cloud service quota usage across connected accounts and projects. Returns the latest service quota usage snapshots collected by DoiT for the authenticated customer.\\nResults include only quotas retained by DoiT's monitoring collectors and are not a complete or live inventory from the cloud providers.\\nResults are sorted by utilization percentage in descending order. This endpoint is paginated: a response with a non-empty `pageToken` has more results, returned when that value is passed as the `pageToken` parameter. A missing, null, or empty `pageToken` marks the last page.\",\"params\":[\"cloudProvider\",\"minUtilizationPercent\",\"maxResults\",\"pageToken\",\"customerContext\"]},{\"name\":\"list_contract_templates\",\"description\":\"Manage contract templates for PartnerOps resellers (T1/T2). Lists contract templates owned by the authenticated tenant (from the bearer token). Requires ContractTemplatesAdmin and the `channelops:contracts:templates` entitlement.\",\"params\":[\"customerContext\",\"pageToken\"]},{\"name\":\"get_contract_template\",\"description\":\"Manage contract templates for PartnerOps resellers (T1/T2). Returns a single contract template owned by the authenticated tenant (from the bearer token). Requires ContractTemplatesAdmin and the `channelops:contracts:templates` entitlement.\",\"params\":[\"templateID\",\"customerContext\"]},{\"name\":\"assign_contract_template\",\"description\":\"Manage contract templates for PartnerOps resellers (T1/T2). Applies a contract template owned by the authenticated tenant (from the bearer token) to child customers, creating a draft contract for each. Drafts have no billing effect until each one is completed and activated. The template must not be archived, and the current date must fall within its eligibility window. Requires ContractTemplatesAdmin and the `channelops:contracts:templates` entitlement.\",\"params\":[\"templateID\",\"customerIds\",\"customerContext\"]},{\"name\":\"list_customer_notifications\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Returns every organization-wide cost-anomaly notification config for the tenant as an unpaginated `{ \\\"items\\\": [...] }` array. Items are ordered by `createTime` ascending, then by `id` ascending. Configs that are not cost-anomaly configs are omitted.\\nRequires the `settings` (Manage settings) permission. The API does not offer the Console's read-only Organization list; a caller without this permission receives `403`.\",\"params\":[\"customerContext\",\"pageToken\"]},{\"name\":\"create_customer_notification\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Creates an organization-wide cost-anomaly notification config. Destinations are `emails`, `slackChannels`, and `teamsChannels` arrays. The response returns those three arrays.\\nRequires the `settings` (Manage settings) permission.\\nThe `Idempotency-Key` header is required. The same key and the same body replay the stored success. A different body is `422` `idempotency_key_reused`. A `5xx` response may leave the key reserved, so a retry returns `409` until the original request is released or about 30 minutes pass. `dryRun=true` does not reserve the key. With `dryRun=true` the request goes through the same checks as a real create and returns `200` with `X-Dry-Run: true` and null identity fields (`id`, `createTime`, `updateTime`, `etag`) without creating anything.\\nReads are immediately consistent. After a `201`, a GET of that notification returns the created config.\",\"params\":[\"dryRun\",\"Idempotency-Key\",\"name\",\"destinations\",\"settings\",\"customerContext\"]},{\"name\":\"get_customer_notification\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Returns one organization-wide cost-anomaly notification config. Requires the `settings` (Manage settings) permission. The API does not offer the Console's read-only Organization list; a caller without this permission receives `403`. An id that is not a cost-anomaly config for this tenant returns `404`, without saying whether it exists elsewhere.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_customer_notification\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Permanently deletes an organization-wide cost-anomaly notification config. Requires the `settings` (Manage settings) permission and the `If-Match` header. The `Idempotency-Key` header is required. The same key, the same body, and the same `If-Match` replay the stored success. A different body or a different `If-Match` is `422` `idempotency_key_reused`. A `5xx` response may leave the key reserved, so a retry returns `409` until the original request is released or about 30 minutes pass. `dryRun=true` does not reserve the key. With `dryRun=true` the request goes through the same checks as a real delete without deleting anything. Deleting an id that is not a cost-anomaly config, or that no longer exists, returns `404`.\\nReads are immediately consistent. After a completed delete (`204` without `X-Dry-Run: true`), a GET of that notification returns `404`. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"dryRun\",\"If-Match\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"update_customer_notification\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Partially updates an organization notification with an `application/merge-patch+json` body (RFC 7396). Omitted fields stay unchanged; nested objects are deep-merged; nested arrays (for example `allocations.ids`) are replaced when present. When `destinations` is present it replaces the whole destinations object; the nested `emails`, `slackChannels`, and `teamsChannels` arrays are the full lists. Optional resend fields are cleared with `null` (for example `\\\"settings\\\":{\\\"costAnomalies\\\":{\\\"repeat\\\":null}}`). `minSeverity`, `minExcessCost`, and `allocations` cannot be cleared.\\nRequires the `settings` (Manage settings) permission and the `If-Match` header. The `Idempotency-Key` header is required. The same key, the same body, and the same `If-Match` replay the stored success. A different body or a different `If-Match` is `422` `idempotency_key_reused`. A `5xx` response may leave the key reserved, so a retry returns `409` until the original request is released or about 30 minutes pass. `dryRun=true` does not reserve the key. With `dryRun=true` the request goes through the same checks as a real update and returns the notification as it would look after the patch, without changing anything.\\nReads are immediately consistent. After a completed update, a GET of that notification returns the new state.\",\"params\":[\"id\",\"dryRun\",\"If-Match\",\"Idempotency-Key\",\"name\",\"destinations\",\"settings\",\"customerContext\"]},{\"name\":\"get_customer\",\"description\":\"Read and update your organization's general settings. Returns the customer, including its general settings and contact info, scoped to `{customerId}`. `{customerId}` must match the customer resolved from the bearer token; a token scoped to a different customer gets `403`, even if that customer would otherwise be reachable through a reseller/MTS relationship. Requires the `Settings` permission.\",\"params\":[\"customerId\",\"customerContext\"]},{\"name\":\"update_customer\",\"description\":\"Read and update your organization's general settings. Partially updates the general settings and contact info of the customer identified by `{customerId}`. `{customerId}` must match the customer resolved from the bearer token; a token scoped to a different customer gets `403`, even if that customer would otherwise be reachable through a reseller/MTS relationship. Requires the `Settings` permission; updating `allowedInviteDomains` additionally requires the `UsersManager` permission.\\n\\nThe request body must use `application/merge-patch+json` (RFC 7396): an omitted field leaves the current value unchanged, and an explicit `null` also leaves it unchanged, except for `urlSlug`, where an explicit empty string removes the customer's active URL slug rather than leaving it unchanged.\\n\\nFields are nested exactly as `getCustomer` returns them - `currency` and `allowedInviteDomains` under `settings`, `emails` under `contact` - so every value is read and written at the same path. `settings.currency` accepts only the codes listed in the schema and cannot be cleared; `allowedInviteDomains` and `contact.emails` are cleared with an empty array.\",\"params\":[\"customerId\",\"urlSlug\",\"settings\",\"contact\",\"customerContext\"]},{\"name\":\"list_shared_payer_account_mappings\",\"description\":\"Link and manage shared-payer account mappings for PartnerOps resellers (T2), reassigning AWS accounts under a shared payer to T3 end customers. Lists the AWS accounts under the reseller's linked shared payers, together with the end customer each is currently mapped to. `{customerId}` (the reseller itself) means the account has not yet been reassigned to an end customer. Each payer's own management account is included alongside its member accounts. Requires the `SharedPayersAdmin` permission and the AWS integration (`pdi:aws`) entitlement. User API tokens must include the permission in their scope.\",\"params\":[\"customerId\",\"managementAccount\",\"customerContext\",\"pageToken\"]},{\"name\":\"list_shared_payer_management_accounts\",\"description\":\"Link and manage shared-payer account mappings for PartnerOps resellers (T2), reassigning AWS accounts under a shared payer to T3 end customers. Lists the reseller's linked shared-payer management (payer) accounts that have completed onboarding, for use in an account picker. Requires the `SharedPayersAdmin` permission and the AWS integration (`pdi:aws`) entitlement. User API tokens must include the permission in their scope.\",\"params\":[\"customerId\",\"customerContext\",\"pageToken\"]},{\"name\":\"list_shared_payers\",\"description\":\"Link and manage shared-payer account mappings for PartnerOps resellers (T2), reassigning AWS accounts under a shared payer to T3 end customers. Lists every shared payer linked to the reseller, including ones still mid-onboarding, with per-payer counts of linked and mapped accounts. Requires the `SharedPayersAdmin` permission and the AWS integration (`pdi:aws`) entitlement. User API tokens must include the permission in their scope.\",\"params\":[\"customerId\",\"customerContext\",\"pageToken\"]},{\"name\":\"reassign_shared_payer_account\",\"description\":\"Link and manage shared-payer account mappings for PartnerOps resellers (T2), reassigning AWS accounts under a shared payer to T3 end customers. Reassigns one AWS account under a linked shared payer - a member account or the payer's own management account - to the reseller itself or to a T3 end customer within its hierarchy. Requires the `SharedPayersAdmin` permission and the AWS integration (`pdi:aws`) entitlement. User API tokens must include the permission in their scope.\",\"params\":[\"customerId\",\"assetId\",\"customerContext\"]},{\"name\":\"list_customer_subscriptions\",\"description\":\"Create, view, update, and delete dashboard, report, commitment, alert, and budget subscriptions. This is not Organization-wide notifications. Lists dashboard, report, commitment, alert, and budget subscriptions visible to the caller. Items are ordered by `id` ascending. Nested `subscriptions` are ordered by `type` ascending. `maxResults` defaults to 50. An omitted value, `0`, or a value above 500 is treated as 50. A non-integer `maxResults` is `400`. Pass the response `pageToken` to request the next page. That field is absent when there are no more pages. A `pageToken` that matches no id is `400`. `rowCount` is the total number of subscriptions visible to the caller. That value is the same on every page.\\nOne subscription record is one item. Its dashboard, report, and commitment subscriptions are nested entries that share `recipients`. An alert is one item. A budget is one item. An alert or a budget never shares an item with a scheduled subscription. Draft budgets are omitted. An alert is included only when the tenant has the Governance Alerts entitlement and the caller can view that alert. When the entitlement is missing or cannot be confirmed, the list contains no alerts. An alert with no recipients is still included.\\nOne id namespace is shared by a scheduled subscription, an alert, and a budget. Create accepts only `dashboard-subscription`, `report-subscription`, and `commitment-manager`. Those scheduled types are the resource: create, recipient replace, subscription-set replace, and delete. GET returns alerts and budgets so a caller can see who receives them. Create, delete, and full management of those resources, including recipients, stay on `PATCH /analytics/v1/alerts/{id}` and `PATCH /analytics/v1/budgets/{id}`. PATCH on this API may replace those same recipient lists. DELETE of an alert or a budget returns `409` `customers.entry_is_resource`.\\nManage Settings users can view every subscription. A scheduled subscription is also visible to its creator when the caller has the permission for that type, to an owner, editor, or viewer of its source, and to one of its email recipients. Users Manager alone grants no access. A service-account token is evaluated from its own permissions and does not inherit the permissions of the subscription creator. A caller who can see only some nested subscriptions still receives that record; `subscriptions` omits the entries they cannot see. This endpoint is paginated: a response with a non-empty `pageToken` has more results, returned when that value is passed as the `pageToken` parameter. A missing, null, or empty `pageToken` marks the last page.\",\"params\":[\"maxResults\",\"pageToken\",\"customerContext\"]},{\"name\":\"create_customer_subscription\",\"description\":\"Create, view, update, and delete dashboard, report, commitment, alert, and budget subscriptions. This is not Organization-wide notifications. Creates one dashboard, report, or commitment subscription with one, two, or three scheduled subscriptions: `dashboard-subscription`, `report-subscription`, and `commitment-manager`. Create does not accept `alert` or `budget`. Each type appears at most once. The response is that subscription. Nested entries are ordered by `type`. `name` is `{source name} (Dashboard Subscription)`, `(Report Subscription)`, or `(Commitment Subscription)`, taken from the nested type that sorts first. `createdBy` is the caller.\\n`subscriptions` must contain one to three entries. A repeated type is `422` `customers.duplicate_subscription_type`. An `alert` or `budget` type, an empty `subscriptions` array, or any server-set field (`id`, `name`, `createdBy`, `etag`, `permissions`, `source.name`, `schedule.nextAt`) is `422` `validation_failed`. `source.id` must belong to the tenant. A missing or foreign source is `422` `validation_failed`. Recipient and schedule value rules are on `CustomerSubscriptionRecipients` and `CustomerSubscriptionScheduleInput`.\\nThe caller must be allowed to manage every sent type: a DoiT employee, Manage Settings, or the permission for that type. Users Manager alone grants no access.\\n`Idempotency-Key` is required. The same key, caller, customer, method, path, and body replays the stored success response. A different body for that key is `422` `idempotency_key_reused`. A missing key is `400` `idempotency_key_required`. While the first request is in progress, another request with that key is `409` `idempotency_request_in_progress`. A `4xx` response releases the key. `dryRun=true` does not reserve the key. It returns the would-be subscription with `id` and `etag` null and writes nothing.\\nReads are immediately consistent. After a `201`, a GET of that id returns the created subscription. The first delivery can take up to an hour.\",\"params\":[\"dryRun\",\"Idempotency-Key\",\"recipients\",\"subscriptions\",\"customerContext\"]},{\"name\":\"get_customer_subscription\",\"description\":\"Create, view, update, and delete dashboard, report, commitment, alert, and budget subscriptions. This is not Organization-wide notifications. Returns one dashboard, report, commitment, alert, or budget subscription. The body is the same object as a list item. `schedule` is omitted on an alert or a budget.\\nCreate does not accept `alert` or `budget`. GET returns them. PATCH may replace their recipient lists, which writes the same lists as `PATCH /analytics/v1/alerts/{id}` and `PATCH /analytics/v1/budgets/{id}`. Create, delete, and full management stay on those APIs. DELETE of an alert or a budget returns `409` `customers.entry_is_resource`.\\nManage Settings users can view the subscription. A scheduled subscription is also visible to its creator when the caller has the permission for that type, to an owner, editor, or viewer of its source, and to one of its email recipients. Users Manager alone grants no access. A service-account token is evaluated from its own permissions and does not inherit the permissions of the subscription creator. Keys the caller cannot see are omitted from `subscriptions`. A missing, foreign-tenant, or non-visible subscription returns `404` without revealing whether it exists.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_customer_subscription\",\"description\":\"Create, view, update, and delete dashboard, report, commitment, alert, and budget subscriptions. This is not Organization-wide notifications. Deletes a dashboard, report, or commitment subscription and every scheduled entry on it. Returns `204`. Deleting an id that is already gone also returns `204`, so a retry does not fail. `If-Match` is required when the document still exists; a stale value is `412`. An id that matches no scheduled subscription, alert, or budget returns `204` when `If-Match` is present.\\nCreate does not accept `alert` or `budget`. GET returns them. PATCH may replace their recipient lists. DELETE of an alert or a budget returns `409` `customers.entry_is_resource`.\\nThe caller must have `canDelete` for the subscription. Manage Settings users, a creator with the permission for each scheduled type, and a source owner or editor may delete it. Source viewers and recipients cannot. Users Manager alone grants no access. A service-account token is evaluated from its own permissions and does not inherit the permissions of the subscription creator.\\n`Idempotency-Key` is required. The same key, caller, customer, method, path, and `If-Match` replays the stored success response. A different `If-Match` is `422` `idempotency_key_reused`. A missing key is `400` `idempotency_key_required`. While the first request is in progress, another request with that key is `409` `idempotency_request_in_progress`. A `4xx` response releases the key. `dryRun=true` does not reserve the key and does not delete.\\nReads are immediately consistent. After a completed delete, a GET of that id returns `404`. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"dryRun\",\"If-Match\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"update_customer_subscription\",\"description\":\"Create, view, update, and delete dashboard, report, commitment, alert, and budget subscriptions. This is not Organization-wide notifications. Partially updates one dashboard, report, commitment, alert, or budget subscription with an `application/merge-patch+json` body (RFC 7396). The writable fields are `recipients.emails`, `recipients.slackChannels`, and, on a scheduled subscription, `subscriptions`. Any other field, `recipients: null`, or `null` for either recipient list is `422` `validation_failed`. A patch that sets neither `recipients` nor `subscriptions` is `422` `validation_failed`. A wrong `Content-Type` is `415`. Recipient and schedule value rules are on `CustomerSubscriptionRecipients`, `CustomerSubscriptionRecipientPatch`, and `CustomerSubscriptionScheduleInput`.\\nOn a scheduled subscription, `subscriptions` is the desired set of dashboard, report, and commitment subscriptions. A type in the body and not on the document is added. A type on the document and missing from the body is removed. A type in both is updated when `source.id` or the schedule differs, and `nextAt` is recalculated. A stored entry this API does not list stays on the subscription. An empty `subscriptions` array is `422` `validation_failed`; deleting the item is `DELETE`. A repeated type is `422` `customers.duplicate_subscription_type`. An omitted `subscriptions` array leaves the nested types unchanged.\\nCreate does not accept `alert` or `budget`. GET returns them. On an alert or a budget, `subscriptions` is accepted only when it is the one stored entry with the same `type` and `source.id` and no `schedule`. Any other array is `422` `validation_failed`. Those items never gain a dashboard, report, or commitment subscription. Alerts and budgets keep their own APIs for create, delete, and full management. This `PATCH` is the one write this API makes on them, and it may replace their recipient lists. DELETE of an alert or a budget returns `409` `customers.entry_is_resource`.\\nA patch whose normalized values match the stored values returns `200` and does not write. The `etag` is unchanged.\\nRecipient changes are allowed when the caller can edit every key on the document, including a key the response did not show. Otherwise they are allowed only when the caller removes exactly their own email: no added address, no Slack change, and no subscription-set change. Any other recipient change is `403`. The caller must be allowed to manage every added or changed scheduled type and to delete every removed type.\\n`If-Match` must contain the current strong ETag. The token only covers fields this API can write. `Idempotency-Key` is required. The same key, caller, customer, method, path, body, and `If-Match` replays the stored success response. A different body or `If-Match` is `422` `idempotency_key_reused`. A missing key is `400` `idempotency_key_required`. While the first request is in progress, another request with that key is `409` `idempotency_request_in_progress`. A `4xx` response rel\",\"params\":[\"id\",\"dryRun\",\"If-Match\",\"Idempotency-Key\",\"recipients\",\"subscriptions\",\"customerContext\"]},{\"name\":\"delete_user\",\"description\":\"Manage users who have access to the DoiT platform. Deletes a user. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"resend_invite\",\"description\":\"Manage users who have access to the DoiT platform. Resets the invite expiry to 48 hours from now, invalidates the previous invite token (so\\nold email links stop working), and triggers a fresh invitation email. Works on invites in\\nany state including `Cancelled` — resending a cancelled invite reactivates it to `Pending`.\\n\\nReturns `404` if no invite exists for the given ID (never created, or already accepted and removed).\\n\\nRequires `usersManager` permission.\\n\",\"params\":[\"id\",\"dryRun\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"cancel_invite\",\"description\":\"Manage users who have access to the DoiT platform. Marks the invite as `Cancelled` and invalidates the invite token so any outstanding email\\nlinks stop working. The invite document is retained (soft cancel) — the user row remains\\nvisible in `GET /iam/v1/users` with `inviteStatus: Cancelled`. Use `DELETE /iam/v1/users/{id}`\\nto fully remove the record.\\n\\nReturns `404` if no invite exists for the given ID, and `409` if the invite is already cancelled.\\n\\nRequires `usersManager` permission.\\n\",\"params\":[\"id\",\"dryRun\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"list_user_notifications\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Returns every personal notification config for the user as an unpaginated `{ \\\"items\\\": [...] }` array. One user has a handful of configs; there is no pagination. Items are ordered by `createTime` ascending, then by `id` ascending.\\nRequires Users Manager (`usersManager`). The user id must belong to the resolved tenant.\",\"params\":[\"userId\",\"customerContext\",\"pageToken\"]},{\"name\":\"create_user_notification\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Creates a personal notification config for the user. The request body has no email address; the server copies the target user's email onto the config as the sole destination. `settings` has one property per subscribed type and must include at least one. `costAnomalies` is optional.\\nRequires Users Manager (`usersManager`). The user id must belong to the resolved tenant. For each subscribed type other than `costAnomalies`, the target user must also hold that type's permission. The permission id for each type is documented on `UserNotificationSettings`. If they do not, the response is `403` and the problem body includes `permission` (the permission id) and `notificationType` (the settings property). A permission lookup that fails is `503`. If the permission service does not recognize an invited user, the response is `403`.\\nRequires the `Idempotency-Key` header so a retried create with the same key and body returns the original response and does not create a second config. With `dryRun=true` the request goes through the same checks as a real create and returns `200` with `X-Dry-Run: true` and null identity fields (`id`, `createTime`, `updateTime`, `etag`) without creating anything.\\nReads are immediately consistent. After a `201`, a GET of that notification returns the created config.\",\"params\":[\"userId\",\"dryRun\",\"Idempotency-Key\",\"name\",\"settings\",\"customerContext\"]},{\"name\":\"get_user_notification\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Returns one personal notification config. Requires Users Manager (`usersManager`). A subscribed type stays in the response when the target user later loses that type's permission; the type permission is not re-checked on read. A notification id that does not belong to this user in the resolved tenant returns `404`, without saying whether it exists elsewhere.\",\"params\":[\"userId\",\"id\",\"customerContext\"]},{\"name\":\"delete_user_notification\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Permanently deletes a personal notification config. Requires Users Manager (`usersManager`), the `If-Match` header, and the `Idempotency-Key` header. With `dryRun=true` the request goes through the same checks as a real delete without deleting anything. Deleting an id that no longer exists returns `404`.\\nReads are immediately consistent. After a completed delete (`204` without `X-Dry-Run: true`), a GET of that notification returns `404`. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"userId\",\"id\",\"dryRun\",\"If-Match\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"update_user_notification\",\"description\":\"Personal notification configs for a user, and organization-wide cost anomaly notifications. Partially updates a personal notification with an `application/merge-patch+json` body (RFC 7396). Omitted fields stay unchanged; nested objects are deep-merged; nested arrays (for example `allocations.ids`) are replaced when present. Optional resend fields are cleared with `null` (for example `\\\"settings\\\":{\\\"costAnomalies\\\":{\\\"repeat\\\":null}}`). Send `null` for a settings property to unsubscribe that type. Nulling the last remaining type is `422`, decided before the type-permission check, so the status does not depend on which permissions the target user holds. Requires Users Manager (`usersManager`). For each type still subscribed after the merge, other than `costAnomalies`, the target user must hold that type's permission, including when the patch does not mention that type (a rename included). The permission id for each type is documented on `UserNotificationSettings`. A missing permission is `403` with `permission` and `notificationType`. A permission lookup that fails is `503`. The request also requires the `If-Match` header and the `Idempotency-Key` header. With `dryRun=true` the request goes through the same checks as a real update and returns the notification as it would look after the patch, without changing anything.\\nReads are immediately consistent. After a completed update, a GET of that notification returns the new state.\",\"params\":[\"userId\",\"id\",\"dryRun\",\"If-Match\",\"Idempotency-Key\",\"name\",\"settings\",\"customerContext\"]},{\"name\":\"create_role\",\"description\":\"Manage user permissions and access levels in your organization. Creates a custom role in the authenticated customer with the given permission IDs. Permission IDs are the `permissions` values returned by `GET /iam/v1/roles`. A service account of a parent tenant can create the role in a descendant tenant by setting `X-Tenant-Id` to that tenant's customer ID. Requires the `Idempotency-Key` header so a retried request does not create a second role.\",\"params\":[\"Idempotency-Key\",\"name\",\"description\",\"permissions\",\"customerContext\"]},{\"name\":\"get_role\",\"description\":\"Manage user permissions and access levels in your organization. Returns a single role by ID. Preset roles are visible to every customer; a custom role is returned only to the customer that owns it. A service account of a parent tenant can read a descendant tenant's role by setting `X-Tenant-Id` to that tenant's customer ID.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_role\",\"description\":\"Manage user permissions and access levels in your organization. Deletes a custom role. Preset roles cannot be deleted, and a role still assigned to users or groups must be unassigned first. A service account of a parent tenant can delete a descendant tenant's role by setting `X-Tenant-Id` to that tenant's customer ID. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"update_role\",\"description\":\"Manage user permissions and access levels in your organization. Updates the `name`, `description` and/or `permissions` of a custom role. Only the fields present in the body change; `permissions` replaces the full list when present. Preset roles cannot be modified. A service account of a parent tenant can update a descendant tenant's role by setting `X-Tenant-Id` to that tenant's customer ID.\",\"params\":[\"id\",\"name\",\"description\",\"permissions\",\"customerContext\"]},{\"name\":\"list_service_accounts\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Returns every service account owned by the authenticated customer in a single unpaginated `items` array, in no guaranteed order. Requires the `serviceAccountViewer` permission.\",\"params\":[\"customerContext\",\"pageToken\"]},{\"name\":\"create_service_account\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Creates a service account owned by the authenticated customer. It cannot authenticate anything until it has an API token; mint one with the `api-tokens` sub-resource. Returns `409` when another service account of the customer already uses `name`. With `dryRun=true` the request goes through the same checks as a real create (name bounds and uniqueness, permission names, caller scope) and returns the same errors without creating anything. When the caller authenticates with a service account token, `createdBy`, `createdByEmail` and `createdByUserId` are `null`. Requires the `serviceAccountCreator` permission.\",\"params\":[\"dryRun\",\"Idempotency-Key\",\"name\",\"description\",\"permissions\",\"customerContext\"]},{\"name\":\"get_service_account\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Returns a service account owned by the authenticated customer; an ID that belongs to another customer returns `404`. The `ETag` response header carries the value to send in `If-Match` on update and delete. Requires the `serviceAccountViewer` permission.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"delete_service_account\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Permanently deletes a service account and all of its API tokens, which stop authenticating immediately. Deleting an ID that no longer exists returns `404`. Requires the `serviceAccountManager` permission. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"id\",\"dryRun\",\"If-Match\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"update_service_account\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Partially updates a service account with an `application/merge-patch+json` body (RFC 7396). Omitted or `null` fields stay unchanged; an explicit empty string clears `description`. `permissions` replaces the whole list, and `[]` removes every permission. With `dryRun=true` the request goes through the same checks as a real update (`If-Match`, name bounds and uniqueness, permission names, caller scope) and returns the service account as it would look after the patch, without changing anything. Requires the `serviceAccountManager` permission.\",\"params\":[\"id\",\"dryRun\",\"If-Match\",\"Idempotency-Key\",\"name\",\"description\",\"permissions\",\"customerContext\"]},{\"name\":\"list_service_account_tokens\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Returns the service account's non-deleted API tokens in a single unpaginated `items` array, at most 10. Secret material is never returned here — `accessToken` is shown only once, by the create operation. Requires the `serviceAccountViewer` permission.\",\"params\":[\"serviceAccountId\",\"customerContext\",\"pageToken\"]},{\"name\":\"create_service_account_token\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Mints an API token for the service account and returns its `accessToken` once. The token\\ninherits the service account's permissions as they stand at creation; there is no per-token\\nscoping. Returns `409` when the service account already has a token of the same name, and\\n`422` at the cap of 10 tokens.\\n\\n`dryRun=true` checks the name bounds only, then returns a preview without creating anything.\\nIt does **not** verify that the service account exists, that the name is unused, or that the\\naccount is under the token cap, so a dry run can succeed where the real create then returns\\n`404`, `409` or `422`. Requires the `serviceAccountCreator` permission.\\n\",\"params\":[\"serviceAccountId\",\"dryRun\",\"Idempotency-Key\",\"name\",\"expiresTime\",\"customerContext\"]},{\"name\":\"get_service_account_token\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Returns one API token of the service account; an ID that belongs to another customer returns `404`. `accessToken` is not included — it is shown only once, by the create operation. Requires the `serviceAccountViewer` permission.\",\"params\":[\"serviceAccountId\",\"id\",\"customerContext\"]},{\"name\":\"delete_service_account_token\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Permanently deletes an API token, which stops authenticating immediately. This cannot be undone. Deleting an ID that no longer exists returns `404`. Requires the `serviceAccountManager` permission. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"serviceAccountId\",\"id\",\"dryRun\",\"Idempotency-Key\",\"customerContext\"]},{\"name\":\"update_service_account_token\",\"description\":\"Manage non-human identities whose API tokens call the DoiT API with a fixed set of permissions. Moves the token between `active` and `disabled` by setting `state`. Disabling takes effect\\nimmediately: the token stops authenticating until it is re-enabled. Setting the state a\\ntoken already has succeeds and changes nothing.\\n\\nThe two directions are not symmetric. Disabling a token whose expiry has passed succeeds,\\nbut re-enabling an expired token returns `422` — expiry is final, and a new token has to be\\ncreated instead. `deleted` and `expired` are not accepted values: a token is deleted through\\nthe delete operation, and expires on its own.\\n\\nWith `dryRun=true` nothing is written and the response body is the token as it would look\\nafter the change, so a `422` here means a real request would also be refused. Requires the\\n`serviceAccountManager` permission.\\n\",\"params\":[\"serviceAccountId\",\"id\",\"dryRun\",\"Idempotency-Key\",\"state\",\"customerContext\"]},{\"name\":\"id_of_asset\",\"description\":\"Manage cloud resources or services in your cloud environment. Updates an existing asset, such as G Suite/Workspace or Office 365 subscription, to add or remove licenses.\",\"params\":[\"id\",\"quantity\",\"customerContext\"]},{\"name\":\"update_ticket\",\"description\":\"Create and manage support tickets with DoiT. Partially updates a support request. Supports setting the request\\n`status` and/or `assignee`. DoiT employees may set any of `open`,\\n`pending`, `hold`, or `solved` and may set the `assignee`; customers may\\nset only `solved` (parity with the console \\\"mark as resolved\\\" action)\\nand may not set an assignee. `closed` is not settable via the API\\n(Zendesk auto-closes from `solved`). The `assignee` is a DoiT-employee\\nemail, resolved server-side to a Zendesk agent; an email that does not\\nresolve to an active agent returns `400`. At least one mutable field\\nmust be present. The response echoes the fields that were applied.\",\"params\":[\"ticketId\",\"status\",\"assignee\",\"customerContext\"]},{\"name\":\"list_ticket_tags\",\"description\":\"Create and manage support tickets with DoiT. Returns the tags currently set on a support request.\\n\\nDoiT employee (doer) callers receive the full tag set verbatim,\\nincluding internal namespaces (e.g. `tier/*`, `synapse_*`). Customer\\ncallers receive only tags under the `customer_tag/` namespace, with\\nthat prefix stripped (e.g. a tag added as `billing` reads back as\\n`billing`). Always present; empty array when the caller has no visible\\ntags.\",\"params\":[\"ticketId\",\"customerContext\",\"pageToken\"]},{\"name\":\"add_ticket_tags\",\"description\":\"Create and manage support tickets with DoiT. Adds one or more tags to an existing support request. The operation is\\nsurgical — only the tags listed in the request are added; existing tags\\non the ticket are preserved. Re-adding a tag that is already present is\\na successful no-op.\\n\\nAll submitted tags are normalized (trim + lowercase) before storage. For\\ncustomers, the system additionally applies a `customer_tag/` namespace\\nprefix to prevent collisions with internal DoiT process tags. The\\nresponse echoes the actual stored strings so callers can verify the\\ntransform.\",\"params\":[\"ticketId\",\"tags\",\"customerContext\"]},{\"name\":\"remove_ticket_tags\",\"description\":\"Create and manage support tickets with DoiT. Removes one or more tags from an existing support request. The operation\\nis surgical — only the tags listed in the request are removed; tags not\\nlisted are preserved. Removing a tag that is not present is a successful\\nno-op.\\n\\nFor customers, the system applies the same `customer_tag/` namespace\\nmapping as on add, so a customer who added `my_tag` (stored as\\n`customer_tag/my_tag`) can remove it by sending `my_tag`. Two-step: a call with valid arguments deletes nothing. It returns `status: \\\"approval_required\\\"` with a summary of the exact request and a one-time `approvalToken`. The saved request runs only when `confirm_action` is called with that token after the user approves the summary. The token is bound to the caller and expires after 5 minutes.\",\"params\":[\"ticketId\",\"tags\",\"customerContext\"]},{\"name\":\"get_statussheet_components\",\"description\":\"Cloud Diagrams visualize your cloud infrastructure and resource relationships. Returns the specified components of a diagram layer. Provide at least one component\\ntype with one or more IDs in the request body (for example, `node` or `element`).\",\"params\":[\"id\",\"p\",\"node\",\"element\",\"link\",\"group\",\"attachment\",\"note\",\"combiner\",\"customerContext\"]},{\"name\":\"export_cloud_diagram_json\",\"description\":\"Cloud Diagrams visualize your cloud infrastructure and resource relationships. Exports the full content of a diagram layer as a structured JSON document,\\nincluding all components and export metadata.\",\"params\":[\"id\",\"customerContext\"]},{\"name\":\"list_cloud_diagram_layer_snapshots\",\"description\":\"Cloud Diagrams visualize your cloud infrastructure and resource relationships. Returns the list of saved snapshots for the specified diagram layer.\",\"params\":[\"id\",\"offset\",\"limit\",\"sort\",\"customerContext\",\"pageToken\"]},{\"name\":\"get_cloud_diagram_layer_snapshot\",\"description\":\"Cloud Diagrams visualize your cloud infrastructure and resource relationships. Returns a single snapshot of the specified diagram layer identified by its ID.\",\"params\":[\"id\",\"snapshot_id\",\"customerContext\"]},{\"name\":\"ava_feedback\",\"description\":\"Interact with Ava, DoiT's AI-powered cloud assistant. Submit feedback on an Ava answer to help improve response quality.\",\"params\":[\"conversationId\",\"answerId\",\"feedback\",\"customerContext\"]}],\"toolsHash\":\"0ade0a558cc40ff33ebebf3d84413cb30c63416a91936817e209493cafdc7e1d\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:29:09.178Z\",\"calls\":[{\"tool\":\"list_cloud_connections\",\"ok\":false,\"ms\":4,\"bytes\":0,\"error\":\"tool reported an error: Unauthorized\"},{\"tool\":\"get_cloud_overview\",\"ok\":false,\"ms\":0,\"bytes\":0,\"error\":\"tool reported an error: Unauthorized\"},{\"tool\":\"get_cloud_incidents\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: Unauthorized\"},{\"tool\":\"get_cloud_incident\",\"ok\":false,\"ms\":0,\"bytes\":0,\"error\":\"tool reported an error: Unauthorized\"},{\"tool\":\"get_anomalies\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: Unauthorized\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OjA3NWM3MGFkNjBhYjQ5ZWZhOGQwNDI5MWU5ZTMxOTQzZTIwMjQ5YjIzMzM3Y2E1MjgzODZjMGM5YjY5ZGU5OTUiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTM5NSIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyODg1MywiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjg1NTMsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiZWViYTdhOWQtNjcyNC00MDU5LWI5YmEtNmFjNTQzZDc3MDUwIiwibmJmIjoxNzk0ODI4MjUzLCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.WEyHmHf-KcAgKOCap3Q9MTWVaDfjHi5SZsBuY0N2wDCgfYBahgDUZJhjduy-85IHrr-ufce-XCzkmaJcDM_lRMXL-WfYQqLTjhXqQ1C4zXbjkvRgqZrtdIa9hUpNc98zi16cJYPrgqv7nqcC7goXLcoDzNcc_ZmZV3lt8NLO8Mf557S32qDV5W-7nPDtjM3d_xqbMyIlci29BEnujtQfb4g9ohQHoNngnjGCpbVuGfzGbLB9rZ4ksWfcxX5qYCEIGOdUv0Of05JkvsgzP7mYRqjbeyKKM20B8GRQYZw4huXQtKzXrVBKp6qN5M0TJe3TaEKLg9sT7Z5MQxs3TjgRZw"}