Get MCP server

curl --request GET \
  --url https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID> \
  --header 'Authorization: Bearer <token>'

const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();

import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()

{
  "mcpServer": {
    "id": "<string>",
    "url": [
      "<string>"
    ],
    "name": "<string>",
    "image": "<string>",
    "headers": [
      {
        "key": "<string>",
        "value": "[redacted]"
      }
    ],
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "description": "<string>",
    "specification": "2025-03-26"
  }
}

Get MCP server

Returns a single MCP server by ID, with the fields that define it. A MCP server is a registered Model Context Protocol server whose tools an agent can call.

GET

/v1/stable/mcp-server/{serverID}

Get MCP server

curl --request GET \
  --url https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID> \
  --header 'Authorization: Bearer <token>'

const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();

import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v1/stable/mcp-server/<serverID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()

{
  "mcpServer": {
    "id": "<string>",
    "url": [
      "<string>"
    ],
    "name": "<string>",
    "image": "<string>",
    "headers": [
      {
        "key": "<string>",
        "value": "[redacted]"
      }
    ],
    "createdAt": "2026-09-10T00:00:00.000Z",
    "updatedAt": "2026-09-10T00:00:00.000Z",
    "description": "<string>",
    "specification": "2025-03-26"
  }
}

Authorizations

Authorization

string

header

required

Voiceflow bearer token

Path Parameters

serverID

string

required

Query Parameters

projectID

string

required

The ID of the project to operate on.

environmentAlias

string

required

The alias of the environment to operate on (e.g. main).

Response

200 - application/json

Returns one MCP server's stored configuration: its name, URL, description, icon, and specification version.

mcpServer

object

required

Show child attributes

string

required

url

object

required

Show child attributes

name

string

required

image

string

required

The URL of the MCP server icon image.

headers

object[]

required

Show child attributes

key

string

required

value

enum<string>

required

Available options: [redacted]

createdAt

string

required

updatedAt

string

required

description

string

required

A human-readable description of what the MCP server provides.

specification

object

required

Available options: 2025-03-26, 2025-06-18

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks

Get MCP server

Authorizations

Path Parameters

Query Parameters

Response

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks