---
schema_version: "1"
id: 5f4f62d62c0bd6f1f5492b0d530634c90951fc4b4d192b960940757b8a0b96a3
title: MCP Support Policy
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/gateway/latest/policies-included-mcp-support.md
canonical_url: https://docs.mulesoft.com/gateway/latest/policies-included-mcp-support
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 4ca0cdfaf6451caa5e05568420511171d727936e4e9a39c81bc1d253cce46071
description: MuleSoft Documentation Site
release: "1.14"
latest: true
---
---
product: Omni Gateway
version: 1.14
is-latest-version: true
keywords: api gateway, flex gateway, gateway, policy
---

# MCP Support Policy

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

<table><colgroup><col> <col></colgroup><tbody><tr><td><p><strong>Policy Name</strong></p></td><td><p>MCP Support</p></td></tr><tr><td><p><strong>Summary</strong></p></td><td><p>Adds MCP support to an Omni Gateway MCP server instance. This policy is required for your MCP server instance to function properly.</p></td></tr><tr><td><p><strong>Category</strong></p></td><td><p>MCP</p></td></tr><tr><td><p><strong>First Omni Gateway version available</strong></p></td><td><p>v1.9.3</p></td></tr><tr><td><p><strong>Release Notes</strong></p></td><td><p><a href="https://docs.mulesoft.com/release-notes/gateway/policies/mcp-support-release-notes">MCP Support</a></p></td></tr><tr><td><p><strong>Returned Status Codes</strong></p></td><td><p>No return codes exist for this policy.</p></td></tr></tbody></table>

> [!NOTE] This policy supports Model Context Protocol (MCP) version 2025-06-18 and earlier. To learn
> more about MCP, see [MCP Specification](https://modelcontextprotocol.io/specification/2025-06-18).

## 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](https://docs.mulesoft.com/gateway/latest/managed-view-api-metrics).

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](#configuring-policy-parameters).

> [!NOTE] 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:

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Element</th><th>Description</th><th>Default</th></tr></thead><tbody><tr><td><div><div><p>Inject MCP Element Headers</p></div></div></td><td><div><div><p>Injects the MCP primitive as request headers for downstream policy use. The policy sets <code>x-ms-mcp-element-id</code> to the identifier (<code>tools/call</code> name, <code>prompts/get</code> name, or <code>resources/read</code> URI) and <code>x-ms-mcp-element-type</code> to the kind (<code>tool</code>, <code>prompt</code>, or <code>resource</code>). These headers lets a downstream policy match on type, an individual element or both</p></div></div></td><td><div><div><p>Disabled</p></div></div></td></tr></tbody></table>