MCP Tools: Costs, Resources, and Recommendations
Overview
The Spotto MCP server exposes 112 tools organized by feature area: 70 read tools and 42 write tools. 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.
Endpoint Profiles and Permissions
The MCP endpoint profile you connect to decides which tools your client sees. Your API key's role decides which of those calls succeed: Spotto checks every call, so a tool can appear and still return a permission error.
Profile behavior:
| Profile | What you see |
|---|---|
full | All 112 tools |
read | The 70 read tools |
write | The 42 write tools |
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?"
Compiled Environment Evidence
Use compiled environment documents for broad questions that span cost, security, governance, reliability, performance, and operations. These documents are read-only evidence generated by Spotto and remain subject to the API key's company, subscription, and feature permissions.
| Tool | Description |
|---|---|
get-company-environment-document | Read one page of subscription environment documents concurrently for a company. Use document: "cost" for company-wide cost optimization. |
get-subscription-environment-document | Read a compiled Markdown document for one subscription. |
get-subscription-environment-evidence | Follow a validated generation-bound evidence reference from a subscription document. |
get-tenant-environment-document | Read a compiled Markdown document for one connected tenant. |
get-tenant-environment-evidence | Follow a validated generation-bound evidence reference from a tenant document. |
The company tool reads at most 50 subscriptions per page with up to six concurrent API requests. coverage.complete applies to the current page. Follow nextOperation while coverage.hasMore is true, and claim company-wide coverage only when every page is complete and the final page reports hasMore: false.
MCP operations have a four-minute server deadline. Your MCP client may have a shorter timeout of its own. If a request times out at the client, retry with a smaller limit rather than increasing concurrency beyond six.
Example prompts:
- "Find cost optimization opportunities across KMD Brands"
- "Summarize reliability risks across every subscription in this company"
- "Show the evidence behind the highest-impact security finding"
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"
Main Tool Categories
| Category | What You Can Do |
|---|---|
| Getting Started | Verify connectivity, check permissions |
| Subscriptions | Browse resources, view summaries, check retirements |
| Cost Analysis | Analyze spending, detect anomalies, view trends |
| Environment Evidence | Analyze compiled cross-domain evidence by company, subscription, or tenant |
| Recommendations | View, implement, dismiss, prioritize, and share recommendations |
| Company Management | View organization structure and access |
| User Administration | Manage users and roles |
| Dashboards | Configure portal dashboards |
Permissions
Each call runs with the API key's role, in the key's company or a child company its role covers:
- Company Viewer: view company information and basic portal data.
- Company Administrator: manage users, settings, integrations and day-to-day access for the company.
- Accounts Administrator: manage cloud accounts, subscriptions, API keys and connector settings.
The company must also receive the feature behind the tool. If a tool returns a permission error, ask your Spotto administrator to check the key's role and the company's feature sets.
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:
- Confirm your role in the Spotto Portal and whether you have access to the company/subscription in question.
- 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:
- Confirm you’re querying the intended company.
- 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