Available Tools
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.
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.
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 [email protected] 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.
Next Steps
- Example Queries — See these tools in action with real conversation examples