Python: Added MCP tool support for azure functions package. by gavin-aguiar · Pull Request #2385 · microsoft/agent-framework

gavin-aguiar · 2025-11-21T19:49:29Z

Motivation and Context

This PR adds native Model Context Protocol (MCP) tool endpoint support to the Azure Functions integration for the Agent
Framework. This enables agents to be exposed as MCP tools that can be invoked by MCP-compatible clients, in addition to
traditional HTTP endpoints.

Description

AgentFunctionApp enhancements:
- Added enable_mcp_tool_endpoint parameter (app-level and per-agent)
- Implemented _setup_mcp_tool_trigger() method to register Azure Functions MCP tool triggers
- Implemented _handle_mcp_tool_invocation() method to process MCP tool requests
- Added agent_mcp_tool_flags dictionary to track per-agent MCP settings
- Updated health check endpoint to include mcp_tool_enabled field
MCP Tool Configuration:
- MCP tools accept query (required) and threadId (optional) parameters
- Handles both JSON string and pre-parsed dict contexts defensively
- Integrates with existing durable entity infrastructure for conversation state

Contribution Checklist

The code builds clean without any errors or warnings
The PR follows the Contribution Guidelines
All unit tests pass, and I have added new tests where possible
Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

…ramework (#1823) * Add scafolding * update readme * add code owners and label * update owners

* add initial changes * Move code and add single sample * Update logger * Remove unused code * address PR comments * cleanup code and address comments --------- Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

* Add Unit tests for Azurefunctions * remove duplicate import

…gents as MCP tools (#1979)

* Move all samples * fix comments * remove dead lines * Make samples simpler

)

* Add Integration tests * Remove DTS extension * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add pyi file for type safety * Add samples in readme * Updated all readme instructions * Address comments * Update readmes * Fix requirements * Address comments --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…t/agent-framework into gaaguiar/mcp

…nto gaaguiar/mcp

markwallace-microsoft · 2025-11-21T19:51:23Z

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/azurefunctions/agent_framework_azurefunctions
_app.py	374	80	78%	197–198, 203–204, 422, 430–431, 451–453, 459–461, 467–469, 501–502, 562–563, 695, 698, 707–709, 711–713, 715, 717, 728, 730–733, 735, 737–738, 740, 747–748, 750–751, 753–754, 756, 760, 770–772, 774–775, 777–779, 786, 788–789, 791, 812, 817, 829, 905, 917, 924–926, 972, 986, 997–999, 1001–1004, 1029, 1036, 1038, 1041
TOTAL	15537	2352	84%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
2240	130 💤	0 ❌	0 🔥	52.212s ⏱️

Copilot

Pull request overview

This PR adds native Model Context Protocol (MCP) tool support to the Azure Functions integration for the Agent Framework, enabling agents to be exposed as MCP tools that can be invoked by MCP-compatible clients.

Key changes:

Added app-level and per-agent enable_mcp_tool_endpoint configuration flags to AgentFunctionApp
Implemented _setup_mcp_tool_trigger() and _handle_mcp_tool_invocation() methods for MCP tool processing
Enhanced health check endpoint to include mcp_tool_enabled field

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
python/samples/getting_started/azure_functions/08_mcp_server/requirements.txt	Added dependencies for the MCP server sample
python/samples/getting_started/azure_functions/08_mcp_server/local.settings.json.template	Configuration template for local development
python/samples/getting_started/azure_functions/08_mcp_server/host.json	Azure Functions host configuration
python/samples/getting_started/azure_functions/08_mcp_server/function_app.py	Sample demonstrating agents with different trigger configurations (HTTP only, MCP only, or both)
python/samples/getting_started/azure_functions/08_mcp_server/README.md	Comprehensive documentation for the MCP server sample
python/packages/azurefunctions/tests/test_app.py	Added 14 new unit tests for MCP tool endpoint functionality
python/packages/azurefunctions/agent_framework_azurefunctions/_app.py	Core implementation of MCP tool trigger support with entity integration

python/packages/azurefunctions/agent_framework_azurefunctions/_app.py

python/samples/getting_started/azure_functions/08_mcp_server/function_app.py

python/samples/getting_started/azure_functions/08_mcp_server/README.md

python/packages/azurefunctions/agent_framework_azurefunctions/_app.py

python/samples/getting_started/azure_functions/08_mcp_server/README.md

…mework into gaaguiar/mcp

python/packages/azurefunctions/agent_framework_azurefunctions/_app.py

python/samples/getting_started/azure_functions/08_mcp_server/function_app.py

…mework into gaaguiar/mcp

kshyju

Take my approval with a grain of salt as my python knowledge is very limited.

…t#2385) * Python: Add Scaffolding for Durable AzureFunctions package to Agent Framework (microsoft#1823) * Add scafolding * update readme * add code owners and label * update owners * .NET: Durable extension: initial src and unit tests (microsoft#1900) * Python: Add Durable Agent Wrapper code (microsoft#1913) * add initial changes * Move code and add single sample * Update logger * Remove unused code * address PR comments * cleanup code and address comments --------- Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com> * Azure Functions .NET samples (microsoft#1939) * Python: Add Unit tests for Azurefunctions package (microsoft#1976) * Add Unit tests for Azurefunctions * remove duplicate import * .NET: [Feature Branch] Migrate state schema updates and support for agents as MCP tools (microsoft#1979) * Python: Add more samples for Azure Functions (microsoft#1980) * Move all samples * fix comments * remove dead lines * Make samples simpler * Agents as MCP tools * Removed unused files and updated sample * .NET: [Feature Branch] Durable Task extension integration tests (microsoft#2017) * .NET: [Feature Branch] Update OpenAI config for integration tests (microsoft#2063) * Python: Add Integration tests for AzureFunctions (microsoft#2020) * Add Integration tests * Remove DTS extension * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add pyi file for type safety * Add samples in readme * Updated all readme instructions * Address comments * Update readmes * Fix requirements * Address comments --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Addressed copilot feedback * Minor refactoring and added tests * Updated mcp sample * Fixed broken link in readme * Addressed copilot comments * Addressed feedback * Updated property to enable_mcp_tool_trigger --------- Co-authored-by: Laveesh Rohra <larohra@microsoft.com> Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com> Co-authored-by: Chris Gillum <cgillum@microsoft.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

larohra and others added 20 commits November 3, 2025 08:33

Python: Add Scaffolding for Durable AzureFunctions package to Agent F…

e7e68fe

…ramework (#1823) * Add scafolding * update readme * add code owners and label * update owners

Merge branch 'main' into feature-azure-functions

0808fd2

Merge branch 'main' into feature-azure-functions

1d5677b

.NET: Durable extension: initial src and unit tests (#1900)

5686a00

Python: Add Durable Agent Wrapper code (#1913)

1762cda

* add initial changes * Move code and add single sample * Update logger * Remove unused code * address PR comments * cleanup code and address comments --------- Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Azure Functions .NET samples (#1939)

90742ba

Python: Add Unit tests for Azurefunctions package (#1976)

754491c

* Add Unit tests for Azurefunctions * remove duplicate import

.NET: [Feature Branch] Migrate state schema updates and support for a…

40b6def

…gents as MCP tools (#1979)

Python: Add more samples for Azure Functions (#1980)

0aa8d30

* Move all samples * fix comments * remove dead lines * Make samples simpler

Agents as MCP tools

9150176

Removed unused files and updated sample

a6b6659

.NET: [Feature Branch] Durable Task extension integration tests (#2017)

304b809

.NET: [Feature Branch] Update OpenAI config for integration tests (#2063

916b51f

)

Merge branch 'feature-azure-functions' of https://github.com/microsof…

24a45c8

…t/agent-framework into gaaguiar/mcp

Addressed copilot feedback

40104e4

durable mcp tool

d4f66e3

Minor refactoring and added tests

1fbbbf0

Merge branch 'main' of https://github.com/microsoft/agent-framework i…

dcb7f87

…nto gaaguiar/mcp

Updated mcp sample

284cd5a

markwallace-microsoft added documentation Improvements or additions to documentation python labels Nov 21, 2025

gavin-aguiar added azure-functions Issues and PRs related to Azure Functions and removed documentation Improvements or additions to documentation labels Nov 21, 2025

Fixed broken link in readme

8d5b8d1

markwallace-microsoft added the documentation Improvements or additions to documentation label Nov 21, 2025

gavin-aguiar marked this pull request as ready for review November 21, 2025 20:35

gavin-aguiar requested a review from a team as a code owner November 21, 2025 20:35

Copilot AI review requested due to automatic review settings November 21, 2025 20:35

Copilot started reviewing on behalf of gavin-aguiar November 21, 2025 20:35 View session

Copilot finished reviewing on behalf of gavin-aguiar November 21, 2025 20:38

Copilot AI reviewed Nov 21, 2025

View reviewed changes

gavin-aguiar and others added 2 commits November 21, 2025 15:03

Addressed copilot comments

6fe2c40

Merge branch 'main' into gaaguiar/mcp

a5655c5

larohra reviewed Nov 21, 2025

View reviewed changes

gavin-aguiar and others added 3 commits November 24, 2025 12:02

Addressed feedback

b5e513a

Merge branch 'gaaguiar/mcp' of https://github.com/microsoft/agent-fra…

68040eb

…mework into gaaguiar/mcp

Merge branch 'main' into gaaguiar/mcp

617e86f

larohra approved these changes Nov 24, 2025

View reviewed changes

kshyju reviewed Nov 24, 2025

View reviewed changes

python/packages/azurefunctions/agent_framework_azurefunctions/_app.py Show resolved Hide resolved

kshyju reviewed Nov 24, 2025

View reviewed changes

python/packages/azurefunctions/agent_framework_azurefunctions/_app.py Outdated Show resolved Hide resolved

TsuyoshiUshio approved these changes Nov 24, 2025

View reviewed changes

kshyju reviewed Nov 24, 2025

View reviewed changes

python/samples/getting_started/azure_functions/08_mcp_server/function_app.py Outdated Show resolved Hide resolved

gavin-aguiar and others added 3 commits November 24, 2025 14:40

Updated property to enable_mcp_tool_trigger

4bc0e87

Merge branch 'gaaguiar/mcp' of https://github.com/microsoft/agent-fra…

f626f1b

…mework into gaaguiar/mcp

Merge branch 'main' into gaaguiar/mcp

2cb8636

larohra approved these changes Nov 24, 2025

View reviewed changes

gavin-aguiar added 2 commits November 25, 2025 10:10

Merge branch 'main' into gaaguiar/mcp

f35b668

Merge branch 'main' into gaaguiar/mcp

9d79ed5

kshyju approved these changes Nov 25, 2025

View reviewed changes

gavin-aguiar added this pull request to the merge queue Nov 25, 2025

Merged via the queue into main with commit b1c210c Nov 25, 2025
24 checks passed

cgillum deleted the gaaguiar/mcp branch November 26, 2025 04:37

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Python: Added MCP tool support for azure functions package. #2385

Python: Added MCP tool support for azure functions package. #2385
gavin-aguiar merged 31 commits intomainfrom
gaaguiar/mcp

gavin-aguiar commented Nov 21, 2025 •

edited

Loading

Uh oh!

markwallace-microsoft commented Nov 21, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kshyju left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

Conversation

gavin-aguiar commented Nov 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation and Context

Description

Contribution Checklist

Uh oh!

markwallace-microsoft commented Nov 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Python Unit Test Overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

kshyju left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

gavin-aguiar commented Nov 21, 2025 •

edited

Loading

markwallace-microsoft commented Nov 21, 2025 •

edited

Loading