Contact Us 1-800-596-4880

MCP Support Policy

Policy Name

MCP Support

Summary

Adds MCP support to an Omni Gateway MCP server instance. This policy is required for your MCP server instance to function properly.

Category

MCP

First Omni Gateway version available

v1.9.3

Release Notes

MCP Support

Returned Status Codes

No return codes exist for this policy.

This policy supports Model Context Protocol (MCP) version 2025-06-18 and earlier. To learn more about MCP, see MCP Specification.

Summary

The MCP Support Policy configures Omni Gateway to support MCP server instances. You must apply this policy to all MCP server instances for the instance to function properly. If you don’t apply this policy, Omni Gateway might throw a runtime error.

The MCP Support policy enables the Total MCP Calls metric that tracks the total successful and unsuccessful calls made to the MCP server. To view the total MCP calls, see Viewing Key Metrics in API Manager for Managed Omni Gateway.

Configure the policy to inject the MCP primitive as request headers toward the upstream backend so that downstream policies can use it. To learn more, see Configuring Policy Parameters.

This policy must come first in policy order. If this policy doesn’t come first, Omni Gateway might throw a runtime error.

Configuring Policy Parameters

Omni Gateway Local Mode

The MCP Support policy isn’t supported in Local Mode.

Managed Omni Gateway and Omni Gateway Connected Mode

When you apply the policy from the UI, the following parameters are displayed:

Element Description Default

Inject MCP Element Headers

Injects the MCP primitive as request headers for downstream policy use. The policy sets x-ms-mcp-element-id to the identifier (tools/call name, prompts/get name, or resources/read URI) and x-ms-mcp-element-type to the kind (tool, prompt, or resource). These headers lets a downstream policy match on type, an individual element or both

Disabled