---
schema_version: "1"
id: 5db9904fa233eee29d1dc42a6bcba4be61af5ac6e79508075e68c80288a63804
title: MCP Support Policy
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/gateway/1.13/policies-included-mcp-support.md
canonical_url: https://docs.mulesoft.com/gateway/1.13/policies-included-mcp-support
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 158195340403518dafb3fe426c2b59ec8003416cf29ae3a5bd7bddb43596df1b
description: MuleSoft Documentation Site
release: "1.13"
latest: false
---
---
product: Omni Gateway
version: 1.13
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/1.13/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>