Azure Stack Admin - Servicehealth MCP Server Integration Guide
Quick Start Architecture Summary
The Azure Stack Admin - Servicehealth MCP server is a Model Context Protocol integration that connects AI assistants (Claude Desktop, Cursor IDE, VS Code, Zed) to the Azure Stack Admin - Servicehealth API through natural language directives. It exposes 2 API operations as callable MCP tools, including ServiceHealths_List, ServiceHealths_Get. No authentication is required — operates out of the box immediately. Sourced from the auto Azure Stack Admin - Servicehealth OpenAPI specification (v2016-05-01) with an overall quality score of 28/99.
Technical Overview & Protocol Integration
The InfrastructureInsightsManagementClient API, provided by Microsoft as part of the Azure Resource Manager framework, serves as a critical interface for monitoring the operational health and availability of infrastructure resources within an Azure subscription.
By converting the OpenAPI 3.0 specification for Azure Stack Admin - Servicehealth into native Model Context Protocol (MCP) tool definitions, developers and AI agents gain programmatic access to endpoints over stdio or HTTP transports. Every endpoint is translated into a discrete tool payload complete with input argument validation, parameter descriptions, and return type definitions.
This setup enables LLM agents to execute multi-step workflows, search records, mutate state, and analyze responses safely within local desktop client sessions like Claude Desktop and Cursor IDE.
2. Technical Specifications Matrix
System Specifications
| API Name | Azure Stack Admin - Servicehealth |
| Slug Identifier | azure-com-azsadmin-servicehealth |
| Category | Data & Analytics |
| Auth Method | None Required |
| Endpoint Count | 2 tools mapped |
| Spec Version | OpenAPI v2016-05-01 |
| Transport Type | STDIO |
| Publisher Source | auto |
Developer Resources
3. Multi-Client Installation Matrix
Copy and paste these pre-formatted JSON snippets into your MCP client configuration files.
Claude Desktop
Add to claude_desktop_config.json
{
"mcpServers": {
"azure-com-azsadmin-servicehealth": {
"command": "npx",
"args": [
"-y",
"@mcp/azure-com-azsadmin-servicehealth"
],
"env": {
"INFRASTRUCTUREINSIGHTSMANAGEMENTCLIENT_API_KEY": "your_infrastructureinsightsmanagementclient_api_key"
}
}
}
}Cursor IDE
Settings → MCP Servers → Add Hosted Config
{
"mcpServers": {
"azure-com-azsadmin-servicehealth": {
"url": "https://mcpbridge.org/config/azure-com-azsadmin-servicehealth.json"
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code / Cline
Use with MCP extension config
{
"mcpServers": {
"azure-com-azsadmin-servicehealth": {
"url": "https://mcpbridge.org/config/azure-com-azsadmin-servicehealth.json"
}
}
}4. Environment Variables & Authentication Reference
Key parameters and credential variable mappings for Azure Stack Admin - Servicehealth.
| Variable Name | Required | Example Value |
|---|---|---|
| INFRASTRUCTUREINSIGHTSMANAGEMENTCLIENT_API_KEY | REQUIRED | your_infrastructureinsightsmanagementclient_api_key |
5. Endpoints & Tool Schemas Matrix
Search and inspect the 2 tool signatures mapped from OpenAPI.
Executable Code Integration Examples
Call Azure Stack Admin - Servicehealth endpoints via cURL, TypeScript, or Python REST SDKs.
curl -X GET "https://api.apis.guru/v2/specs/azure.com/azsadmin-ServiceHealth/2016-05-01/swagger.json/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.InfrastructureInsights.Admin/regionHealths/{location}/serviceHealths" \
-H "Content-Type: application/json" \
# No auth required6. Real-World AI Assistant Prompts
Prompt directives for invoking Azure Stack Admin - Servicehealth operations inside AI client chats.
1. Information Search & Resource Querying
Read Query"Use Azure Stack Admin - Servicehealth MCP server tools to search resources matching path '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.InfrastructureInsights.Admin/regionHealths/{location}/serviceHealths' and summarize available properties."
2. Action Execution & API Payload Creation
Action Execution"Call Azure Stack Admin - Servicehealth operation '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.InfrastructureInsights.Admin/regionHealths/{location}/serviceHealths' with parameters configured for environment testing."
3. Multi-Step API Workflow Automation
Workflow Automation"Inspect recent responses from Azure Stack Admin - Servicehealth API, extract target identifiers, and format a clean diagnostic report."
4. Introspection & Schema Audit
Introspection"Retrieve the full OpenAPI tool schema list for Azure Stack Admin - Servicehealth MCP server and generate a technical summary of capabilities."
7. Error Resolution & Troubleshooting Guide
HTTP status codes and JSON-RPC protocol error resolution matrix.
400 Bad RequestRoot Cause: Malformed request payload parameters or missing required JSON Schema fields.
Resolution Action: Verify request schema in Section 5 tool specifications before calling operation.
401 UnauthorizedRoot Cause: Missing or invalid API key credentials in MCP environment config.
Resolution Action: Define required key in client config under env object.
403 ForbiddenRoot Cause: Insufficient scope permissions or unauthorized resource access.
Resolution Action: Check key permissions in developer control panel.
404 Not FoundRoot Cause: Resource URL path or requested target ID does not exist.
Resolution Action: Inspect path parameters and resource ID values.
429 Rate Limit ExceededRoot Cause: Upstream API rate limit quota exceeded.
Resolution Action: Implement exponential backoff retry in tool execution loop.
500 Internal Server ErrorRoot Cause: Upstream service runtime fault or stdio process crash.
Resolution Action: Inspect STDIO stderr output stream for diagnostic trace.
8. Quality Scorecard & Audit Metadata
Automated evaluation metrics for OpenAPI specification quality.
Similar Data & Analytics APIs
Amazon Comprehend MCP
Amazon Comprehend is a sophisticated natural language processing (NLP) service provided by Amazon Web Services (AWS) that enables developers to extract meaningful insights and analyze the content of text documents at scale. Its core capabilities extend far beyond basic keyword matching, leveraging pre-trained machine learning models to perform complex linguistic analysis. The service can identify the predominant language, dissect sentiment (positive, negative, neutral, or mixed), recognize named entities such as people, places, and organizations, extract key phrases, and perform syntactic analysis to understand parts of speech and sentence structure. Furthermore, it offers specialized features for detecting and redacting personally identifiable information (PII), classifying documents into custom-defined categories, and analyzing sentiment directed at specific entities within text. This makes it a foundational tool for enterprises needing to process vast volumes of unstructured text data, with use cases ranging from customer review analysis, chatbot intent recognition, and content recommendation engines to compliance monitoring and automated document sorting.
Amazon Kinesis Firehose MCP
Amazon Kinesis Data Firehose is a fully managed service provided by Amazon Web Services (AWS) designed to reliably capture, transform, and load streaming data at scale into AWS data stores and analytics services. Its core capability lies in its ability to handle continuous, high-throughput data streams from millions of sources, including application logs, clickstream data, IoT sensor telemetry, and database change data capture (CDC) streams. The service excels at real-time delivery, allowing users to ingest data and have it routed and delivered to destinations such as Amazon Simple Storage Service (S3) for data lake storage, Amazon OpenSearch Service for real-time log analytics, Amazon Redshift for near real-time business intelligence dashboards, and third-party platforms like Splunk for operational monitoring. Typical enterprise use cases involve building foundational data pipelines for big data analytics, enabling real-time security event monitoring, implementing centralized logging for distributed applications, and powering live dashboards that require sub-second data freshness. It removes the operational burden of managing infrastructure and software for streaming data ingestion, offering features like automatic scaling, data transformation with AWS Lambda, and flexible data backup mechanisms.
Amazon Kinesis MCP
Amazon Kinesis Data Streams (KDS) is a fully managed, scalable service provided by Amazon Web Services (AWS) designed for real-time ingestion, buffering, and processing of streaming data at massive scale. The Kinesis Data Streams Service API Reference details a comprehensive set of programmatic actions for administering and interacting with Kinesis data streams, which serve as the foundational "plumbing" for real-time data pipelines. Its core capabilities encompass the entire lifecycle of a stream, from creation and configuration to monitoring and deletion. Through these API endpoints, developers and administrators can programmatically create streams with specified shard counts, adjust retention periods for data accessibility, tag streams for cost allocation and organization, manage enhanced monitoring metrics, and control stream consumers for specialized read access. Typical enterprise use cases include real-time application monitoring and log aggregation, live feeds from IoT sensors and devices, real-time analytics on clickstream data, and capturing financial transaction data for immediate processing, fraud detection, or loading into data lakes and warehouses.
AWS Kinesis Analytics - Kinesisanalytics MCP
Amazon Kinesis Analytics (version 1) is a managed service provided by Amazon Web Services (AWS) that enables developers to query and analyze streaming data in real time using standard SQL. The API serves as the programmatic interface for creating, configuring, and managing analytics applications that continuously process and analyze data from streaming sources such as Amazon Kinesis Data Streams or Amazon Kinesis Data Firehose. Core capabilities include creating and deleting applications, defining and modifying input sources, configuring output destinations, adding reference data for enrichment, and setting up logging to Amazon CloudWatch for monitoring and debugging. This service is foundational for enterprise use cases requiring real-time operational intelligence, such as fraud detection in financial transactions, live monitoring of IT infrastructure logs, real-time analytics on clickstream data for e-commerce personalization, and operational dashboards that visualize system health metrics as they occur. It transforms raw streaming data into actionable insights with minimal latency, reducing the need for complex batch processing pipelines.