skills.rest
aiappsgbb
aiappsgbbOFFICIAL
Explore all skills by this author →
GitHub

foundry-mcp-aca

Deploy MCP servers on Azure Container Apps or Functions for Foundry agents.

5|2|Updated Apr 28, 2026
Search Tags:#mcp#foundry#azure functions#cosmos db#streamable http#azure container apps
One-click install
npx skills add https://github.com/aiappsgbb/awesome-gbb --skill foundry-mcp-aca
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: foundry-mcp-aca
Source: https://github.com/aiappsgbb/awesome-gbb/tree/main/skills/foundry-mcp-aca
Command: npx skills add https://github.com/aiappsgbb/awesome-gbb --skill foundry-mcp-aca

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of securely hosting an MCP (Model Context Protocol) server on Azure so Foundry hosted agents can use MCP tools over remote HTTP at runtime.

Core Features & Use Cases

  • MCP server hosting on Azure: Deploy an MCP server as an Azure Container App or an Azure Function with the correct HTTP/Streamable transport conventions for Foundry.
  • Protocol correctness for Foundry compatibility: Ensures the MCP server implements the required JSON-RPC methods and returns HTTP 200 for all six MCP entrypoints, including the camelCase logging capability.
  • Cosmos DB and Playwright patterns: Provides a concrete deployment approach for Cosmos DB MCPToolKit (keyless via managed identity) and Playwright MCP on Container Apps for browser automation scenarios.
  • Firewall egress automation for Cosmos pilots: Includes a postdeploy workflow to discover the ACA egress IP from logs and patch Cosmos firewall rules to make ACA-to-Cosmos traffic work hands-off.

Quick Start

Deploy your MCP server to Azure Container Apps, then point your Foundry hosted agent mcp-config.json server URL to the deployed endpoint’s /mcp path.

Frequently Asked Questions about foundry-mcp-aca

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an MCP server to Azure Container Apps for Foundry agents?▼

To deploy an MCP server to Azure Container Apps for Foundry agents, you host the server implementation on ACA and configure your Foundry agent's mcp-config.json to point to the deployed endpoint's /mcp path.

What HTTP transport requirements must an MCP server meet for Foundry compatibility?▼

An MCP server requires Foundry-compatible remote HTTP Streamable transport at /mcp, returning HTTP 200 responses for initialize, notifications, tools/list, prompts/list, resources/list, and logging/setLevel JSON-RPC methods.

How do I connect an Azure Container Apps MCP server to Cosmos DB through the firewall?▼

To connect Azure Container Apps to Cosmos DB, use a postdeploy workflow that discovers the ACA egress IP from logs and automatically patches Cosmos firewall rules to enable hands-off network traffic.

Can I use Azure Functions to host an MCP server for Foundry?▼

Yes, you can host an MCP server on Azure Functions. The Skill applies the same required HTTP/Streamable transport conventions and JSON-RPC method responses to ensure Foundry hosted agents can consume MCP tools.

Does the Cosmos DB MCPToolKit deployment support managed identity authentication?▼

Yes, deploying the Cosmos DB MCPToolKit supports keyless authentication via managed identity, ensuring secure access to Cosmos DB resources from your Azure Container Apps MCP server without storing keys.

Can I deploy the Playwright MCP server on Azure Container Apps for browser automation?▼

Yes, the Skill provides a concrete deployment approach for hosting the Playwright MCP on Azure Container Apps, enabling browser automation scenarios for Foundry hosted agents over remote HTTP.

Related Skills

Explore More Software Engineering Skills→
microsoftmicrosoft
242

azure-deploy

Automate Azure deployments with AZD, AZCLI, Bicep, or Terraform after validation.

Official
Advanced
aiappsgbbaiappsgbb
5

foundry-toolbox

Connect agents to Microsoft Foundry Toolboxes via a Streamable HTTP MCP endpoint.

Official
Advanced
BagelHoleBagelHole
46

azure-sql

Provision Azure SQL Database and Cosmos DB instances with security configurations.

Community
Intermediate
ojrojasojrojas

mcp-csharp-publish

Publish C# MCP servers via NuGet, Docker, Azure, and MCP Registry.

Community
Advanced