MCP Tools: Costs, Resources, and Recommendations

Overview

The Spotto MCP server exposes 50+ tools organized by feature area. Your AI assistant can use these tools to query your cloud data, manage recommendations, and perform administrative tasks.

You Don't Need to Memorize These

When you ask questions in natural language, your AI assistant automatically selects the appropriate tools. This reference is helpful for understanding what's possible and for troubleshooting.

Endpoint Profiles and Permissions

The tools your client sees depend on two things:

1. Your Spotto permissions
2. The MCP endpoint profile you connected to

Profile behavior:

Profile	What you see
full	The combined Spotto tool catalog
read	Read-oriented tools only
write	Write-oriented tools only

If you are using the read endpoint, tools for dismissing, sharing, prioritizing, updating, or creating will not appear. If you are using the write endpoint, the opposite is true. See MCP Endpoint Profiles for the regional URLs and selection guidance.

Getting Started

These tools help verify your connection and understand your access level.

Tool	Description
get-api-status	Check API health and connectivity
get-current-user	Get your user profile and permissions
list-companies	List all companies you have access to

Example prompts:

• "Check if the Spotto connection is working"
• "What companies can I access?"
• "What permissions do I have?"

Subscriptions & Resources

Browse your Azure subscriptions and drill into resource details.

Tool	Description
list-company-subscriptions	List Azure subscriptions for a company
get-azure-subscription	Get full subscription details including resources
get-azure-subscription-summary	Get subscription summary (costs, secure score, resource counts)
get-azure-resource-detail	Get detailed information for a specific resource
get-subscription-history	Get 12 months of historical metrics
get-service-retirements	List upcoming Azure service retirements

Example prompts:

• "List all subscriptions for Acme Corp"
• "Show me the resources in subscription prod-001"
• "What's the secure score for my production subscription?"
• "Are any Azure services being retired that affect my subscriptions?"

Cost Analysis

Understand your cloud spending with detailed cost breakdowns and trend analysis.

Tool	Description
list-azure-billing-tree-files	List available cost breakdown views
get-azure-billing-tree	Get hierarchical cost breakdown by service, resource group, or tag
get-azure-billing-plots	Get cost trends and anomaly detection data

Example prompts:

• "Show me a cost breakdown by resource group for the last 30 days"
• "What's driving costs in my analytics subscription?"
• "Are there any cost anomalies I should know about?"
• "How has my storage spend changed month over month?"

Recommendations

Access and act on optimization recommendations from Azure Advisor and Spotto's custom analysis.

Viewing Recommendations

Tool	Description
get-subscription-recommendations	Get all recommendations for a subscription
get-azure-recommendation-detail	Get detailed information about a specific recommendation
list-resource-recommendations	List recommendations affecting a specific resource

Example prompts:

• "What are my top cost-saving opportunities?"
• "Show me security recommendations for production"
• "What recommendations exist for my SQL databases?"

Acting on Recommendations

Tool	Description
implement-recommendation-multi	Mark recommendations as implemented (bulk)
dismiss-recommendation-multi	Dismiss recommendations with a reason
prioritize-recommendation-multi	Set priority level for recommendations
share-recommendation	Share via email, Slack, Teams, or Jira

Example prompts:

• "Dismiss the VM rightsizing recommendation for batch-server—we need the extra capacity"
• "Mark the reserved instance recommendations as implemented"
• "Share the storage optimization recommendations to #infrastructure on Slack"
• "Create a Jira ticket for the high-priority security recommendations"

Company Management

Manage your Spotto organization structure and access.

Tool	Description
get-company	Get company profile and settings
list-company-users	List users in a company
list-company-cloudaccounts	List connected Azure tenants
list-company-apikeys	List API keys for a company

Example prompts:

• "Who has access to the production company?"
• "List all connected Azure tenants"
• "Show me the API keys for Acme Corp"

User Administration

Manage user access and invitations.

Tool	Description
invite-user	Send an invitation to a new user
update-user-role	Change a user's role
remove-user	Remove a user from a company

Example prompts:

• "Invite alice@example.com as a viewer to the analytics team"
• "Change Bob's role to admin"
• "Remove the inactive user from the company"

Dashboard Configuration

Customize Spotto portal dashboards.

Tool	Description
get-dashboard-layout	Get current dashboard widget configuration
update-dashboard-layout	Modify dashboard layout and widgets

Example prompts:

• "What widgets are on my dashboard?"
• "Add a cost trend widget to the dashboard"

Tool Categories Summary

Category	Tools	What You Can Do
Getting Started	3	Verify connectivity, check permissions
Subscriptions	6	Browse resources, view summaries, check retirements
Cost Analysis	3	Analyze spending, detect anomalies, view trends
Recommendations	7	View, implement, dismiss, prioritize, and share recommendations
Company Management	4	View organization structure and access
User Administration	3	Manage users and roles
Dashboards	2	Configure portal dashboards

Permissions

The tools available to you depend on your role:

• Viewer: Read-only access to subscriptions, resources, costs, and recommendations
• Editor: Viewer permissions plus ability to act on recommendations
• Admin: Full access including user management and company settings

If a tool returns a permission error, check with your Spotto administrator about your role.

Troubleshooting

A tool returns “permission denied”

What you're seeing: A tool call fails due to permissions. Likely causes: Your Spotto role doesn’t allow that operation (especially write actions). How to fix:

1. Confirm your role in the Spotto Portal and whether you have access to the company/subscription in question.
2. Ask a company administrator to grant the required role if you need that action.

A tool returns empty results

What you're seeing: The tool succeeds but returns no subscriptions/resources/recommendations. Likely causes:

• The company context is wrong.
• Data sync hasn’t completed yet. How to fix:

1. Confirm you’re querying the intended company.
2. Check sync status in the Spotto Portal and retry after the next successful sync.

Next Steps

• Example Queries — See these tools in action with real conversation examples