> ## Documentation Index
> Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Deprecation of MCP Servers in Prompts

> MCP servers can no longer be attached to new prompts starting 28th April 2026. Existing prompts with MCP servers will continue to work until 30th May 2026.

<Note>
  **Applicable to:** Users who save **Prompts** in TrueFoundry with **MCP servers** configured within them. If you do not attach MCP servers to your prompts, this change does not affect you.
</Note>

## What Is Changing

Prompts will continue to be saved from the **Model Playground** as before — **nothing is changing about how or where you save prompts**.

What is changing is **MCP server support inside prompts**:

<Warning>
  **Starting 28th April 2026**, you will **no longer be able to add MCP servers to new prompts**. The option to attach MCP servers in the prompt editor will be removed.
</Warning>

* **New prompts:** Cannot include MCP servers from **28th April 2026** onward.
* **Existing prompts:** Prompts that already have MCP servers configured will **continue to work until 30th May 2026**. After that date, support is fully removed and any prompt still referencing `mcp_servers` will stop working as expected.

This is a **breaking change** for any workflow that relies on MCP servers attached to prompts.

## What You Need to Do

<Steps>
  <Step title="Audit existing prompts">
    Review all current prompts for MCP server dependencies (the `mcp_servers` field).
  </Step>

  <Step title="Migrate MCP server usage to Agents">
    Move the MCP server functionality out of your prompts and into an **Agent**. Agents are the supported way to use MCP servers going forward (see below).
  </Step>

  <Step title="Update affected prompts">
    Recreate / update the affected prompts **without** `mcp_servers`, and point your application to the Agent for any MCP-driven behavior.
  </Step>

  <Step title="Validate your workflows">
    Test the updated prompts and agents end-to-end to ensure your workflows continue to function correctly before **30th May 2026**.
  </Step>
</Steps>

## Using MCP Servers with Agents

If you still need MCP server functionality, attach MCP servers to an **Agent** instead of embedding them in a prompt. Navigate to the **Agents** tab on the left sidebar and attach MCP servers directly to the agent configuration.

<Steps>
  <Step title="Go to the Agents tab">
    Open the **Agents** tab from the left sidebar and select **MCP Servers** from the left panel.

    <Frame caption="Navigate to Agents and select MCP Servers">
      <img src="https://mintcdn.com/truefoundry/ZdiyJmH2UdlJwwlq/images/ss-1.png?fit=max&auto=format&n=ZdiyJmH2UdlJwwlq&q=85&s=b13c736ca6a62a085f3f4e55563d9678" alt="Agents tab with MCP Servers option selected in the left panel" width="3548" height="1148" data-path="images/ss-1.png" />
    </Frame>
  </Step>

  <Step title="Select MCP servers">
    Choose the MCP servers you want to attach from the available list.

    <Frame caption="Select MCP servers from the list">
      <img src="https://mintcdn.com/truefoundry/ZdiyJmH2UdlJwwlq/images/ss-2.png?fit=max&auto=format&n=ZdiyJmH2UdlJwwlq&q=85&s=3e45c1f7722573c4f6a43a0dab59225c" alt="List of available MCP servers to select from" width="3520" height="2202" data-path="images/ss-2.png" />
    </Frame>
  </Step>

  <Step title="Save the agent">
    Save the agent configuration to apply the MCP server changes.

    <Frame caption="Save the agent configuration">
      <img src="https://mintcdn.com/truefoundry/ZdiyJmH2UdlJwwlq/images/ss-3.png?fit=max&auto=format&n=ZdiyJmH2UdlJwwlq&q=85&s=5dbdd36ee33d2f5ed5f9d91d290a3105" alt="Saving the agent with MCP servers configured" width="3532" height="694" data-path="images/ss-3.png" />
    </Frame>
  </Step>
</Steps>

## Timeline

| Milestone                                                          | Date                 |
| ------------------------------------------------------------------ | -------------------- |
| Deprecation announcement                                           | 17th April, 2026     |
| Adding MCP servers to **new** prompts disabled                     | **28th April, 2026** |
| Removal of support for **existing** prompts containing MCP servers | **30th May, 2026**   |

<Warning>
  We strongly encourage migrating MCP server usage out of prompts and into Agents well ahead of **30th May, 2026** to avoid disruptions.
</Warning>

***

If you have questions or need help migrating prompts that use MCP servers over to Agents, reach out to [**support@truefoundry.com**](mailto:support@truefoundry.com) — we're happy to assist.