Update an MCP gateway

Core - Narrow the tools a gateway exposes

curl --request PATCH \
  --url 'https://router.toqan.ai/eu/v2/mcp-gateways/01JQ0M8W4T5YB2Q7N1F6K3PZRC' \
  --header "Authorization: Bearer $TOQAN_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "server_links": [
      {
        "mcp_server_id": "01JQ0K5R8N2ZC7X4M9T3V6HWBD",
        "alias": "github",
        "enabled": true,
        "tool_exposure": {
          "mode": "MCP_TOOL_EXPOSURE_MODE_SELECTED",
          "tool_ids": [
            "01JQ0KA2M7VD9E4R6T8Y1U3XSB",
            "01JQ0KB5P9WF2G7H4J6K8L1NQD"
          ]
        }
      }
    ]
  }'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    key: '<string>',
    display_name: '<string>',
    description: '<string>',
    server_links: [
      {
        mcp_server_id: '<string>',
        alias: '<string>',
        tool_exposure: {
          mode: 'MCP_TOOL_EXPOSURE_MODE_ALL',
          read_only: true,
          tool_ids: ['<string>'],
          excluded_tool_ids: ['<string>']
        },
        enabled: true
      }
    ],
    sharing: {
      all_projects: {},
      selected: {project_ids: ['<string>']},
      allow_version_pin: true,
      allow_fork: true,
      auto_grant_new_projects: true
    },
    clear_server_links: true,
    plugins: [
      {
        id: '<string>',
        language: '<string>',
        entities: ['<string>'],
        on_failure: '<string>',
        threshold: 123,
        mask: ['<string>'],
        regions: ['<string>'],
        entity_thresholds: {}
      }
    ],
    skill_ids: ['<string>'],
    clear_skill_ids: true,
    icons: [
      {src: '<string>', mime_type: '<string>', sizes: ['<string>'], theme: '<string>'}
    ],
    replace_icons: true,
    website_url: '<string>',
    guardrails: [
      {
        id: '<string>',
        execute_on: '<string>',
        sample_rate: 123,
        is_guardrail: true,
        options: {}
      }
    ],
    expected_updated: '<string>'
  })
};

fetch('https://router.toqan.ai/eu/v2/mcp-gateways/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://router.toqan.ai/eu/v2/mcp-gateways/{id}"

payload = {
    "key": "<string>",
    "display_name": "<string>",
    "description": "<string>",
    "server_links": [
        {
            "mcp_server_id": "<string>",
            "alias": "<string>",
            "tool_exposure": {
                "mode": "MCP_TOOL_EXPOSURE_MODE_ALL",
                "read_only": True,
                "tool_ids": ["<string>"],
                "excluded_tool_ids": ["<string>"]
            },
            "enabled": True
        }
    ],
    "sharing": {
        "all_projects": {},
        "selected": { "project_ids": ["<string>"] },
        "allow_version_pin": True,
        "allow_fork": True,
        "auto_grant_new_projects": True
    },
    "clear_server_links": True,
    "plugins": [
        {
            "id": "<string>",
            "language": "<string>",
            "entities": ["<string>"],
            "on_failure": "<string>",
            "threshold": 123,
            "mask": ["<string>"],
            "regions": ["<string>"],
            "entity_thresholds": {}
        }
    ],
    "skill_ids": ["<string>"],
    "clear_skill_ids": True,
    "icons": [
        {
            "src": "<string>",
            "mime_type": "<string>",
            "sizes": ["<string>"],
            "theme": "<string>"
        }
    ],
    "replace_icons": True,
    "website_url": "<string>",
    "guardrails": [
        {
            "id": "<string>",
            "execute_on": "<string>",
            "sample_rate": 123,
            "is_guardrail": True,
            "options": {}
        }
    ],
    "expected_updated": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "mcp_gateway": {
    "id": "<string>",
    "key": "<string>",
    "display_name": "Production Gateway",
    "description": "<string>",
    "server_links": [
      {
        "mcp_server_id": "<string>",
        "alias": "<string>",
        "tool_exposure": {
          "mode": "MCP_TOOL_EXPOSURE_MODE_ALL",
          "read_only": true,
          "tool_ids": [
            "<string>"
          ],
          "excluded_tool_ids": [
            "<string>"
          ]
        },
        "enabled": true,
        "skill_exposure": {
          "mode": "MCP_TOOL_EXPOSURE_MODE_ALL",
          "skill_uris": [
            "<string>"
          ]
        },
        "resource_exposure": {
          "mode": "MCP_TOOL_EXPOSURE_MODE_ALL",
          "resource_ids": [
            "<string>"
          ],
          "resource_template_ids": [
            "<string>"
          ]
        }
      }
    ],
    "tool_naming": "MCP_TOOL_NAMING_PREFIX_WITH_SERVER_KEY",
    "public_url": "<string>",
    "created": "<string>",
    "updated": "<string>",
    "exposed_tools_count": 123,
    "mode": "MCP_GATEWAY_MODE_CODE",
    "sharing": {
      "all_projects": {},
      "selected": {
        "project_ids": [
          "<string>"
        ]
      },
      "allow_version_pin": true,
      "allow_fork": true,
      "auto_grant_new_projects": true
    },
    "plugins": [
      {
        "id": "<string>",
        "language": "<string>",
        "entities": [
          "<string>"
        ],
        "on_failure": "<string>",
        "threshold": 123,
        "mask": [
          "<string>"
        ],
        "regions": [
          "<string>"
        ],
        "entity_thresholds": {}
      }
    ],
    "skill_ids": [
      "<string>"
    ],
    "icons": [
      {
        "src": "<string>",
        "mime_type": "<string>",
        "sizes": [
          "<string>"
        ],
        "theme": "<string>"
      }
    ],
    "website_url": "<string>",
    "guardrails": [
      {
        "id": "<string>",
        "execute_on": "<string>",
        "sample_rate": 123,
        "is_guardrail": true,
        "options": {}
      }
    ],
    "created_by_id": "<string>"
  }
}

{
  "message": "<string>",
  "code": 123,
  "details": [
    "<unknown>"
  ]
}

PATCH

mcp-gateways

{id}

Core - Narrow the tools a gateway exposes

curl --request PATCH \
  --url 'https://router.toqan.ai/eu/v2/mcp-gateways/01JQ0M8W4T5YB2Q7N1F6K3PZRC' \
  --header "Authorization: Bearer $TOQAN_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "server_links": [
      {
        "mcp_server_id": "01JQ0K5R8N2ZC7X4M9T3V6HWBD",
        "alias": "github",
        "enabled": true,
        "tool_exposure": {
          "mode": "MCP_TOOL_EXPOSURE_MODE_SELECTED",
          "tool_ids": [
            "01JQ0KA2M7VD9E4R6T8Y1U3XSB",
            "01JQ0KB5P9WF2G7H4J6K8L1NQD"
          ]
        }
      }
    ]
  }'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    key: '<string>',
    display_name: '<string>',
    description: '<string>',
    server_links: [
      {
        mcp_server_id: '<string>',
        alias: '<string>',
        tool_exposure: {
          mode: 'MCP_TOOL_EXPOSURE_MODE_ALL',
          read_only: true,
          tool_ids: ['<string>'],
          excluded_tool_ids: ['<string>']
        },
        enabled: true
      }
    ],
    sharing: {
      all_projects: {},
      selected: {project_ids: ['<string>']},
      allow_version_pin: true,
      allow_fork: true,
      auto_grant_new_projects: true
    },
    clear_server_links: true,
    plugins: [
      {
        id: '<string>',
        language: '<string>',
        entities: ['<string>'],
        on_failure: '<string>',
        threshold: 123,
        mask: ['<string>'],
        regions: ['<string>'],
        entity_thresholds: {}
      }
    ],
    skill_ids: ['<string>'],
    clear_skill_ids: true,
    icons: [
      {src: '<string>', mime_type: '<string>', sizes: ['<string>'], theme: '<string>'}
    ],
    replace_icons: true,
    website_url: '<string>',
    guardrails: [
      {
        id: '<string>',
        execute_on: '<string>',
        sample_rate: 123,
        is_guardrail: true,
        options: {}
      }
    ],
    expected_updated: '<string>'
  })
};

fetch('https://router.toqan.ai/eu/v2/mcp-gateways/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://router.toqan.ai/eu/v2/mcp-gateways/{id}"

payload = {
    "key": "<string>",
    "display_name": "<string>",
    "description": "<string>",
    "server_links": [
        {
            "mcp_server_id": "<string>",
            "alias": "<string>",
            "tool_exposure": {
                "mode": "MCP_TOOL_EXPOSURE_MODE_ALL",
                "read_only": True,
                "tool_ids": ["<string>"],
                "excluded_tool_ids": ["<string>"]
            },
            "enabled": True
        }
    ],
    "sharing": {
        "all_projects": {},
        "selected": { "project_ids": ["<string>"] },
        "allow_version_pin": True,
        "allow_fork": True,
        "auto_grant_new_projects": True
    },
    "clear_server_links": True,
    "plugins": [
        {
            "id": "<string>",
            "language": "<string>",
            "entities": ["<string>"],
            "on_failure": "<string>",
            "threshold": 123,
            "mask": ["<string>"],
            "regions": ["<string>"],
            "entity_thresholds": {}
        }
    ],
    "skill_ids": ["<string>"],
    "clear_skill_ids": True,
    "icons": [
        {
            "src": "<string>",
            "mime_type": "<string>",
            "sizes": ["<string>"],
            "theme": "<string>"
        }
    ],
    "replace_icons": True,
    "website_url": "<string>",
    "guardrails": [
        {
            "id": "<string>",
            "execute_on": "<string>",
            "sample_rate": 123,
            "is_guardrail": True,
            "options": {}
        }
    ],
    "expected_updated": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "mcp_gateway": {
    "id": "<string>",
    "key": "<string>",
    "display_name": "Production Gateway",
    "description": "<string>",
    "server_links": [
      {
        "mcp_server_id": "<string>",
        "alias": "<string>",
        "tool_exposure": {
          "mode": "MCP_TOOL_EXPOSURE_MODE_ALL",
          "read_only": true,
          "tool_ids": [
            "<string>"
          ],
          "excluded_tool_ids": [
            "<string>"
          ]
        },
        "enabled": true,
        "skill_exposure": {
          "mode": "MCP_TOOL_EXPOSURE_MODE_ALL",
          "skill_uris": [
            "<string>"
          ]
        },
        "resource_exposure": {
          "mode": "MCP_TOOL_EXPOSURE_MODE_ALL",
          "resource_ids": [
            "<string>"
          ],
          "resource_template_ids": [
            "<string>"
          ]
        }
      }
    ],
    "tool_naming": "MCP_TOOL_NAMING_PREFIX_WITH_SERVER_KEY",
    "public_url": "<string>",
    "created": "<string>",
    "updated": "<string>",
    "exposed_tools_count": 123,
    "mode": "MCP_GATEWAY_MODE_CODE",
    "sharing": {
      "all_projects": {},
      "selected": {
        "project_ids": [
          "<string>"
        ]
      },
      "allow_version_pin": true,
      "allow_fork": true,
      "auto_grant_new_projects": true
    },
    "plugins": [
      {
        "id": "<string>",
        "language": "<string>",
        "entities": [
          "<string>"
        ],
        "on_failure": "<string>",
        "threshold": 123,
        "mask": [
          "<string>"
        ],
        "regions": [
          "<string>"
        ],
        "entity_thresholds": {}
      }
    ],
    "skill_ids": [
      "<string>"
    ],
    "icons": [
      {
        "src": "<string>",
        "mime_type": "<string>",
        "sizes": [
          "<string>"
        ],
        "theme": "<string>"
      }
    ],
    "website_url": "<string>",
    "guardrails": [
      {
        "id": "<string>",
        "execute_on": "<string>",
        "sample_rate": 123,
        "is_guardrail": true,
        "options": {}
      }
    ],
    "created_by_id": "<string>"
  }
}

{
  "message": "<string>",
  "code": 123,
  "details": [
    "<unknown>"
  ]
}

Related guide: MCP gateways guide. See the MCP gateways guide for a walkthrough with examples.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Unique identifier of the MCP gateway.

Body

application/json

key

string

Rejected with INVALID_ARGUMENT: the key backs the gateway's public MCP URL and is immutable after creation. Retained so callers get an error rather than a silently ignored field.

display_name

string

Human readable name shown in the workspace.

description

string

Free-form note about what this gateway is for.

server_links

object[]

Replaces the current links. An empty array is treated as no change; use clear_server_links to remove them all.

Show child attributes

tool_naming

enum<string>

How upstream tool names are namespaced before they are exposed.

Available options:

MCP_TOOL_NAMING_PREFIX_WITH_SERVER_KEY,

MCP_TOOL_NAMING_PREFIX_ON_COLLISION

mode

enum<string>

Shape of the tool surface presented to MCP clients: CODE or DIRECT.

Available options:

MCP_GATEWAY_MODE_CODE,

MCP_GATEWAY_MODE_DIRECT

Which projects in the workspace may use this gateway. Defaults to every project.

Show child attributes

clear_server_links

boolean

Set true to remove every link; cannot be combined with server_links.

plugins

object[]

Plugins run on every tool call this gateway serves.

Show child attributes

skill_ids

string[]

Replaces the served workspace skills. An empty array is treated as no change; use clear_skill_ids to remove them all.

clear_skill_ids

boolean

Set true to stop serving every workspace skill; cannot be combined with skill_ids.

icons

object[]

Replaces the advertised icons when nonempty or when replace_icons is true.

Show child attributes

replace_icons

boolean

Set true with an empty icons list to restore default Toqan Router branding.

website_url

string

Empty restores the default Toqan Router documentation website.

guardrails

object[]

Guardrails run on the arguments and result of every tool call this gateway serves.

Show child attributes

expected_updated

string

Latest observed McpGateway.updated value. Required when changing resource exposure or re-enabling a link that exposes resources.

Response

mcp_gateway

object

Show child attributes

HTTP clients

Platform APIs

Management APIs

Authorizations

Path Parameters

Body

Response