Skip to main content

SRE Agent MCP Server

TL;DR
  • Manage your SRE Agent from any MCP-compatible client, including VS Code, Copilot CLI, Cursor, Claude Desktop, and custom agent frameworks
  • Start investigations, configure connectors, search memories, and manage scheduled tasks in natural language
  • Two RBAC roles required: Reader (ARM) + SRE Agent Administrator (data plane)
  • No agent-side configuration needed. The Azure MCP Server discovers agents dynamically.
  • Secrets are redacted before reaching your client. Destructive operations require explicit confirmation.

Your agent's expertise, wherever you work

Your SRE Agent builds deep context about your services over time: incident patterns, architecture details, operational expertise. With the SRE Agent MCP Server, that knowledge is available directly in your IDE, terminal, or AI assistant.

During coding, debugging, or incident response, you can ask your agent a question, start an investigation, or configure a connector without switching tools. Your development environment and your agent's operational intelligence connect through the same natural language interface you already use.

How to connect

The SRE Agent tools are part of the Azure MCP Server, which implements the Model Context Protocol (MCP). You install the Azure MCP Server in your MCP client, and the SRE Agent tools become available alongside other Azure tools. The server runs locally via npx and handles authentication, endpoint resolution, and API calls on your behalf.

Two API layers handle different operations:

LayerWhat it handlesAuthentication
Control plane (ARM)Agent resources, connectorsReader role via Azure Resource Manager
Data planeThreads, memories, tasks, skills, incidentsSRE Agent Administrator role via agent endpoint (*.azuresre.ai)

The server resolves agent endpoints automatically through Azure Resource Graph. You provide a subscription and agent name, and the server finds the endpoint.

Tools appear with the sreagent_ prefix in your MCP client (for example, sreagent_agents_list, sreagent_threads_create).

Permissions

Two Azure RBAC roles on the Microsoft.App/agents resource:

RoleScopeWhat it enables
ReaderControl plane (ARM)List and get agents, connectors
SRE Agent AdministratorData planeThreads, memories, scheduled tasks, skills, hooks, prompts, incidents, workflows

Supported clients

ClientInstallation method
VS Code with GitHub CopilotInstall the Azure MCP Server extension, sign in to Azure
GitHub Copilot CLI/mcp add or manual config in ~/.copilot/mcp.json
CursorAdd to MCP configuration
Claude CodeAdd to user or project MCP configuration
Claude DesktopInstall MCPB bundle or configure local server command
Other MCP clientsConfigure with npx, dotnet, uvx, Docker, or other supported methods

What you can do

Key capability areas, each accessible through natural language prompts:

AreaOperationsExample prompt
Manage agentsList, get details, create/delete sub-agents"List my SRE agents in subscription X"
Configure connectorsCreate Kusto/MCP connectors, test, delete"Create a Kusto connector named prod-logs on agent Y"
Run investigationsCreate threads, send messages, autonomous investigation"Investigate why production API has elevated latency"
Schedule workCreate, pause, resume, delete scheduled tasks"Pause the nightly scheduled task on agent Y"
Manage incidentsList active incidents, set up PagerDuty/ServiceNow"List active incidents on agent Y"
Knowledge and promptsSearch/upload memories, manage common prompts"Search memories for 'deployment failures'"
Author workflowsGenerate, validate, apply YAML workflows"Generate a workflow for automated rollback"

Autonomous investigation

The investigate command runs a multi-turn investigation loop. Your agent reasons about the problem, requests data, forms hypotheses, and follows up automatically.

  • Default limits: 20 iterations, 10-minute timeout (both configurable via --max-iterations and --timeout-seconds)
  • Standard mode: Pauses at approval gates for human confirmation
  • Auto-approval mode (investigate_yolo): Continues through all gates autonomously
Use auto-approval mode with extreme caution

The investigate_yolo command auto-approves all approval gates, including actions that modify your infrastructure (pod deletion, Kubernetes YAML application, scaling, incident state changes). There is no read-only restriction. The agent may invoke any tool its managed identity permits. Do not use in production unless you accept fully autonomous infrastructure modification.

SRE Agent MCP server vs MCP connectors

These are opposite directions of the same protocol:

FeatureDirectionUse case
SRE Agent MCP server (this page)Your IDE/CLI calls into SRE AgentManage and operate agents from your development environment
MCP connectorsSRE Agent calls out to external MCP serversExtend your agent with Datadog, GitHub, Splunk tools

Safety guardrails

ProtectionWhat it does
Destructive confirmationDelete operations require --confirm true. No accidental teardowns.
Approval gatesWrite operations require human approval in standard mode. In auto-approval mode (investigate_yolo), all gates are bypassed.
Secret redactionCommon credential patterns including bearer tokens, API keys, and passwords are stripped from responses before reaching your client. This is pattern-based and best-effort — do not rely on it as the sole control preventing credential exposure. Ensure agent tools avoid returning raw credentials in their output.
Error sanitizationUpstream error bodies are scrubbed for credentials and truncated
Endpoint pinningData-plane calls restricted to allowed Azure SRE domains (HTTPS only)
Third-party host validationServiceNow restricted to .service-now.com; PagerDuty subdomains validated
MCP connector secretsEnvironment values must use ${env:NAME} syntax. Literal secrets are rejected.
CapabilityWhat it adds
MCP connectorsExtend your agent with external MCP servers (opposite direction)
Scheduled tasksAutomate recurring operations, manageable via MCP
Workflow automationYAML workflows, creatable via MCP tools
Agent hooksSafety controls, activatable per thread via MCP

Get started

Set up the SRE Agent MCP server

Was this page helpful?