Building an MCP Server for Azure Logic Apps

azure

I built an MCP server for Azure Logic Apps that lets AI assistants like Claude and GitHub Copilot query workflows, run history, and more. Model Context Protocol is the glue that makes this possible — it gives AI tools a structured way to discover and call external services.

Here’s how the server works and some design decisions along the way.

The Architecture

AI Assistant ⟷ MCP Server ⟷ Azure Logic Apps
stdio REST API

Here’s the entry point:

const server = new Server(
  { name: "logicapps-mcp", version: "0.1.0" },
  { capabilities: { tools: {} } }
);

registerTools(server);

const transport = new StdioServerTransport();
await server.connect(transport);

MCP uses stdio for communication — the AI assistant spawns the server process and communicates via stdin/stdout. No HTTP server, no ports to configure.

Tool Registration

Each tool is defined with a JSON schema that describes its parameters:

{
  name: "list_run_history",
  description: "Get the run history for a workflow",
  inputSchema: {
    type: "object",
    properties: {
      subscriptionId: { type: "string" },
      logicAppName: { type: "string" },
      top: { type: "number", description: "Number of runs (default: 25)" },
      filter: { type: "string", description: "OData filter" }
    },
    required: ["subscriptionId", "logicAppName"]
  }
}

The AI reads these schemas and knows exactly what parameters to provide. When it calls a tool, the server validates the input and executes the corresponding function.

Authentication Without SDKs

Rather than pulling in the Azure SDK (which adds significant weight), the server uses Azure CLI tokens directly:

export async function getAzureCliToken(): Promise<string> {
  const result = await exec("az account get-access-token --query accessToken -o tsv");
  return result.stdout.trim();
}

This keeps dependencies minimal and leverages the authentication the user already has. If you’re logged into Azure CLI, the MCP server just works.

Calling Azure Resource Manager

All Logic Apps operations go through the ARM REST API. The HTTP client is a thin wrapper that handles auth injection and pagination:

export async function armRequest<T>(path: string): Promise<T> {
  const cloud = getCloudEndpoints();
  const token = await getAccessToken();

  const response = await fetch(`${cloud.resourceManager}${path}`, {
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  });

  return response.json() as T;
}

The server supports Azure Public, Government, and China clouds — just swap the endpoint configuration.

Handling Both SKUs

Logic Apps comes in two flavors: Consumption (serverless, single workflow) and Standard (App Service-based, multiple workflows). The API paths differ:

  • Consumption: /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Logic/workflows/{name}
  • Standard: /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Web/sites/{name}/hostruntime/runtime/webhooks/workflow/api/management/workflows/{workflow}

Each tool detects the SKU and routes to the appropriate API.

What Can You Do With It?

Once configured, you can ask your AI assistant things like:

  • “List all Logic Apps in my subscription”
  • “Show me failed runs from the last 24 hours”
  • “What’s the definition of the order-processing workflow?”
  • “Get the trigger callback URL for the HTTP trigger”

The server exposes 18 read-only tools:

Category Tools
Discovery list_subscriptions, list_logic_apps, list_workflows
Definitions get_workflow_definition, get_workflow_swagger, list_workflow_versions
Triggers get_workflow_triggers, get_trigger_history, get_trigger_callback_url
Run History list_run_history, get_run_details, get_run_actions
Debugging get_action_repetitions, get_scope_repetitions, get_action_request_history, get_expression_traces
Connections get_connections
Diagnostics get_host_status

Try It

To get started:

npm install -g github:laveeshb/logicapps-mcp

Add it to Claude Desktop or VS Code Copilot, and you can start querying your Logic Apps with natural language.

The code is on GitHub — contributions welcome.

#mcp #logic-apps #typescript #ai

Comments