RE-Butler MCP Server

Outbound MCP server exposing RE-Butler's knowledge and validation tools to neighbour teams and Azure AI Foundry agents.

Tools

Setup

pip install -e ".[dev]"
cp .env.example .env  # fill in values
python -m re_butler_mcp.server

Tests

pytest

Smoke Test

# Against local server
python scripts/smoke_test_client.py

# Against deployed server
python scripts/smoke_test_client.py https://ca-genai4re-mcp-dev.<region>.azurecontainerapps.io/mcp

Infrastructure

cd infra
az deployment group create \
  --resource-group rg-genai4re-dev \
  --template-file main.bicep \
  --parameters containerImage=myacr.azurecr.io/re-butler-mcp:latest acrName=myacr

Auth

• Callers must present a valid Entra ID Bearer JWT.

• App Roles: RE.Read (all reads), RE.Admin (write tools).

• Pre-authorize client app registrations in the server's app registration manifest.

• Managed Identity handles all outbound calls (Search, OpenAI, ADO).

HITL Gate C

create_work_item always returns approval_pending: true. The calling workflow (Foundry / Durable Functions) must implement the approval step before the work item becomes active. Do not implement Gate C inside Connected Agent tools — keep it in the workflow layer.