---
title: "Decisions MCP Server"
slug: "decisions-mcp-server"
updated: 2026-05-30T00:52:28Z
published: 2026-05-30T00:52:28Z
---

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

# Decisions MCP Server

## Overview

The **MCP Server** feature in Decisions allows the platform to expose **AI Tool Flows** as callable tools that Large Language Models (LLMs) can interact with. This enables Decisions flows to execute logic or return structured data when invoked by an external AI system.

**What is MCP?**

**Model Context Protocol (MCP)** is an open protocol that defines how Large Language Models (LLMs) communicate with external tools and systems.

For more information, see: [What is the Model Context Protocol (MCP)?](https://modelcontextprotocol.io/docs/getting-started/intro)

MCP Server functionality requires **Decisions Version 9.18 or later**.

---

## Configuring Decisions as MCP

Using Decisions as an MCP server allows designers to expose Decisions Flows as callable tools that Large Language Models (LLMs) can interact with. This means any logic built within a flow can be executed by an AI model or used to return structured data, enabling seamless integration between Decisions and AI-driven systems.

*To learn more about AI Tool Flows, see the [**AI Tool Flow**](/v9/docs/ai-tool-flow) article.*

For a Large Language Model to call a Decisions Flow, three key components are required:

- **AI Tool Flow** – A special type of flow that is designed to be callable by an LLM.
- **Authentication (Named Session)**– Provides secure access when the external system calls Decisions.NoteWhen connecting to a Decisions MCP Server, the Named Session Value is not passed as a query parameter. It must be included in the `Authorization` header using the `Session` scheme.
- **MCP Server URL** – A unique endpoint (based on the element slug) where the AI Tool Flows are exposed.

When these components are configured, the LLM can send requests to the Decisions MCP Server, execute the flow, and receive the results.

The following example shows how this configuration is typically provided to an MCP client:

```
{
  "mcpServers": {
    "localmcp": {
      "command": "C:\\Users\\{user}\\AppData\\Roaming\\npm\\mcp-remote.cmd",
      "args": [
        "--header",
        "Authorization: Session <NamedSessionValue>",
        "http://{portalbaseurl:portnumber}/Primary/mcp/decisions_mcp"
      ]
    }
  }
}
```

### Creating an MCP Server in Decisions

Follow the steps below to configure an MCP Server and enable communication with external MCP clients.

1. **Create an**[**AI Tool Flow**](/v9/docs/ai-tool-flow)
2. **Create the MCP Server**

Once the AI Tool Flow is ready, create the MCP Server to expose it.

After saving, the MCP Server URL is automatically displayed. It follows the format: **http://{portalBaseUrl}/mcp/{elementSlug}**  
Example:`http://localhost:80/Primary/mcp/myserver`  
This URL is required for MCP configuration in external clients.

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1777426165766.png)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1777426241791.png)
  1. Navigate within the project to **Public > Integrations > MCP Servers**.
  2. Select **Add MCP Server**.
  3. In the pop-up window, configure the following:
    - **Name**
    - **Description** (optional)
    - **Element Slug** – determines the unique MCP Server URL.
    - **Tools** – select the AI Tool Flow(s) created in Step 1.
3. **Create a Named Session for Authentication**

MCP clients require a **Named Session Value** to authenticate with the Decisions environment.

External MCP clients must pass the Named Session Value in the request header using the following format: `Authorization: Session &lt;NamedSessionValue&gt;`  
Example: `Authorization: Session NS-XXXXXXXX`  
This Named Session Value, along with the MCP Server URL, is used in the `mcp.json` file or equivalent client configuration when connecting MCP-enabled tools to the Decisions platform.  
![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1777426441402.png)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1777426527417.png)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1764973054766.png)
  1. Create a [Named Session](/v9/docs/named-session).
  2. Right-click the Named Session and select **Get Named Session Value**.
  3. Copy the generated Named Session Value.

#### Example Output from an MCP Tool Call

When an MCP client runs an AI Tool Flow, the output returned by the flow is sent back in the MCP response. The following examples show what a successful tool execution output looks like in an MCP-enabled client. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1777430671755.png)![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1777430690572.png)