Partial update. Omitted fields are left as they are.The same write-time refusals apply as on
create: a new upstream_url is
re-validated through the SSRF chokepoint, a literal credential in auth.headers
is refused, and userinfo in the URL (https://user:pass@host/) is rejected — a
credential written into a URL lands in plaintext in every log line and error
message that echoes it.Setting allowed_tools to [] takes every tool off the server. That is a valid
thing to want and it is not a soft state: the server will advertise nothing.Requires the update capability on ai_gateway. See the control-plane overview for authentication, the {data, meta} envelope, pagination and error types.
Authorizations
OAuth2BearerAuthApiKeyAuth
Authorization
string
header
required
OAuth 2.1 authentication — recommended for new integrations. Access tokens
(kc_ prefix) are minted at the root-host token endpoint
https://api.knoxcall.com/oauth/token and passed as Authorization: Bearer <access_token>.
Public clients must use PKCE with the authorization_code grant; confidential
clients may use client_credentials. The first-party SDKs and the
knoxcall login CLI handle token minting, caching, refresh, and DPoP for you.
Path Parameters
id
string<uuid>
required
The MCP server UUID.
Body
application/json
name
string
description
string | null
upstream_url
string<uri>
transport
enum<string>
Only streamable_http is accepted (see the create request).
Available options:
streamable_http
allowed_tools
string[]
pii_inspection
boolean
auth
object
Upstream auth for an MCP server. A secret reference is the only supported path: every header value must contain a {{secret_id:<uuid>}} (or legacy {{secret:<name>}}) placeholder. A literal is refused with 422 plaintext_auth — it would sit in cleartext in the control plane.
Show child attributes
status
enum<string>
Use DELETE to archive.
Available options:
active,
paused
pii_redact_policy_id
string<uuid> | null
A PII policy THIS tenant owns (AIGW-151). A policy id you do not own is refused 422 — the FK is id-only, so the ownership check is the control.
firewall_policy_id
string<uuid> | null
guardrail_webhook_url
string<uri> | null
https only; no embedded credentials; SSRF-checked at write time.
guardrail_webhook_secret_id
string<uuid> | null
guardrail_webhook_mode
enum<string>
Available options:
off,
request,
response,
both
guardrail_webhook_timeout_ms
integer
Required range: 100 <= x <= 10000
guardrail_webhook_failure_action
enum<string>
Available options:
fail_open,
fail_closed
Response
The updated MCP server.
data
object
An MCP server KnoxCall proxies and governs. connect_url and resource
are deliberately different values — see their descriptions.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"KnoxCall Docs","colors":{"primary":"#18181B","light":"#A1A1AA","dark":"#09090B"},"logo":{"light":"https://mintcdn.com/knoxcall/Hani9qeqybFGCQd1/logo/light.svg?fit=max\u0026auto=format\u0026n=Hani9qeqybFGCQd1\u0026q=85\u0026s=b6279c9a774c9ff9c8a87d6ac0065b14","dark":"https://mintcdn.com/knoxcall/Hani9qeqybFGCQd1/logo/dark.svg?fit=max\u0026auto=format\u0026n=Hani9qeqybFGCQd1\u0026q=85\u0026s=1e0163bf9bf7997f45842652ecdf4a96"},"favicon":"https://mintcdn.com/knoxcall/Hani9qeqybFGCQd1/favicon.svg?fit=max\u0026auto=format\u0026n=Hani9qeqybFGCQd1\u0026q=85\u0026s=7902c6a426671befdf8f7c01aacae604","api":{"openapi":"api-reference/openapi.yaml"},"appearance":{"default":"dark","strict":false},"navbar":{"links":[{"href":"https://app.knoxcall.com","label":"Dashboard"}],"primary":{"type":"button","label":"Get Started","href":"https://knoxcall.com/register"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":true},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"headset","href":"https://knoxcall.com"},{"anchor":"Community","icon":"message-circle","href":"https://discord.knoxcall.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"knoxcall","hasAudioNarration":false,"actualSubdomain":"knoxcall","customDomains":["docs.knoxcall.com"],"gitSource":{"type":"github","owner":"knoxcall","repo":"knoxcall","deployBranch":"main","contentDirectory":"wiki","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6b0269b53ca2a55c00662c42","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":175},{"language":"default","tag":"API Reference","count":128},{"language":"default","tag":"AI Gateway","count":75},{"language":"default","tag":"Integration Setup Guides","count":24},{"language":"default","tag":"Webhooks","count":14},{"language":"default","tag":"Workflows","count":12},{"language":"default","tag":"Secret Store Migrations","count":11},{"language":"default","tag":"Single Sign-On (SAML)","count":10},{"language":"default","tag":"Overview","count":9},{"language":"default","tag":"Secrets","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root[class~=\"dark\"]{--background: #09090B;--background-light: #111113}:root[class~=\"dark\"] #sidebar{background:#09090B;border-color:rgba(255, 255, 255, 0.06)}:root[class~=\"dark\"] #navbar{background:rgba(9, 9, 11, 0.88);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border-color:rgba(255, 255, 255, 0.06)}:root[class~=\"dark\"] .bg-card{background:#111113;border-color:rgba(255, 255, 255, 0.06)}:root[class~=\"dark\"] pre{background:#111113!important;border:1px solid rgba(255, 255, 255, 0.06)}:root[class~=\"dark\"] :not(pre)>code{background:rgba(255, 255, 255, 0.05);border:1px solid rgba(255, 255, 255, 0.06);color:#D4D4D8}:root:not([class~=\"dark\"]){--background: #FFFFFF;--background-light: #FAFAFA}:root:not([class~=\"dark\"]) #sidebar{background:#FFFFFF;border-color:rgba(0, 0, 0, 0.07)}:root:not([class~=\"dark\"]) #navbar{background:rgba(255, 255, 255, 0.88);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border-color:rgba(0, 0, 0, 0.07)}:root:not([class~=\"dark\"]) .bg-card{background:#FAFAFA;border-color:rgba(0, 0, 0, 0.07)}:root:not([class~=\"dark\"]) pre{background:#111113!important;border:1px solid rgba(0, 0, 0, 0.07)}:root:not([class~=\"dark\"]) [data-component-part=\"code-block-root\"]{background-color:#111113!important;border:1px solid rgba(0, 0, 0, 0.07)}:root:not([class~=\"dark\"]) :not(pre)>code{background:rgba(0, 0, 0, 0.04);border:1px solid rgba(0, 0, 0, 0.07);color:#18181B}#sidebar{width:20rem!important;min-width:20rem!important;max-width:20rem!important}code{font-family:'Geist Mono', 'JetBrains Mono', 'Fira Code', ui-monospace, monospace;font-size:0.8125em;border-radius:5px;padding:2px 6px}pre code{padding:0;border:none;background:transparent!important}#sidebar,#navbar,.bg-card,pre,code{transition:background-color 0.15s ease, border-color 0.15s ease}"}]}
{"page":{"pagePath":"api-reference/ai-gateway/mcp-servers-update","slug":"/api-reference/ai-gateway/mcp-servers-update","pageMetadata":{"title":"Update an MCP Server","description":"Change a server's upstream, tool allowlist, PII inspection or auth mode.","openapi":"PATCH /ai-gateway/mcp-servers/{id}","href":"/api-reference/ai-gateway/mcp-servers-update"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Change a server’s upstream, tool allowlist, PII inspection or auth mode.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Partial update. Omitted fields are left as they are.`}),`\n`,_jsxs(_components.p,{children:[`The same write-time refusals apply as on\n`,_jsx(_components.a,{href:`/api-reference/ai-gateway/mcp-servers-create`,children:`create`}),`: a new `,_jsx(_components.code,{children:`upstream_url`}),` is\nre-validated through the SSRF chokepoint, a literal credential in `,_jsx(_components.code,{children:`auth.headers`}),`\nis refused, and userinfo in the URL (`,_jsx(_components.code,{children:`https://user:pass@host/`}),`) is rejected — a\ncredential written into a URL lands in plaintext in every log line and error\nmessage that echoes it.`]}),`\n`,_jsxs(_components.p,{children:[`Setting `,_jsx(_components.code,{children:`allowed_tools`}),` to `,_jsx(_components.code,{children:`[]`}),` takes every tool off the server. That is a valid\nthing to want and it is not a soft state: the server will advertise nothing.`]}),`\n`,_jsxs(_components.p,{children:[`Requires the `,_jsx(_components.code,{children:`update`}),` capability on `,_jsx(_components.code,{children:`ai_gateway`}),`. See the `,_jsx(_components.a,{href:`/api-reference/ai-gateway/control-plane-overview#authentication`,children:`control-plane overview`}),` for authentication, the `,_jsx(_components.code,{children:`{data, meta}`}),` envelope, pagination and error types.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Update an MCP Server","description":"Change a server's upstream, tool allowlist, PII inspection or auth mode.","openapi":"PATCH /ai-gateway/mcp-servers/{id}","href":"/api-reference/ai-gateway/mcp-servers-update"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"updateAiGatewayMcpServer","summary":"Update an MCP server","description":"Change a server's upstream, tool allowlist, PII inspection or auth mode.","tags":["AI Gateway"],"requestBody":"7a3d9ec9-303e-416f-9401-b081520400e6","responses":{"200":"6e4a3ecf-2506-4ee6-bf12-08db400eaa45","401":"cefee4fd-40b5-4ce2-a640-0829c4a06a85","403":"b758538b-75c0-45a0-b801-8be0a6c1e9e1","404":"b1ccbf3a-e195-49ae-8c35-53f88a0437df","409":"09056ca2-c588-4173-ba88-222abf24ab7a","422":"1e08b8d7-a967-4664-aff3-4778057f5b97","500":"de13df6a-4ae9-4100-afa6-f07a6d214f11"},"method":"patch","type":"path","servers":["440891b5-f7c9-4d73-bdf4-4195929faed2","5671e780-1911-4eee-98e2-8258f0dc1ee7"],"security":["79bbac72-4d50-472b-8e81-6d6a28db36ba","ff38421b-cb89-429f-8392-601071260cc3","58b64ca8-afd4-45f9-9f3b-28ec18e9f92e"],"path":"/ai-gateway/mcp-servers/{id}","baseUrlOptions":["https://api.knoxcall.com/v1","https://sandbox.knoxcall.com/v1"],"title":"Update an MCP server","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0dc0b08f-bd2e-4302-9d1f-c4aab929bce7":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The MCP server UUID.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"The MCP server UUID."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"upstream_url":{"type":"string","format":"uri","uniqueKey":"upstream_url","typeLabel":"string\u003curi>"},"transport":{"type":"string","enum":["streamable_http"],"description":"Only `streamable_http` is accepted (see the create request).","uniqueKey":"transport","typeLabel":"enum\u003cstring>"},"allowed_tools":{"type":"array","items":{"type":"string","uniqueKey":"allowed_tools.items.[INDEX]","typeLabel":"string"},"uniqueKey":"allowed_tools","typeLabel":"string[]"},"pii_inspection":{"type":"boolean","uniqueKey":"pii_inspection","typeLabel":"boolean"},"auth":{"type":"object","description":"Upstream auth for an MCP server. A secret reference is the only supported path: every header value must contain a `{{secret_id:\u003cuuid>}}` (or legacy `{{secret:\u003cname>}}`) placeholder. A literal is refused with 422 `plaintext_auth` — it would sit in cleartext in the control plane.","properties":{"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"auth.headers.additionalProperties","typeLabel":"string"},"example":{"Authorization":"Bearer {{secret_id:11111111-2222-3333-4444-555555555555}}"},"uniqueKey":"auth.headers","typeLabel":"object"},"environment_name":{"type":"string","default":"production","description":"Which per-environment secret value to resolve.","uniqueKey":"auth.environment_name","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"auth","typeLabel":"object"},"status":{"type":"string","enum":["active","paused"],"description":"Use `DELETE` to archive.","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"pii_redact_policy_id":{"oneOf":[{"type":"string","format":"uuid","description":"A PII policy THIS tenant owns (AIGW-151). A policy id you do not own is refused 422 — the FK is id-only, so the ownership check is the control.","uniqueKey":"pii_redact_policy_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"A PII policy THIS tenant owns (AIGW-151). A policy id you do not own is refused 422 — the FK is id-only, so the ownership check is the control.","uniqueKey":"pii_redact_policy_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"pii_redact_policy_id","typeLabel":"string\u003cuuid> | null"},"firewall_policy_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"firewall_policy_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"firewall_policy_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"firewall_policy_id","typeLabel":"string\u003cuuid> | null"},"guardrail_webhook_url":{"oneOf":[{"type":"string","format":"uri","description":"https only; no embedded credentials; SSRF-checked at write time.","uniqueKey":"guardrail_webhook_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"https only; no embedded credentials; SSRF-checked at write time.","uniqueKey":"guardrail_webhook_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"guardrail_webhook_url","typeLabel":"string\u003curi> | null"},"guardrail_webhook_secret_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"guardrail_webhook_secret_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"guardrail_webhook_secret_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"guardrail_webhook_secret_id","typeLabel":"string\u003cuuid> | null"},"guardrail_webhook_mode":{"type":"string","enum":["off","request","response","both"],"uniqueKey":"guardrail_webhook_mode","typeLabel":"enum\u003cstring>"},"guardrail_webhook_timeout_ms":{"type":"integer","minimum":100,"maximum":10000,"uniqueKey":"guardrail_webhook_timeout_ms","typeLabel":"integer"},"guardrail_webhook_failure_action":{"type":"string","enum":["fail_open","fail_closed"],"uniqueKey":"guardrail_webhook_failure_action","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"allowed_tools":["get_weather"],"status":"paused"},"examples":{"Example":{"title":"Example","value":{"allowed_tools":["get_weather"],"status":"paused"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"6e4a3ecf-2506-4ee6-bf12-08db400eaa45":{"description":"The updated MCP server.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"An MCP server KnoxCall proxies and governs. `connect_url` and `resource`\nare deliberately different values — see their descriptions.\n","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"gateway_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"data.gateway_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"data.gateway_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.gateway_id","typeLabel":"string\u003cuuid> | null"},"name":{"type":"string","uniqueKey":"data.name","typeLabel":"string"},"slug":{"oneOf":[{"type":"string","description":"Lowercase machine handle; the last segment of `connect_url`.","uniqueKey":"data.slug.oneOf.0","typeLabel":"string"},{"type":"null","description":"Lowercase machine handle; the last segment of `connect_url`.","uniqueKey":"data.slug.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.slug","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","uniqueKey":"data.description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.description","typeLabel":"string | null"},"server_type":{"type":"string","enum":["upstream","collection"],"description":"Only `upstream` can be created today; `collection` is not served yet.","uniqueKey":"data.server_type","typeLabel":"enum\u003cstring>"},"transport":{"oneOf":[{"type":"string","enum":["streamable_http","sse",null],"uniqueKey":"data.transport.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["streamable_http","sse",null],"uniqueKey":"data.transport.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.transport","typeLabel":"enum\u003cstring> | null"},"upstream_url":{"oneOf":[{"type":"string","format":"uri","description":"The upstream MCP endpoint. Always a public `https://` address.","uniqueKey":"data.upstream_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"The upstream MCP endpoint. Always a public `https://` address.","uniqueKey":"data.upstream_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.upstream_url","typeLabel":"string\u003curi> | null"},"allowed_tools":{"type":"array","items":{"type":"string","uniqueKey":"data.allowed_tools.items.[INDEX]","typeLabel":"string"},"description":"Tool names this server may advertise. EMPTY MEANS IT ADVERTISES NOTHING — a client sees an empty tool list.","uniqueKey":"data.allowed_tools","typeLabel":"string[]"},"pii_inspection":{"type":"boolean","description":"Inspect tool arguments and results for PII.","uniqueKey":"data.pii_inspection","typeLabel":"boolean"},"pii_redact_policy_id":{"oneOf":[{"type":"string","format":"uuid","description":"The tenant PII policy whose recognizers apply to this server's tool arguments and results (AIGW-151). Null means every enabled recognizer this tenant owns, on top of the shipped built-ins. Before AIGW-151 the MCP plane used one built-in-only detector stack built at boot, so no tenant recognizer ever applied to tool traffic.","uniqueKey":"data.pii_redact_policy_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The tenant PII policy whose recognizers apply to this server's tool arguments and results (AIGW-151). Null means every enabled recognizer this tenant owns, on top of the shipped built-ins. Before AIGW-151 the MCP plane used one built-in-only detector stack built at boot, so no tenant recognizer ever applied to tool traffic.","uniqueKey":"data.pii_redact_policy_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.pii_redact_policy_id","typeLabel":"string\u003cuuid> | null"},"firewall_policy_id":{"oneOf":[{"type":"string","format":"uuid","description":"Prompt-injection firewall policy applied to this server's tool traffic.","uniqueKey":"data.firewall_policy_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Prompt-injection firewall policy applied to this server's tool traffic.","uniqueKey":"data.firewall_policy_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.firewall_policy_id","typeLabel":"string\u003cuuid> | null"},"guardrail_webhook_url":{"oneOf":[{"type":"string","format":"uri","description":"The tenant's own external scanner (AIGW-150). https only, no embedded credentials, and the destination is SSRF-checked at write time and again on every call. Unlike `/v1/ai` there is no streaming carve-out — the MCP transport materialises every JSON-RPC message, so both directions are always inspectable.","uniqueKey":"data.guardrail_webhook_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"The tenant's own external scanner (AIGW-150). https only, no embedded credentials, and the destination is SSRF-checked at write time and again on every call. Unlike `/v1/ai` there is no streaming carve-out — the MCP transport materialises every JSON-RPC message, so both directions are always inspectable.","uniqueKey":"data.guardrail_webhook_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.guardrail_webhook_url","typeLabel":"string\u003curi> | null"},"guardrail_webhook_secret_id":{"oneOf":[{"type":"string","format":"uuid","description":"KnoxCall secret holding the HMAC key deliveries are signed with.","uniqueKey":"data.guardrail_webhook_secret_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"KnoxCall secret holding the HMAC key deliveries are signed with.","uniqueKey":"data.guardrail_webhook_secret_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.guardrail_webhook_secret_id","typeLabel":"string\u003cuuid> | null"},"guardrail_webhook_mode":{"type":"string","enum":["off","request","response","both"],"description":"Which directions are offered to the scanner. `request` sees the tool ARGUMENTS after PII redaction and before they leave; `response` sees the tool RESULT after redaction and before it is returned. A `block` verdict refuses the call.","uniqueKey":"data.guardrail_webhook_mode","typeLabel":"enum\u003cstring>"},"guardrail_webhook_timeout_ms":{"type":"integer","minimum":100,"maximum":10000,"uniqueKey":"data.guardrail_webhook_timeout_ms","typeLabel":"integer"},"guardrail_webhook_failure_action":{"type":"string","enum":["fail_open","fail_closed"],"description":"What happens when the scanner cannot be reached or does not answer.","uniqueKey":"data.guardrail_webhook_failure_action","typeLabel":"enum\u003cstring>"},"auth":{"type":"object","additionalProperties":true,"description":"Upstream auth. Only `{ headers, environment_name }` is supported, and every header value must reference a KnoxCall secret, so this object never contains a credential.","uniqueKey":"data.auth","typeLabel":"object"},"sandbox":{"type":"boolean","description":"Which Live/Test space this server lives in (AIGW-152). READ-ONLY: it is taken from the mode of the request that created the server (a test API key on the sandbox host makes a Test server) and cannot be set or changed through the API, for the same reason the mode is never a request field anywhere else — a body that could choose it would let a Test caller create a Live server whose `auth` reference resolves a LIVE secret. Reads and writes are confined to the calling key's own space, so a Live key does not see a Test server at all. On the data plane the confinement is the capability token's: a `kp_test_` token against a Live server is a 404. The same slug may exist in both spaces, so an MCP client's configuration does not change between them.","uniqueKey":"data.sandbox","typeLabel":"boolean"},"status":{"type":"string","enum":["active","paused","archived"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"},"connect_url":{"type":"string","format":"uri","description":"Where an MCP client points. Served on the tenant data-plane host.","uniqueKey":"data.connect_url","typeLabel":"string\u003curi>"},"resource":{"type":"string","format":"uri","description":"The RFC 8707 `resource` a token for this server must be bound to. A token bound to a different resource is refused at this server.","uniqueKey":"data.resource","typeLabel":"string\u003curi>"}},"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","description":"Metadata included with every API response.","properties":{"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this API request, useful for support and debugging.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string\u003cuuid>"}},"required":["request_id"],"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","gateway_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","slug":"\u003cstring>","description":"\u003cstring>","server_type":"upstream","transport":"streamable_http","upstream_url":"\u003cstring>","allowed_tools":["\u003cstring>"],"pii_inspection":true,"pii_redact_policy_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","firewall_policy_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","guardrail_webhook_url":"\u003cstring>","guardrail_webhook_secret_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","guardrail_webhook_mode":"off","guardrail_webhook_timeout_ms":5050,"guardrail_webhook_failure_action":"fail_open","auth":{},"sandbox":true,"status":"active","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","connect_url":"\u003cstring>","resource":"\u003cstring>"},"meta":{"request_id":"550e8400-e29b-41d4-a716-446655440000"}}}},"exampleType":"generated"}},"exampleType":"generated"},"cefee4fd-40b5-4ce2-a640-0829c4a06a85":{"description":"Authentication is required or the provided API key is invalid.","headers":{"X-Request-Id":{"description":"Unique identifier for this request (UUID). Present on **every** response and equal\nto the `request_id` field in the response body. Quote it when contacting support.\n","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"},"KnoxCall-Version":{"description":"The dated API version (`YYYY-MM-DD`) that served this response. Equals the value\nof the `KnoxCall-Version` request header when supplied, otherwise the newest version.\n","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-08-05T00:00:00.000Z"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response envelope.","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Machine-readable error type. The set is OPEN — endpoints define specific types beyond the common ones below, so clients should branch on the types they know and fall back to the HTTP status class for anything unrecognized. Common values: authentication_required, invalid_api_key, wrong_key_type, subscription_inactive, rate_limit_exceeded, validation_error, forbidden, not_found, method_not_allowed (405, carries Allow), conflict, in_use, plan_limit, plan_feature, internal_error, dependency_unavailable (503, carries Retry-After), invalid_request, invalid_definition, not_cancellable, invalid_idempotency_key, idempotency_key_reuse, request_in_progress, system_client_protected, use_oauth, use_dpop_nonce (401 on /v1 and the data plane, 400 on POST /oauth/token; see \"DPoP sender-constrained tokens\").","example":"validation_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message.","example":"name and target_base_url are required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"required":["type","message","request_id"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"missing_key":{"title":"missing_key","summary":"No API key provided","value":{"error":{"type":"authentication_required","message":"API key is required. Use Authorization: Bearer \u003capi_key> or x-api-key header.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}},"invalid_key":{"title":"invalid_key","summary":"Invalid API key","value":{"error":{"type":"invalid_api_key","message":"Invalid API key.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}}},"exampleType":"examples"}},"exampleType":"examples"},"b758538b-75c0-45a0-b801-8be0a6c1e9e1":{"description":"The key is authenticated but not authorized for this action (missing scope), a plan\nlimit was reached, or the resource must be managed via OAuth (`use_oauth`) / is a\nprotected system client (`system_client_protected`).\n","headers":{"X-Request-Id":{"description":"Unique identifier for this request (UUID). Present on **every** response and equal\nto the `request_id` field in the response body. Quote it when contacting support.\n","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"},"KnoxCall-Version":{"description":"The dated API version (`YYYY-MM-DD`) that served this response. Equals the value\nof the `KnoxCall-Version` request header when supplied, otherwise the newest version.\n","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-08-05T00:00:00.000Z"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response envelope.","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Machine-readable error type. The set is OPEN — endpoints define specific types beyond the common ones below, so clients should branch on the types they know and fall back to the HTTP status class for anything unrecognized. Common values: authentication_required, invalid_api_key, wrong_key_type, subscription_inactive, rate_limit_exceeded, validation_error, forbidden, not_found, method_not_allowed (405, carries Allow), conflict, in_use, plan_limit, plan_feature, internal_error, dependency_unavailable (503, carries Retry-After), invalid_request, invalid_definition, not_cancellable, invalid_idempotency_key, idempotency_key_reuse, request_in_progress, system_client_protected, use_oauth, use_dpop_nonce (401 on /v1 and the data plane, 400 on POST /oauth/token; see \"DPoP sender-constrained tokens\").","example":"validation_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message.","example":"name and target_base_url are required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"required":["type","message","request_id"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"forbidden":{"title":"forbidden","summary":"Missing scope","value":{"error":{"type":"forbidden","message":"This key is not authorized to list AI gateways.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}},"use_oauth":{"title":"use_oauth","summary":"Resource is OAuth-only","value":{"error":{"type":"use_oauth","message":"This resource must be managed with an OAuth 2.1 access token.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}},"system_client_protected":{"title":"system_client_protected","summary":"Protected system client","value":{"error":{"type":"system_client_protected","message":"This client is managed by the platform and cannot be modified.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}}},"exampleType":"examples"}},"exampleType":"examples"},"b1ccbf3a-e195-49ae-8c35-53f88a0437df":{"description":"The requested resource was not found.","headers":{"X-Request-Id":{"description":"Unique identifier for this request (UUID). Present on **every** response and equal\nto the `request_id` field in the response body. Quote it when contacting support.\n","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"},"KnoxCall-Version":{"description":"The dated API version (`YYYY-MM-DD`) that served this response. Equals the value\nof the `KnoxCall-Version` request header when supplied, otherwise the newest version.\n","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-08-05T00:00:00.000Z"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response envelope.","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Machine-readable error type. The set is OPEN — endpoints define specific types beyond the common ones below, so clients should branch on the types they know and fall back to the HTTP status class for anything unrecognized. Common values: authentication_required, invalid_api_key, wrong_key_type, subscription_inactive, rate_limit_exceeded, validation_error, forbidden, not_found, method_not_allowed (405, carries Allow), conflict, in_use, plan_limit, plan_feature, internal_error, dependency_unavailable (503, carries Retry-After), invalid_request, invalid_definition, not_cancellable, invalid_idempotency_key, idempotency_key_reuse, request_in_progress, system_client_protected, use_oauth, use_dpop_nonce (401 on /v1 and the data plane, 400 on POST /oauth/token; see \"DPoP sender-constrained tokens\").","example":"validation_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message.","example":"name and target_base_url are required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"required":["type","message","request_id"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"not_found","message":"Route not found.","request_id":"550e8400-e29b-41d4-a716-446655440000"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"not_found","message":"Route not found.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}}},"exampleType":"examples"}},"exampleType":"examples"},"09056ca2-c588-4173-ba88-222abf24ab7a":{"description":"A resource with the same unique identifier already exists, or the resource is in use.","headers":{"X-Request-Id":{"description":"Unique identifier for this request (UUID). Present on **every** response and equal\nto the `request_id` field in the response body. Quote it when contacting support.\n","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"},"KnoxCall-Version":{"description":"The dated API version (`YYYY-MM-DD`) that served this response. Equals the value\nof the `KnoxCall-Version` request header when supplied, otherwise the newest version.\n","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-08-05T00:00:00.000Z"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response envelope.","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Machine-readable error type. The set is OPEN — endpoints define specific types beyond the common ones below, so clients should branch on the types they know and fall back to the HTTP status class for anything unrecognized. Common values: authentication_required, invalid_api_key, wrong_key_type, subscription_inactive, rate_limit_exceeded, validation_error, forbidden, not_found, method_not_allowed (405, carries Allow), conflict, in_use, plan_limit, plan_feature, internal_error, dependency_unavailable (503, carries Retry-After), invalid_request, invalid_definition, not_cancellable, invalid_idempotency_key, idempotency_key_reuse, request_in_progress, system_client_protected, use_oauth, use_dpop_nonce (401 on /v1 and the data plane, 400 on POST /oauth/token; see \"DPoP sender-constrained tokens\").","example":"validation_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message.","example":"name and target_base_url are required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"required":["type","message","request_id"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"conflict","message":"A route with this name already exists.","request_id":"550e8400-e29b-41d4-a716-446655440000"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"conflict","message":"A route with this name already exists.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}}},"exampleType":"examples"}},"exampleType":"examples"},"1e08b8d7-a967-4664-aff3-4778057f5b97":{"description":"The MCP server definition was refused. `plaintext_auth` — an `auth.headers`\nvalue is a literal credential rather than a `{{secret_id:\u003cuuid>}}`\nreference. `validation` — `upstream_url` is not a public https address, or\na field failed validation. `unsupported_server_type` — `collection` is not\nserved yet.\n","headers":{"X-Request-Id":{"description":"Unique identifier for this request (UUID). Present on **every** response and equal\nto the `request_id` field in the response body. Quote it when contacting support.\n","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"},"KnoxCall-Version":{"description":"The dated API version (`YYYY-MM-DD`) that served this response. Equals the value\nof the `KnoxCall-Version` request header when supplied, otherwise the newest version.\n","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-08-05T00:00:00.000Z"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response envelope.","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Machine-readable error type. The set is OPEN — endpoints define specific types beyond the common ones below, so clients should branch on the types they know and fall back to the HTTP status class for anything unrecognized. Common values: authentication_required, invalid_api_key, wrong_key_type, subscription_inactive, rate_limit_exceeded, validation_error, forbidden, not_found, method_not_allowed (405, carries Allow), conflict, in_use, plan_limit, plan_feature, internal_error, dependency_unavailable (503, carries Retry-After), invalid_request, invalid_definition, not_cancellable, invalid_idempotency_key, idempotency_key_reuse, request_in_progress, system_client_protected, use_oauth, use_dpop_nonce (401 on /v1 and the data plane, 400 on POST /oauth/token; see \"DPoP sender-constrained tokens\").","example":"validation_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message.","example":"name and target_base_url are required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"required":["type","message","request_id"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"plaintext_auth":{"title":"plaintext_auth","summary":"A literal credential in auth.headers","value":{"error":{"type":"validation","message":"auth.headers[\"Authorization\"] must reference a KnoxCall secret, e.g. \"Bearer {{secret_id:\u003cuuid>}}\".","request_id":"550e8400-e29b-41d4-a716-446655440000"}}},"blocked_destination":{"title":"blocked_destination","summary":"upstream_url resolves to a private address","value":{"error":{"type":"validation","message":"upstream_url is not a valid MCP destination: \"169.254.169.254\" is in a private/reserved range.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}},"unsupported_server_type":{"title":"unsupported_server_type","summary":"collection is not served yet","value":{"error":{"type":"unsupported_server_type","message":"server_type 'collection' is not served yet - an MCP server must proxy an upstream MCP server (server_type 'upstream').","request_id":"550e8400-e29b-41d4-a716-446655440000"}}}},"exampleType":"examples"}},"exampleType":"examples"},"de13df6a-4ae9-4100-afa6-f07a6d214f11":{"description":"An unexpected server error occurred.","headers":{"X-Request-Id":{"description":"Unique identifier for this request (UUID). Present on **every** response and equal\nto the `request_id` field in the response body. Quote it when contacting support.\n","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"},"KnoxCall-Version":{"description":"The dated API version (`YYYY-MM-DD`) that served this response. Equals the value\nof the `KnoxCall-Version` request header when supplied, otherwise the newest version.\n","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-08-05T00:00:00.000Z"}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error response envelope.","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Machine-readable error type. The set is OPEN — endpoints define specific types beyond the common ones below, so clients should branch on the types they know and fall back to the HTTP status class for anything unrecognized. Common values: authentication_required, invalid_api_key, wrong_key_type, subscription_inactive, rate_limit_exceeded, validation_error, forbidden, not_found, method_not_allowed (405, carries Allow), conflict, in_use, plan_limit, plan_feature, internal_error, dependency_unavailable (503, carries Retry-After), invalid_request, invalid_definition, not_cancellable, invalid_idempotency_key, idempotency_key_reuse, request_in_progress, system_client_protected, use_oauth, use_dpop_nonce (401 on /v1 and the data plane, 400 on POST /oauth/token; see \"DPoP sender-constrained tokens\").","example":"validation_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message.","example":"name and target_base_url are required.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"}},"required":["type","message","request_id"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"internal_error","message":"An unexpected error occurred.","request_id":"550e8400-e29b-41d4-a716-446655440000"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"internal_error","message":"An unexpected error occurred.","request_id":"550e8400-e29b-41d4-a716-446655440000"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"79bbac72-4d50-472b-8e81-6d6a28db36ba":{"OAuth2":{"type":"oauth2","description":"OAuth 2.1 authentication — recommended for new integrations. Access tokens\n(`kc_` prefix) are minted at the root-host token endpoint\n`https://api.knoxcall.com/oauth/token` and passed as `Authorization: Bearer \u003caccess_token>`.\nPublic clients must use PKCE with the `authorization_code` grant; confidential\nclients may use `client_credentials`. The first-party SDKs and the\n`knoxcall login` CLI handle token minting, caching, refresh, and DPoP for you.\n","flows":{"clientCredentials":{"tokenUrl":"https://api.knoxcall.com/oauth/token","refreshUrl":"https://api.knoxcall.com/oauth/token","scopes":{"routes:read":"Read routes.","routes:write":"Create, update, and delete routes.","wrap:manifest:self":"A server credential's (Connect a server) view of GET /v1/wrap/intercept-manifest and POST /v1/wrap/egress-observations. It answers only for the server the credential belongs to - the routes assigned to that server in the requested environment whose routes:invoke:id:\u003croute_id> scope the token holds - and never lists another server's routes or the workspace's. A server credential invokes routes with routes:invoke:id:\u003croute_id>, one route per scope, by the route's id (never re-used, unlike a slug).","secrets:read":"Read secret metadata. Does NOT include retrieving a live OAuth2 access token.","secrets:oauth_token":"Retrieve a live upstream OAuth2 access token (GET /v1/secrets/{id}/oauth2/token). Distinct from secrets:read because the call refreshes the credential at the provider.","secrets:write":"Create, update, and delete secrets.","vaults:detokenize":"Turn a vault token back into its original value. Required by GET /v1/vaults/{vault}/tokens/{token}, by a token template reference in a /v1/proxy body, and by creating a `detokenize` route action. Distinct from vaults:read, which lists vaults and token metadata and never returns a value.","transit:decrypt":"Open a portable `kc:` ciphertext with a tenant transit key. Required by creating a `decrypt` route action, which stores a standing instruction to open every matching field on every later request through that route. It is the same capability name the policy engine uses for POST /v1/decrypt. No routes scope satisfies it — managing a route is not permission to open the data flowing through it.","proxy:invoke":"Call the one-shot ephemeral proxy (any method on /v1/proxy). Required for EVERY verb — the proxy is one capability behind one handler, and a bodyless GET spends an escrowed credential exactly as a POST does. Neither proxy:read nor proxy:write satisfies it.","clients:read":"Read clients.","clients:write":"Manage clients.","webhooks:write":"Manage webhooks.","workflows:write":"Manage and execute workflows.","*:*":"Full access (all scopes)."}},"authorizationCode":{"authorizationUrl":"https://api.knoxcall.com/oauth/authorize","tokenUrl":"https://api.knoxcall.com/oauth/token","refreshUrl":"https://api.knoxcall.com/oauth/token","scopes":{"routes:read":"Read routes.","routes:write":"Create, update, and delete routes.","wrap:manifest:self":"A server credential's (Connect a server) view of GET /v1/wrap/intercept-manifest and POST /v1/wrap/egress-observations. It answers only for the server the credential belongs to - the routes assigned to that server in the requested environment whose routes:invoke:id:\u003croute_id> scope the token holds - and never lists another server's routes or the workspace's. A server credential invokes routes with routes:invoke:id:\u003croute_id>, one route per scope, by the route's id (never re-used, unlike a slug).","secrets:read":"Read secret metadata. Does NOT include retrieving a live OAuth2 access token.","secrets:oauth_token":"Retrieve a live upstream OAuth2 access token (GET /v1/secrets/{id}/oauth2/token). Distinct from secrets:read because the call refreshes the credential at the provider.","secrets:write":"Create, update, and delete secrets.","vaults:detokenize":"Turn a vault token back into its original value. Required by GET /v1/vaults/{vault}/tokens/{token}, by a token template reference in a /v1/proxy body, and by creating a `detokenize` route action. Distinct from vaults:read, which lists vaults and token metadata and never returns a value.","transit:decrypt":"Open a portable `kc:` ciphertext with a tenant transit key. Required by creating a `decrypt` route action, which stores a standing instruction to open every matching field on every later request through that route. It is the same capability name the policy engine uses for POST /v1/decrypt. No routes scope satisfies it — managing a route is not permission to open the data flowing through it.","proxy:invoke":"Call the one-shot ephemeral proxy (any method on /v1/proxy). Required for EVERY verb — the proxy is one capability behind one handler, and a bodyless GET spends an escrowed credential exactly as a POST does. Neither proxy:read nor proxy:write satisfies it.","clients:read":"Read clients.","clients:write":"Manage clients.","webhooks:write":"Manage webhooks.","workflows:write":"Manage and execute workflows.","*:*":"Full access (all scopes)."}}},"scopes":[],"schemeName":"OAuth2"}},"ff38421b-cb89-429f-8392-601071260cc3":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Legacy long-lived API key authentication via the Authorization header.\nPass your API key as: `Authorization: Bearer tk_xxx_yyy`.\n\nStandard keys (`tk_` prefix) are accepted on `api.knoxcall.com`.\nTest keys (type=test) are accepted on `sandbox.knoxcall.com`.\nEnterprise Access Keys (`AKE` prefix) are accepted on both.\n\nFully supported, but prefer the `OAuth2` scheme (or the SDKs, which handle\nOAuth for you) for new integrations.\n","scopes":[],"schemeName":"BearerAuth"}},"58b64ca8-afd4-45f9-9f3b-28ec18e9f92e":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Legacy API key authentication via the `x-api-key` header.\nThis is an alternative to Bearer token authentication for clients that cannot\nset the `Authorization` header. Prefer the `OAuth2` scheme for new integrations.\n","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"440891b5-f7c9-4d73-bdf4-4195929faed2":{"url":"https://api.knoxcall.com/v1","description":"Production"},"5671e780-1911-4eee-98e2-8258f0dc1ee7":{"url":"https://sandbox.knoxcall.com/v1","description":"Sandbox (test keys only)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"OAuth 2.1 authentication — recommended for new integrations. Access tokens\n(`kc_` prefix) are minted at the root-host token endpoint\n`https://api.knoxcall.com/oauth/token` and passed as `Authorization: Bearer \u003caccess_token>`.\nPublic clients must use PKCE with the `authorization_code` grant; confidential\nclients may use `client_credentials`. The first-party SDKs and the\n`knoxcall login` CLI handle token minting, caching, refresh, and DPoP for you.\n","flows":{"clientCredentials":{"tokenUrl":"https://api.knoxcall.com/oauth/token","refreshUrl":"https://api.knoxcall.com/oauth/token","scopes":{"routes:read":"Read routes.","routes:write":"Create, update, and delete routes.","wrap:manifest:self":"A server credential's (Connect a server) view of GET /v1/wrap/intercept-manifest and POST /v1/wrap/egress-observations. It answers only for the server the credential belongs to - the routes assigned to that server in the requested environment whose routes:invoke:id:\u003croute_id> scope the token holds - and never lists another server's routes or the workspace's. A server credential invokes routes with routes:invoke:id:\u003croute_id>, one route per scope, by the route's id (never re-used, unlike a slug).","secrets:read":"Read secret metadata. Does NOT include retrieving a live OAuth2 access token.","secrets:oauth_token":"Retrieve a live upstream OAuth2 access token (GET /v1/secrets/{id}/oauth2/token). Distinct from secrets:read because the call refreshes the credential at the provider.","secrets:write":"Create, update, and delete secrets.","vaults:detokenize":"Turn a vault token back into its original value. Required by GET /v1/vaults/{vault}/tokens/{token}, by a token template reference in a /v1/proxy body, and by creating a `detokenize` route action. Distinct from vaults:read, which lists vaults and token metadata and never returns a value.","transit:decrypt":"Open a portable `kc:` ciphertext with a tenant transit key. Required by creating a `decrypt` route action, which stores a standing instruction to open every matching field on every later request through that route. It is the same capability name the policy engine uses for POST /v1/decrypt. No routes scope satisfies it — managing a route is not permission to open the data flowing through it.","proxy:invoke":"Call the one-shot ephemeral proxy (any method on /v1/proxy). Required for EVERY verb — the proxy is one capability behind one handler, and a bodyless GET spends an escrowed credential exactly as a POST does. Neither proxy:read nor proxy:write satisfies it.","clients:read":"Read clients.","clients:write":"Manage clients.","webhooks:write":"Manage webhooks.","workflows:write":"Manage and execute workflows.","*:*":"Full access (all scopes)."}},"authorizationCode":{"authorizationUrl":"https://api.knoxcall.com/oauth/authorize","tokenUrl":"https://api.knoxcall.com/oauth/token","refreshUrl":"https://api.knoxcall.com/oauth/token","scopes":{"routes:read":"Read routes.","routes:write":"Create, update, and delete routes.","wrap:manifest:self":"A server credential's (Connect a server) view of GET /v1/wrap/intercept-manifest and POST /v1/wrap/egress-observations. It answers only for the server the credential belongs to - the routes assigned to that server in the requested environment whose routes:invoke:id:\u003croute_id> scope the token holds - and never lists another server's routes or the workspace's. A server credential invokes routes with routes:invoke:id:\u003croute_id>, one route per scope, by the route's id (never re-used, unlike a slug).","secrets:read":"Read secret metadata. Does NOT include retrieving a live OAuth2 access token.","secrets:oauth_token":"Retrieve a live upstream OAuth2 access token (GET /v1/secrets/{id}/oauth2/token). Distinct from secrets:read because the call refreshes the credential at the provider.","secrets:write":"Create, update, and delete secrets.","vaults:detokenize":"Turn a vault token back into its original value. Required by GET /v1/vaults/{vault}/tokens/{token}, by a token template reference in a /v1/proxy body, and by creating a `detokenize` route action. Distinct from vaults:read, which lists vaults and token metadata and never returns a value.","transit:decrypt":"Open a portable `kc:` ciphertext with a tenant transit key. Required by creating a `decrypt` route action, which stores a standing instruction to open every matching field on every later request through that route. It is the same capability name the policy engine uses for POST /v1/decrypt. No routes scope satisfies it — managing a route is not permission to open the data flowing through it.","proxy:invoke":"Call the one-shot ephemeral proxy (any method on /v1/proxy). Required for EVERY verb — the proxy is one capability behind one handler, and a bodyless GET spends an escrowed credential exactly as a POST does. Neither proxy:read nor proxy:write satisfies it.","clients:read":"Read clients.","clients:write":"Manage clients.","webhooks:write":"Manage webhooks.","workflows:write":"Manage and execute workflows.","*:*":"Full access (all scopes)."}}},"scopes":[],"schemeName":"OAuth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"OAuth 2.1 authentication — recommended for new integrations. Access tokens\n(`kc_` prefix) are minted at the root-host token endpoint\n`https://api.knoxcall.com/oauth/token` and passed as `Authorization: Bearer \u003caccess_token>`.\nPublic clients must use PKCE with the `authorization_code` grant; confidential\nclients may use `client_credentials`. The first-party SDKs and the\n`knoxcall login` CLI handle token minting, caching, refresh, and DPoP for you.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth2","name":"Authorization"}],"title":"OAuth2"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Legacy long-lived API key authentication via the Authorization header.\nPass your API key as: `Authorization: Bearer tk_xxx_yyy`.\n\nStandard keys (`tk_` prefix) are accepted on `api.knoxcall.com`.\nTest keys (type=test) are accepted on `sandbox.knoxcall.com`.\nEnterprise Access Keys (`AKE` prefix) are accepted on both.\n\nFully supported, but prefer the `OAuth2` scheme (or the SDKs, which handle\nOAuth for you) for new integrations.\n","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Legacy long-lived API key authentication via the Authorization header.\nPass your API key as: `Authorization: Bearer tk_xxx_yyy`.\n\nStandard keys (`tk_` prefix) are accepted on `api.knoxcall.com`.\nTest keys (type=test) are accepted on `sandbox.knoxcall.com`.\nEnterprise Access Keys (`AKE` prefix) are accepted on both.\n\nFully supported, but prefer the `OAuth2` scheme (or the SDKs, which handle\nOAuth for you) for new integrations.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Legacy API key authentication via the `x-api-key` header.\nThis is an alternative to Bearer token authentication for clients that cannot\nset the `Authorization` header. Prefer the `OAuth2` scheme for new integrations.\n","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"Legacy API key authentication via the `x-api-key` header.\nThis is an alternative to Bearer token authentication for clients that cannot\nset the `Authorization` header. Prefer the `OAuth2` scheme for new integrations.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"knoxcall","siteName":"KnoxCall Docs","title":"Update an MCP Server - KnoxCall Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-18T04:25:19.171Z","originalFileLocation":"api-reference/ai-gateway/mcp-servers-update.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Change a server\u0026#x27;s upstream, tool allowlist, PII inspection or auth mode.\">\u003cmeta data-mint-head name=\"application-name\" content=\"KnoxCall Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update an MCP Server - KnoxCall Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Change a server\u0026#x27;s upstream, tool allowlist, PII inspection or auth mode.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KnoxCall Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://knoxcall.mintlify.site/_mintlify/api/og/v2?division=AI+Gateway\u0026amp;title=Update+an+MCP+Server\u0026amp;description=Change+a+server%27s+upstream%2C+tool+allowlist%2C+PII+inspection+or+auth+mode.\u0026amp;theme=458e28fcdf805b9f0fa7d95d\u0026amp;signature=854aba148d41409d772f3bb419cab4ef38271150f1a5b68c2abaf000fc1c2806\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update an MCP Server - KnoxCall Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Change a server\u0026#x27;s upstream, tool allowlist, PII inspection or auth mode.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://knoxcall.mintlify.site/_mintlify/api/og/v2?division=AI+Gateway\u0026amp;title=Update+an+MCP+Server\u0026amp;description=Change+a+server%27s+upstream%2C+tool+allowlist%2C+PII+inspection+or+auth+mode.\u0026amp;theme=458e28fcdf805b9f0fa7d95d\u0026amp;signature=854aba148d41409d772f3bb419cab4ef38271150f1a5b68c2abaf000fc1c2806\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/knoxcall/_IxzHxtMRMl0O6k0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KnoxCall Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18181B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ai-gateway/mcp-servers-update.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.knoxcall.com/#organization\",\"name\":\"KnoxCall Docs\",\"url\":\"https://docs.knoxcall.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/knoxcall/Hani9qeqybFGCQd1/logo/light.svg?fit=max\u0026auto=format\u0026n=Hani9qeqybFGCQd1\u0026q=85\u0026s=b6279c9a774c9ff9c8a87d6ac0065b14\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.knoxcall.com#website\",\"name\":\"KnoxCall Docs\",\"url\":\"https://docs.knoxcall.com\",\"publisher\":{\"@id\":\"https://docs.knoxcall.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update#webpage\",\"url\":\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update\",\"name\":\"Update an MCP Server\",\"description\":\"Change a server's upstream, tool allowlist, PII inspection or auth mode.\",\"dateModified\":\"2026-09-18T04:25:19.171Z\",\"isPartOf\":{\"@id\":\"https://docs.knoxcall.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI Gateway\",\"item\":\"https://docs.knoxcall.com/api-reference/ai-gateway/execute\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update an MCP Server\",\"item\":\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update#apireference\",\"headline\":\"Update an MCP Server\",\"name\":\"Update an MCP Server\",\"description\":\"Change a server's upstream, tool allowlist, PII inspection or auth mode.\",\"url\":\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.knoxcall.com/api-reference/ai-gateway/mcp-servers-update#webpage\"},\"dateModified\":\"2026-09-18T04:25:19.171Z\",\"publisher\":{\"@id\":\"https://docs.knoxcall.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.knoxcall.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"KnoxCall Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"KnoxCall Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/ai-gateway/mcp-servers-update.md","siteName":"KnoxCall Docs","nav":{"global":{"anchors":[{"anchor":"Support","icon":"headset","href":"https://knoxcall.com"},{"anchor":"Community","icon":"message-circle","href":"https://discord.knoxcall.com"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Overview","icon":"book","pages":[{"title":"API Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors","href":"/api-reference/errors"},{"title":"The KnoxCall Response Block","href":"/api-reference/response-metadata"},{"title":"Request Headers KnoxCall Does Not Forward","href":"/api-reference/request-headers"},{"title":"Rate Limits","href":"/api-reference/rate-limits"},{"title":"Idempotency","href":"/api-reference/idempotency"},{"title":"Versioning","href":"/api-reference/versioning"},{"title":"SCIM 2.0 Provisioning","href":"/api-reference/scim"}]},{"group":"Workload Identity","icon":"id-badge","pages":[{"title":"GitHub Actions","href":"/api-reference/workload-identity/github-actions"},{"title":"Google Cloud (GCE, GKE, Cloud Run, Cloud Functions)","href":"/api-reference/workload-identity/gcp"},{"title":"AWS (Lambda, ECS, EC2, IRSA)","href":"/api-reference/workload-identity/aws"},{"title":"Azure (Functions, App Service, AKS, VMs)","href":"/api-reference/workload-identity/azure"},{"title":"Kubernetes (self-managed, EKS, GKE, AKS)","href":"/api-reference/workload-identity/kubernetes"},{"title":"HCP Terraform","href":"/api-reference/workload-identity/hcp-terraform"},{"title":"Vercel","href":"/api-reference/workload-identity/vercel"}]},{"group":"Routes","icon":"route","pages":[{"title":"List Routes","href":"/api-reference/routes/list"},{"title":"Get Route","href":"/api-reference/routes/get"},{"title":"Create Route","href":"/api-reference/routes/create"},{"title":"Update Route","href":"/api-reference/routes/update"},{"title":"Delete Route","href":"/api-reference/routes/delete"},{"title":"Get Route Logs","href":"/api-reference/routes/logs"},{"title":"Route Environments","href":"/api-reference/routes/environments"}]},{"group":"Secrets","icon":"key","pages":[{"title":"List Secrets","href":"/api-reference/secrets/list"},{"title":"Get Secret","href":"/api-reference/secrets/get"},{"title":"Create Secret","href":"/api-reference/secrets/create"},{"title":"Create OAuth2 Secret","href":"/api-reference/secrets/create-oauth2"},{"title":"Create Certificate Secret","href":"/api-reference/secrets/create-certificate"},{"title":"Update Secret Metadata","href":"/api-reference/secrets/update"},{"title":"Update Secret Value","href":"/api-reference/secrets/update-value"},{"title":"Delete Secret","href":"/api-reference/secrets/delete"},{"title":"Get OAuth2 Access Token","href":"/api-reference/secrets/oauth2-token"}]},{"group":"Clients","icon":"users","pages":[{"title":"List Clients","href":"/api-reference/clients/list"},{"title":"Get Client","href":"/api-reference/clients/get"},{"title":"Create Client","href":"/api-reference/clients/create"},{"title":"Update Client","href":"/api-reference/clients/update"},{"title":"Delete Client","href":"/api-reference/clients/delete"},{"title":"Client Credentials","href":"/api-reference/clients/credentials"}]},{"group":"Environments","icon":"layers","pages":[{"title":"List Environments","href":"/api-reference/environments/list"},{"title":"Create Environment","href":"/api-reference/environments/create"},{"title":"Update Environment","href":"/api-reference/environments/update"},{"title":"Delete Environment","href":"/api-reference/environments/delete"}]},{"group":"API Keys","icon":"key-round","pages":[{"title":"List API Keys","href":"/api-reference/api-keys/list"},{"title":"Create API Key","href":"/api-reference/api-keys/create"},{"title":"Revoke API Key","href":"/api-reference/api-keys/revoke"},{"title":"List Roles","href":"/api-reference/api-keys/roles"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"List Webhooks","href":"/api-reference/webhooks/list"},{"title":"Get Webhook","href":"/api-reference/webhooks/get"},{"title":"Create Webhook","href":"/api-reference/webhooks/create"},{"title":"Update Webhook","href":"/api-reference/webhooks/update"},{"title":"Delete Webhook","href":"/api-reference/webhooks/delete"},{"title":"Get Webhook Logs","href":"/api-reference/webhooks/logs"},{"title":"List Event Types","href":"/api-reference/webhooks/event-types"},{"title":"Test Webhook","href":"/api-reference/webhooks/test"}]},{"group":"Ephemeral Proxy","icon":"zap","pages":[{"title":"Invoke Ephemeral Proxy","href":"/api-reference/ephemeral-proxy/invoke"}]},{"group":"AI Gateway","icon":"bot","pages":[{"title":"Execute AI Request","openapi":"POST /v1/ai/{agentSlug}/{upstreamPath}","href":"/api-reference/ai-gateway/execute"},{"title":"Control Plane (v1)","href":"/api-reference/ai-gateway/control-plane-overview"},{"title":"Gateways (v1)","href":"/api-reference/ai-gateway/gateways"},{"title":"Agents (v1)","href":"/api-reference/ai-gateway/agents"},{"title":"Tokens (v1)","href":"/api-reference/ai-gateway/tokens"},{"title":"Usage \u0026 Cost (v1)","openapi":"GET /ai-gateway/usage","href":"/api-reference/ai-gateway/usage"},{"title":"List Gateways","openapi":"GET /ai-gateway/gateways","href":"/api-reference/ai-gateway/gateways-list"},{"title":"Create Gateway","openapi":"POST /ai-gateway/gateways","href":"/api-reference/ai-gateway/gateways-create"},{"title":"Get Gateway","openapi":"GET /ai-gateway/gateways/{id}","href":"/api-reference/ai-gateway/gateways-get"},{"title":"Update Gateway","openapi":"PATCH /ai-gateway/gateways/{id}","href":"/api-reference/ai-gateway/gateways-update"},{"title":"Archive Gateway","openapi":"DELETE /ai-gateway/gateways/{id}","href":"/api-reference/ai-gateway/gateways-delete"},{"title":"Create Agent","openapi":"POST /ai-gateway/gateways/{gatewayId}/agents","href":"/api-reference/ai-gateway/agents-create"},{"title":"List Agents","openapi":"GET /ai-gateway/gateways/{gatewayId}/agents","href":"/api-reference/ai-gateway/agents-list"},{"title":"Get Agent","openapi":"GET /ai-gateway/agents/{id}","href":"/api-reference/ai-gateway/agents-get"},{"title":"Update Agent","openapi":"PATCH /ai-gateway/agents/{id}","href":"/api-reference/ai-gateway/agents-update"},{"title":"Archive Agent","openapi":"DELETE /ai-gateway/agents/{id}","href":"/api-reference/ai-gateway/agents-delete"},{"title":"List Phantom Tokens","openapi":"GET /ai-gateway/agents/{agentId}/tokens","href":"/api-reference/ai-gateway/tokens-list"},{"title":"Mint Phantom Token","openapi":"POST /ai-gateway/agents/{agentId}/tokens","href":"/api-reference/ai-gateway/tokens-mint"},{"title":"Revoke Phantom Token","openapi":"DELETE /ai-gateway/agents/{agentId}/tokens/{tokenId}","href":"/api-reference/ai-gateway/tokens-revoke"},{"title":"Workload Token Exchange","href":"/api-reference/ai-gateway/oauth-token"},{"title":"List Gateway Tokens","openapi":"GET /ai-gateway/gateways/{gatewayId}/tokens","href":"/api-reference/ai-gateway/gateway-tokens-list"},{"title":"Revoke a Gateway Token","openapi":"DELETE /ai-gateway/gateways/{gatewayId}/tokens/{tokenId}","href":"/api-reference/ai-gateway/gateway-tokens-revoke"},{"title":"List Firewall Policies","openapi":"GET /ai-gateway/firewall-policies","href":"/api-reference/ai-gateway/firewall-policies-list"},{"title":"Create a Firewall Policy","openapi":"POST /ai-gateway/firewall-policies","href":"/api-reference/ai-gateway/firewall-policies-create"},{"title":"Test Firewall Rules","openapi":"POST /ai-gateway/firewall-policies/test","href":"/api-reference/ai-gateway/firewall-policies-test"},{"title":"Get a Firewall Policy","openapi":"GET /ai-gateway/firewall-policies/{id}","href":"/api-reference/ai-gateway/firewall-policies-get"},{"title":"Update a Firewall Policy","openapi":"PATCH /ai-gateway/firewall-policies/{id}","href":"/api-reference/ai-gateway/firewall-policies-update"},{"title":"Delete a Firewall Policy","openapi":"DELETE /ai-gateway/firewall-policies/{id}","href":"/api-reference/ai-gateway/firewall-policies-delete"},{"title":"List MCP Servers","openapi":"GET /ai-gateway/gateways/{gatewayId}/mcp-servers","href":"/api-reference/ai-gateway/mcp-servers-list"},{"title":"Create an MCP Server","openapi":"POST /ai-gateway/gateways/{gatewayId}/mcp-servers","href":"/api-reference/ai-gateway/mcp-servers-create"},{"title":"Get an MCP Server","description":"Read one MCP server, without its upstream credential.","openapi":"GET /ai-gateway/mcp-servers/{id}","href":"/api-reference/ai-gateway/mcp-servers-get"},{"title":"Update an MCP Server","openapi":"PATCH /ai-gateway/mcp-servers/{id}","href":"/api-reference/ai-gateway/mcp-servers-update"},{"title":"Archive an MCP Server","description":"Take an MCP server out of service.","openapi":"DELETE /ai-gateway/mcp-servers/{id}","href":"/api-reference/ai-gateway/mcp-servers-delete"},{"title":"List MCP Tools","openapi":"GET /ai-gateway/mcp-servers/{id}/tools","href":"/api-reference/ai-gateway/mcp-tools-list"},{"title":"Add or Replace an MCP Tool","openapi":"POST /ai-gateway/mcp-servers/{id}/tools","href":"/api-reference/ai-gateway/mcp-tools-upsert"},{"title":"Update an MCP Tool","openapi":"PATCH /ai-gateway/mcp-servers/{id}/tools/{toolId}","href":"/api-reference/ai-gateway/mcp-tools-update"},{"title":"Delete an MCP Tool","openapi":"DELETE /ai-gateway/mcp-servers/{id}/tools/{toolId}","href":"/api-reference/ai-gateway/mcp-tools-delete"},{"title":"List MCP Connections","openapi":"GET /ai-gateway/mcp-servers/{id}/grants","href":"/api-reference/ai-gateway/mcp-grants-list"},{"title":"Revoke an MCP Connection","openapi":"DELETE /ai-gateway/mcp-servers/{id}/grants/{grantId}","href":"/api-reference/ai-gateway/mcp-grants-revoke"},{"title":"Revoke All MCP Connections","openapi":"DELETE /ai-gateway/mcp-servers/{id}/grants","href":"/api-reference/ai-gateway/mcp-grants-revoke-all"},{"title":"Export Usage (CSV)","openapi":"GET /ai-gateway/usage/export","href":"/api-reference/ai-gateway/usage-export"},{"title":"List PII Policies","openapi":"GET /ai-gateway/pii-policies","href":"/api-reference/ai-gateway/pii-policies-list"},{"title":"Create a PII Policy","openapi":"POST /ai-gateway/pii-policies","href":"/api-reference/ai-gateway/pii-policies-create"},{"title":"Get a PII Policy","openapi":"GET /ai-gateway/pii-policies/{id}","href":"/api-reference/ai-gateway/pii-policies-get"},{"title":"Update a PII Policy","openapi":"PATCH /ai-gateway/pii-policies/{id}","href":"/api-reference/ai-gateway/pii-policies-update"},{"title":"Delete a PII Policy","openapi":"DELETE /ai-gateway/pii-policies/{id}","href":"/api-reference/ai-gateway/pii-policies-delete"},{"title":"List PII Recognizers","openapi":"GET /ai-gateway/pii-recognizers","href":"/api-reference/ai-gateway/pii-recognizers-list"},{"title":"Create a PII Recognizer","openapi":"POST /ai-gateway/pii-recognizers","href":"/api-reference/ai-gateway/pii-recognizers-create"},{"title":"Test a Recognizer Pattern","openapi":"POST /ai-gateway/pii-recognizers/test","href":"/api-reference/ai-gateway/pii-recognizers-test"},{"title":"Get a PII Recognizer","openapi":"GET /ai-gateway/pii-recognizers/{id}","href":"/api-reference/ai-gateway/pii-recognizers-get"},{"title":"Update a PII Recognizer","openapi":"PATCH /ai-gateway/pii-recognizers/{id}","href":"/api-reference/ai-gateway/pii-recognizers-update"},{"title":"Delete a PII Recognizer","openapi":"DELETE /ai-gateway/pii-recognizers/{id}","href":"/api-reference/ai-gateway/pii-recognizers-delete"}]},{"group":"Audit Logs","icon":"file-text","pages":[{"title":"List Audit Logs","href":"/api-reference/audit-logs/list"},{"title":"SHA-256 Hash Chain — Critical Audit Chain","href":"/api-reference/audit-logs/chain"}]},{"group":"Account","icon":"building","pages":[{"title":"Get Account Info","href":"/api-reference/account/get"},{"title":"Get Current Usage","href":"/api-reference/account/usage"}]},{"group":"Tenant KMS","icon":"shield-check","pages":[{"title":"Onboard / Configure KMS","href":"/api-reference/tenant-kms/onboard"},{"title":"Get KMS Status","href":"/api-reference/tenant-kms/status"},{"title":"Unseal","href":"/api-reference/tenant-kms/unseal"},{"title":"Rotate Master Key","href":"/api-reference/tenant-kms/rotate"},{"title":"Revert to Operator-Managed Key","href":"/api-reference/tenant-kms/revert"},{"title":"Error Reference","href":"/api-reference/tenant-kms/errors"}]},{"group":"Secret Store Migrations","icon":"arrow-right-left","pages":[{"title":"List Migrations","href":"/api-reference/migrations/list"},{"title":"Create Migration","href":"/api-reference/migrations/create"},{"title":"Get Migration","href":"/api-reference/migrations/get"},{"title":"Cancel Migration","href":"/api-reference/migrations/cancel"},{"title":"Reveal Item Value","href":"/api-reference/migrations/items-reveal"},{"title":"Approve Migration Item","href":"/api-reference/migrations/items-approve"},{"title":"Reject Migration Item","href":"/api-reference/migrations/items-reject"},{"title":"Commit Migration","href":"/api-reference/migrations/commit"},{"title":"Verification Events","href":"/api-reference/migrations/verification-events"},{"title":"DB Proxy Routes","href":"/api-reference/migrations/db-proxy-routes"}]},{"group":"Changelog","icon":"history","pages":[{"title":"Changelog","href":"/api-reference/changelog"}]}]}]},"basePath":"","title":"Update an MCP Server - KnoxCall Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}