Only include optional fields (slug, description, configurations) when you have values for them. The example and code samples show required fields plus workspace_id and organisation_id when scoping.
Dynamically resolve secrets from secret references at runtime. Valid target_field values are "configurations." (e.g. "configurations.oauth_metadata"). Each target_field must be unique.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Portkey (Prisma AIRS AI Gateway) Docs","description":"Comprehensive documentation for AI Gateway, Guardrails, Observability, and Governance features.","colors":{"primary":"#0891B2","light":"#0891B2","dark":"#0891B2"},"logo":{"light":"https://mintcdn.com/portkey-docs/tHk-hgNjLbEj4dhh/images/portkey-PANW-company-logo-positive.png?fit=max\u0026auto=format\u0026n=tHk-hgNjLbEj4dhh\u0026q=85\u0026s=c5fb09014ff79616583b1d3bffe27450","dark":"https://mintcdn.com/portkey-docs/tHk-hgNjLbEj4dhh/images/portkey-PANW-company-logo-negative.png?fit=max\u0026auto=format\u0026n=tHk-hgNjLbEj4dhh\u0026q=85\u0026s=6025ca49ef544522f58ff471b7f75f8f"},"favicon":"https://mintcdn.com/portkey-docs/Hf1XgyjG_b79ym4Q/favicon.png?fit=max\u0026auto=format\u0026n=Hf1XgyjG_b79ym4Q\u0026q=85\u0026s=cbaa1bfc49bb6e3fd6cf499a5da313a3","api":{"openapi":"https://raw.githubusercontent.com/Portkey-AI/openapi/refs/heads/master/openapi.yaml","examples":{"prefill":true},"url":"full"},"navbar":{"links":[{"href":"https://portkey.ai/models","label":"Models"},{"href":"https://support.portkey.ai/forms/customer-portal-ticket-form","label":"Support"},{"href":"https://www.paloaltonetworks.in/ai-security/ai-gateway?utm_source=portkey\u0026utm_medium=referral\u0026utm_campaign=prisma_airs\u0026utm_content=docs_nav#contact","label":"Contact Us"}],"primary":{"type":"button","label":"Sign in","href":"https://stratacloudmanager.paloaltonetworks.com/"}},"footer":{"socials":{"x":"https://twitter.com/PortkeyAI","linkedin":"https://www.linkedin.com/company/portkey-ai","github":"https://git.new/portkey"},"links":[{"header":"For LLMs","items":[{"label":"llms.txt","href":"https://portkey.ai/docs/llms.txt"},{"label":"llms-full.txt","href":"https://portkey.ai/docs/llms-full.txt"}]},{"header":"Products","items":[{"label":"Observability","href":"https://portkey.ai/features/observability"},{"label":"AI Gateway","href":"https://portkey.ai/features/ai-gateway"},{"label":"Guardrails","href":"https://portkey.ai/features/guardrails"},{"label":"Prompt Management","href":"https://portkey.ai/features/prompt-management"},{"label":"Agents","href":"https://portkey.ai/features/agents"},{"label":"MCP Gateway","href":"https://portkey.ai/docs/product/mcp-gateway"},{"label":"Security","href":"https://portkey.ai/features/security-and-compliance"},{"label":"Auto-Instrumentation","href":"https://portkey.ai/features/auto-instrumentation"}]},{"header":"Resources","items":[{"label":"API Status","href":"https://status.portkey.ai/"},{"label":"Helm Charts","href":"https://github.com/portkey-ai/helm"},{"label":"AI Grants Finder","href":"https://grantsfinder.portkey.ai/"},{"label":"Events Calendar","href":"https://lu.ma/portkey"},{"label":"Blog","href":"https://portkey.ai/blog"},{"label":"Error Library","href":"https://portkey.ai/error-library"},{"label":"Models \u0026 Pricing","href":"https://portkey.ai/models"}]},{"header":"Company","items":[{"label":"Pricing","href":"https://portkey.ai/pricing"},{"label":"Compliances","href":"https://trust.portkey.ai/"},{"label":"Privacy Policy","href":"https://portkey.ai/privacy-policy"},{"label":"Terms of Service","href":"https://portkey.ai/terms"},{"label":"DPA","href":"https://portkey.ai/dpa"},{"label":"Cookie Policy","href":"https://portkey.ai/cookie-policy"}]}]},"seo":{"metatags":{"og:type":"website","og:site_name":"Portkey AI Gateway Docs"},"indexing":"navigable"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":true},"integrations":{"ga4":{"measurementId":"G-JJMXYE4DRL"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"toc"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"portkey-docs","hasAudioNarration":false,"actualSubdomain":"portkey-docs","customDomains":["docs.portkey.ai","portkey.ai"],"gitSource":{"type":"github","owner":"portkey-ai","repo":"docs-core","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aea1fd4382c567ac457aa17","collectionId":"0c4de925-cec6-446b-9681-011c6b4a9b91","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aea1fd4382c567ac457aa17"},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aea1fd4382c567ac457aa17","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Integrations","count":699},{"language":"default","tag":"Product","count":386},{"language":"default","tag":"Docs","count":324},{"language":"default","tag":"LLM Integrations","count":307},{"language":"default","tag":"Admin APIs","count":189},{"language":"default","tag":"More","count":176},{"language":"default","tag":"Guardrails","count":102},{"language":"default","tag":"Administration","count":102},{"language":"default","tag":"AI Gateway","count":99},{"language":"default","tag":"Admin API","count":95}],"searchSettings":{"isFiltersEnabled":true,"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@portkey.ai","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#banner{background:linear-gradient(90deg,#0d1b2e 0,#1a1040 40%,#2d0f22 100%);border-bottom:1px solid rgba(255,255,255,.08)}#banner a{color:#f0f0f0;text-decoration:none;font-weight:600;border-bottom:1px solid rgba(240,240,240,.5);padding-bottom:1px;transition:border-color .2s ease}#banner a:hover{border-bottom-color:#fff}"}],"page":{"pagePath":"api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration","slug":"/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration","pageMetadata":{"title":"Create MCP Integration","openapi":"post /mcp-integrations","description":"","href":"/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration"},"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={hr:`hr`,p:`p`,..._provideComponents(),...props.components},{Card}=_components;if(!Card)_missingMdxReference(`Card`,true);return _jsxs(_Fragment,{children:[_jsx(_components.hr,{}),`\n`,_jsx(Card,{title:`Portkey is now PRISMA AIRS AI Gateway. See it in action.`,href:`https://www.paloaltonetworks.in/ai-security/ai-gateway?utm_source=portkey\u0026utm_medium=referral\u0026utm_campaign=prisma_airs\u0026utm_content=docs_nav#contact`,icon:`arrow-up-right-from-square`,children:_jsx(_components.p,{children:`Contact Us`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Create MCP Integration","openapi":"post /mcp-integrations","description":"","href":"/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"McpIntegrations_create","tags":["MCP Integrations"],"summary":"Create MCP Integration","description":"Create a new MCP Integration. Requires either organisation_id (with admin API key) or workspace_id in body.","requestBody":"1da01341-fdfb-42ed-84a5-bc8f34e6bb1d","responses":{"200":"f1f885a2-34f3-4bc6-b028-bc5f2a68354c"},"method":"post","type":"path","servers":["ff072cb7-6ccf-44ed-8c6c-6eabd9231b46","1dab2499-4282-4fd5-a0c7-4f77739d2b11"],"security":["a32f564e-fd72-4d2a-b003-4f8f62227a26"],"path":"/mcp-integrations","baseUrlOptions":["https://api.portkey.ai/v1","SELF_HOSTED_CONTROL_PLANE_URL"],"title":"Create MCP Integration","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.name":"My MCP Server","body.url":"https://mcp.example.com/mcp","body.auth_type":"none","body.transport":"http"}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Only include optional fields (slug, description, configurations) when you have values for them. The example and code samples show required fields plus workspace_id and organisation_id when scoping.","required":["name","url","auth_type","transport"],"properties":{"name":{"type":"string","description":"Display name of the MCP integration","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"MCP server URL","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"auth_type":{"type":"string","enum":["oauth_auto","headers","none"],"isRequired":true,"uniqueKey":"auth_type","typeLabel":"enum\u003cstring>"},"transport":{"type":"string","enum":["http","sse"],"isRequired":true,"uniqueKey":"transport","typeLabel":"enum\u003cstring>"},"organisation_id":{"type":"string","format":"uuid","description":"Organisation ID (optional; required when using org admin API key without workspace_id)","uniqueKey":"organisation_id","typeLabel":"string\u003cuuid>"},"workspace_id":{"type":"string","format":"uuid","description":"Workspace ID (optional; to create at workspace level)","uniqueKey":"workspace_id","typeLabel":"string\u003cuuid>"},"slug":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Optional slug; must be unique within organisation","uniqueKey":"slug","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"},"configurations":{"type":"object","description":"Auth/config key-value pairs (e.g. headers, client credentials)","properties":{"custom_headers":{"type":"object","additionalProperties":true,"description":"Custom headers to send to the MCP server.","example":{"Authorization":"Bearer some-token","x-foo":"bar"},"uniqueKey":"configurations.custom_headers","typeLabel":"object"},"passthrough_header":{"type":"object","additionalProperties":true,"description":"Headers to pass through from the incoming request to the MCP server.","example":{"x-user-id":{"type":"string","example":"abc123"},"x-request-id":{"type":"string","example":"req-0001"}},"uniqueKey":"configurations.passthrough_header","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"configurations","typeLabel":"object"},"secret_mappings":{"type":"array","items":{"type":"object","required":["target_field","secret_reference_id"],"properties":{"target_field":{"type":"string","description":"The field on the entity to populate from the secret reference. Must be unique within the array.\n- **Integrations**: `key` or `configurations.\u003cfield>` (e.g. `configurations.aws_secret_access_key`)\n- **Virtual Keys**: `key` or `model_config.\u003cfield>` (e.g. `model_config.awsSecretAccessKey`)\n- **MCP Integrations**: `configurations.\u003cfield>` (e.g. `configurations.oauth_metadata`)\n","example":"key","isRequired":true,"uniqueKey":"secret_mappings.items.[INDEX].target_field","typeLabel":"string"},"secret_reference_id":{"type":"string","description":"UUID or slug of the secret reference. Must belong to the same organisation and be accessible by the workspace.","example":"my-aws-secret","isRequired":true,"uniqueKey":"secret_mappings.items.[INDEX].secret_reference_id","typeLabel":"string"},"secret_key":{"oneOf":[{"type":"string","description":"Override the secret_key defined on the secret reference. Use to pick a specific key from a multi-value secret.","uniqueKey":"secret_mappings.items.[INDEX].secret_key.oneOf.0","typeLabel":"string"},{"type":"null","description":"Override the secret_key defined on the secret reference. Use to pick a specific key from a multi-value secret.","uniqueKey":"secret_mappings.items.[INDEX].secret_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"secret_mappings.items.[INDEX].secret_key","typeLabel":"string | null"},"value_format":{"oneOf":[{"type":"string","enum":["json","string"],"description":"Format of the secret value.\n- `string`: The secret value is treated as a plain string.\n- `json`: The secret value is parsed as JSON before being applied to the target field. Use this when the target field expects a structured object (e.g. `configurations.oauth_metadata`).\n","example":"json","uniqueKey":"secret_mappings.items.[INDEX].value_format.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["json","string"],"description":"Format of the secret value.\n- `string`: The secret value is treated as a plain string.\n- `json`: The secret value is parsed as JSON before being applied to the target field. Use this when the target field expects a structured object (e.g. `configurations.oauth_metadata`).\n","example":"json","uniqueKey":"secret_mappings.items.[INDEX].value_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"secret_mappings.items.[INDEX].value_format","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"secret_mappings.items.[INDEX]","typeLabel":"object"},"description":"Dynamically resolve secrets from secret references at runtime. Valid target_field values are \"configurations.\u003cfield>\" (e.g. \"configurations.oauth_metadata\"). Each target_field must be unique.","uniqueKey":"secret_mappings","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"default":{"title":"default","value":{"name":"My MCP Server","url":"https://mcp.example.com/mcp","auth_type":"none","transport":"http"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f1f885a2-34f3-4bc6-b028-bc5f2a68354c":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"slug":{"type":"string","uniqueKey":"slug","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","slug":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a32f564e-fd72-4d2a-b003-4f8f62227a26":{"Portkey-Key":{"type":"apiKey","in":"header","name":"x-portkey-api-key","scopes":[],"schemeName":"Portkey-Key"}}},"servers":{"ff072cb7-6ccf-44ed-8c6c-6eabd9231b46":{"url":"https://api.portkey.ai/v1","description":"Portkey API Public Endpoint"},"1dab2499-4282-4fd5-a0c7-4f77739d2b11":{"url":"SELF_HOSTED_CONTROL_PLANE_URL","description":"Self-Hosted Control Plane URL"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-portkey-api-key","scopes":[],"schemeName":"Portkey-Key"},"schema":{"title":"x-portkey-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"Portkey-Key","name":"x-portkey-api-key"}],"title":"Portkey-Key"}]},"originalFileLocation":"https://raw.githubusercontent.com/Portkey-AI/openapi/refs/heads/master/openapi.yaml"},"subdomain":"portkey-docs","siteName":"Portkey (Prisma AIRS AI Gateway) Docs","title":"Create MCP Integration - Portkey (Prisma AIRS AI Gateway) Docs","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6aa971a20031bd0287c960ba","deploymentId":"67086365a151447bf2fa5021","questionText":"What are MCP integration requirements?","status":"active","generatedBy":"contextual","path":"api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration","createdAt":"2026-09-15T16:26:10.598Z","updatedAt":"2026-09-15T16:26:10.598Z","__v":0},{"_id":"6aa971a20031bd0287c960b8","deploymentId":"67086365a151447bf2fa5021","questionText":"How do I create an MCP integration?","status":"active","generatedBy":"contextual","path":"api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration","createdAt":"2026-09-15T16:26:10.598Z","updatedAt":"2026-09-15T16:26:10.598Z","__v":0},{"_id":"6aa971a20031bd0287c960b9","deploymentId":"67086365a151447bf2fa5021","questionText":"What is an MCP integration?","status":"active","generatedBy":"contextual","path":"api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration","createdAt":"2026-09-15T16:26:10.598Z","updatedAt":"2026-09-15T16:26:10.598Z","__v":0}],"navMaps":{"firstHrefInVersion":{"Latest":{"href":"/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration","matchLevel":0},"Prisma AIRS":{"href":"/aigw/introduction/welcome","matchLevel":4},"Virtual Keys (Deprecated)":{"href":"/virtual_key_old/introduction/what-is-portkey","matchLevel":4}},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration.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=\"system\"}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=\"application-name\" content=\"Portkey (Prisma AIRS AI Gateway) Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_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=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create MCP Integration - Portkey (Prisma AIRS AI Gateway) Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Portkey AI Gateway Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://portkey-docs.mintlify.app/_mintlify/api/og/v2?division=MCP+Integrations\u0026amp;title=Create+MCP+Integration\u0026amp;theme=262137c9f2583e48984715e7\u0026amp;signature=f9c1fbd73abfe22d4e671241ef467208fe05462050cf9061fbb8a968a55ae72e\">\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=\"Create MCP Integration - Portkey (Prisma AIRS AI Gateway) Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://portkey-docs.mintlify.app/_mintlify/api/og/v2?division=MCP+Integrations\u0026amp;title=Create+MCP+Integration\u0026amp;theme=262137c9f2583e48984715e7\u0026amp;signature=f9c1fbd73abfe22d4e671241ef467208fe05462050cf9061fbb8a968a55ae72e\">\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=\"/docs/mintlify-assets/_mintlify/favicons/portkey-docs/9Whrk-8bCE6hyGSn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Portkey (Prisma AIRS AI Gateway) Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0891B2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.portkey.ai/#organization\",\"name\":\"Portkey (Prisma AIRS AI Gateway) Docs\",\"url\":\"https://docs.portkey.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/portkey-docs/tHk-hgNjLbEj4dhh/images/portkey-PANW-company-logo-positive.png?fit=max\u0026auto=format\u0026n=tHk-hgNjLbEj4dhh\u0026q=85\u0026s=c5fb09014ff79616583b1d3bffe27450\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.portkey.ai/docs#website\",\"name\":\"Portkey (Prisma AIRS AI Gateway) Docs\",\"url\":\"https://docs.portkey.ai/docs\",\"publisher\":{\"@id\":\"https://docs.portkey.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration#webpage\",\"url\":\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration\",\"name\":\"Create MCP Integration\",\"isPartOf\":{\"@id\":\"https://docs.portkey.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Portkey (Prisma AIRS AI Gateway) Docs\",\"item\":\"https://docs.portkey.ai/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create MCP Integration\",\"item\":\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration#apireference\",\"headline\":\"Create MCP Integration\",\"name\":\"Create MCP Integration\",\"url\":\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration\",\"mainEntityOfPage\":{\"@id\":\"https://docs.portkey.ai/docs/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration#webpage\"},\"publisher\":{\"@id\":\"https://docs.portkey.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.portkey.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Portkey (Prisma AIRS AI Gateway) Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Portkey (Prisma AIRS AI Gateway) Docs","nav":{"global":null,"versions":[{"version":"Latest","tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/introduction/what-is-portkey"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/ecosystem"}]},{"tab":"Gateway APIs","pages":[{"title":"Gateway APIs","href":"/api-reference/inference-api/introduction"}]},{"tab":"Admin APIs","groups":[{"group":"API Reference","pages":[{"title":"Introduction","href":"/api-reference/admin-api/introduction"},{"title":"Errors","href":"/api-reference/admin-api/error"}]},{"group":"Configs","pages":[{"title":"Create Config","openapi":"post /configs","href":"/api-reference/admin-api/control-plane/configs/create-config"},{"title":"List Configs","openapi":"get /configs","href":"/api-reference/admin-api/control-plane/configs/list-configs"},{"title":"Retrieve Config","openapi":"get /configs/{slug}","href":"/api-reference/admin-api/control-plane/configs/retrieve-config"},{"title":"List Config Versions","openapi":"get /configs/{slug}/versions","href":"/api-reference/admin-api/control-plane/configs/list-config-versions"},{"title":"Update Config","openapi":"put /configs/{slug}","href":"/api-reference/admin-api/control-plane/configs/update-config"},{"title":"Delete Config","openapi":"delete /configs/{slug}","href":"/api-reference/admin-api/control-plane/configs/delete-config"}]},{"group":"Integrations","pages":[{"title":"Create Integration","openapi":"post /integrations","href":"/api-reference/admin-api/control-plane/integrations/create-integration"},{"title":"List Integrations","openapi":"get /integrations","href":"/api-reference/admin-api/control-plane/integrations/list-integrations"},{"title":"Retrieve Integration","openapi":"get /integrations/{slug}","href":"/api-reference/admin-api/control-plane/integrations/retrieve-integration"},{"title":"Update Integration","openapi":"put /integrations/{slug}","href":"/api-reference/admin-api/control-plane/integrations/update-integration"},{"title":"Delete Integration","openapi":"delete /integrations/{slug}","href":"/api-reference/admin-api/control-plane/integrations/delete-integration"},{"group":"Model Access","pages":[{"title":"List Model Access","openapi":"get /integrations/{slug}/models","href":"/api-reference/admin-api/control-plane/integrations/models/list-model-access"},{"title":"Update Model Access","openapi":"put /integrations/{slug}/models","href":"/api-reference/admin-api/control-plane/integrations/models/update-model-access"},{"title":"Delete Custom Model","openapi":"delete /integrations/{slug}/models","href":"/api-reference/admin-api/control-plane/integrations/models/delete-custom-model"}]},{"group":"Workspace Access","pages":[{"title":"List Workspace Access","openapi":"get /integrations/{slug}/workspaces","href":"/api-reference/admin-api/control-plane/integrations/workspaces/list-workspace-access"},{"title":"Update Workspace Access","openapi":"put /integrations/{slug}/workspaces","description":"","href":"/api-reference/admin-api/control-plane/integrations/workspaces/update-workspace-access"}]}]},{"group":"MCP Integrations","pages":[{"title":"Create MCP Integration","openapi":"post /mcp-integrations","href":"/api-reference/admin-api/control-plane/mcp-integrations/create-mcp-integration"},{"title":"List MCP Integrations","openapi":"get /mcp-integrations","description":"","href":"/api-reference/admin-api/control-plane/mcp-integrations/list-mcp-integrations"},{"title":"Retrieve MCP Integration","openapi":"get /mcp-integrations/{mcpIntegrationId}","href":"/api-reference/admin-api/control-plane/mcp-integrations/retrieve-mcp-integration"},{"title":"Update MCP Integration","openapi":"put /mcp-integrations/{mcpIntegrationId}","href":"/api-reference/admin-api/control-plane/mcp-integrations/update-mcp-integration"},{"title":"Delete MCP Integration","openapi":"delete /mcp-integrations/{mcpIntegrationId}","href":"/api-reference/admin-api/control-plane/mcp-integrations/delete-mcp-integration"},{"group":"Workspaces","pages":[{"title":"List MCP Integration Workspaces","openapi":"get /mcp-integrations/{mcpIntegrationId}/workspaces","href":"/api-reference/admin-api/control-plane/mcp-integrations/workspaces/list-mcp-integration-workspaces"},{"title":"Update MCP Integration Workspaces","openapi":"put /mcp-integrations/{mcpIntegrationId}/workspaces","href":"/api-reference/admin-api/control-plane/mcp-integrations/workspaces/update-mcp-integration-workspaces"}]},{"group":"Capabilities","pages":[{"title":"List MCP Integration Capabilities","openapi":"get /mcp-integrations/{mcpIntegrationId}/capabilities","href":"/api-reference/admin-api/control-plane/mcp-integrations/capabilities/list-mcp-integration-capabilities"},{"title":"Update MCP Integration Capabilities","openapi":"put /mcp-integrations/{mcpIntegrationId}/capabilities","href":"/api-reference/admin-api/control-plane/mcp-integrations/capabilities/update-mcp-integration-capabilities"}]},{"title":"Retrieve MCP Integration Metadata","openapi":"get /mcp-integrations/{mcpIntegrationId}/metadata","href":"/api-reference/admin-api/control-plane/mcp-integrations/retrieve-mcp-integration-metadata"}]},{"group":"MCP Servers","pages":[{"title":"Create MCP Server","openapi":"post /mcp-servers","href":"/api-reference/admin-api/control-plane/mcp-servers/create-mcp-server"},{"title":"List MCP Servers","openapi":"get /mcp-servers","href":"/api-reference/admin-api/control-plane/mcp-servers/list-mcp-servers"},{"title":"Retrieve MCP Server","openapi":"get /mcp-servers/{mcpServerId}","href":"/api-reference/admin-api/control-plane/mcp-servers/retrieve-mcp-server"},{"title":"Update MCP Server","openapi":"put /mcp-servers/{mcpServerId}","href":"/api-reference/admin-api/control-plane/mcp-servers/update-mcp-server"},{"title":"Delete MCP Server","openapi":"delete /mcp-servers/{mcpServerId}","href":"/api-reference/admin-api/control-plane/mcp-servers/delete-mcp-server"},{"title":"Test MCP Server connection","openapi":"post /mcp-servers/{mcpServerId}/test","href":"/api-reference/admin-api/control-plane/mcp-servers/test-mcp-server"},{"group":"Capabilities","pages":[{"title":"List MCP Server capabilities","openapi":"get /mcp-servers/{mcpServerId}/capabilities","href":"/api-reference/admin-api/control-plane/mcp-servers/capabilities/list-mcp-server-capabilities"},{"title":"Bulk update MCP Server capability overrides","openapi":"put /mcp-servers/{mcpServerId}/capabilities","href":"/api-reference/admin-api/control-plane/mcp-servers/capabilities/bulk-update-mcp-server-capabilities"}]},{"group":"User Access","pages":[{"title":"List MCP Server user access","openapi":"get /mcp-servers/{mcpServerId}/user-access","href":"/api-reference/admin-api/control-plane/mcp-servers/user-access/list-mcp-server-user-access"},{"title":"Bulk update MCP Server user access","openapi":"put /mcp-servers/{mcpServerId}/user-access","href":"/api-reference/admin-api/control-plane/mcp-servers/user-access/bulk-update-mcp-server-user-access"}]},{"group":"Connections","pages":[{"title":"List MCP Server Connections","openapi":"get /mcp-servers/{mcpServerId}/connections","href":"/api-reference/admin-api/control-plane/mcp-servers/connections/list-mcp-server-connections"},{"title":"Delete MCP Server Connection","openapi":"delete /mcp-servers/{mcpServerId}/connections","href":"/api-reference/admin-api/control-plane/mcp-servers/connections/delete-mcp-server-connection"}]}]},{"group":"Providers","pages":[{"title":"Create Provider","openapi":"post /providers","href":"/api-reference/admin-api/control-plane/providers/create-provider"},{"title":"List Providers","openapi":"get /providers","href":"/api-reference/admin-api/control-plane/providers/list-providers"},{"title":"Retrieve Provider","openapi":"get /providers/{slug}","href":"/api-reference/admin-api/control-plane/providers/retrieve-provider"},{"title":"Update Provider","openapi":"put /providers/{slug}","href":"/api-reference/admin-api/control-plane/providers/update-provider"},{"title":"Delete Provider","openapi":"delete /providers/{slug}","href":"/api-reference/admin-api/control-plane/providers/delete-provider"}]},{"group":"Virtual Keys","pages":[{"title":"Create Virtual Key","openapi":"post /virtual-keys","href":"/api-reference/admin-api/control-plane/virtual-keys/create-virtual-key"},{"title":"List Virtual Key","openapi":"get /virtual-keys","href":"/api-reference/admin-api/control-plane/virtual-keys/list-virtual-keys"},{"title":"Retrieve Virtual Key","openapi":"get /virtual-keys/{slug}","href":"/api-reference/admin-api/control-plane/virtual-keys/retrieve-virtual-key"},{"title":"Update Virtual Key","openapi":"put /virtual-keys/{slug}","href":"/api-reference/admin-api/control-plane/virtual-keys/update-virtual-key"},{"title":"Delete Virtual Key","openapi":"delete /virtual-keys/{slug}","href":"/api-reference/admin-api/control-plane/virtual-keys/delete-virtual-key"}]},{"group":"Prompts","pages":[{"title":"Create Prompt","openapi":"post /prompts","href":"/api-reference/admin-api/control-plane/prompts/create-prompt"},{"title":"List Prompts","openapi":"get /prompts","href":"/api-reference/admin-api/control-plane/prompts/list-prompts"},{"title":"Retrieve Prompt","openapi":"get /prompts/{promptId}","href":"/api-reference/admin-api/control-plane/prompts/retrieve-prompt"},{"title":"Update Prompt","openapi":"put /prompts/{promptId}","href":"/api-reference/admin-api/control-plane/prompts/update-prompt"},{"title":"Delete Prompt","openapi":"delete /prompts/{promptId}","href":"/api-reference/admin-api/control-plane/prompts/delete-prompt"},{"title":"Publish Prompt","openapi":"put /prompts/{promptId}/makeDefault","href":"/api-reference/admin-api/control-plane/prompts/publish-prompt"},{"title":"List Prompt Versions","openapi":"get /prompts/{promptId}/versions","href":"/api-reference/admin-api/control-plane/prompts/list-prompt-versions"},{"title":"Retrieve Prompt Version","openapi":"get /prompts/{promptId}/versions/{versionId}","href":"/api-reference/admin-api/control-plane/prompts/retrieve-prompt-version"},{"title":"Update Prompt Version","openapi":"put /prompts/{promptId}/versions/{versionId}","href":"/api-reference/admin-api/control-plane/prompts/update-prompt-version"},{"group":"Prompt Partials","pages":[{"title":"Create Partial","openapi":"post /prompts/partials","href":"/api-reference/admin-api/control-plane/prompts/partials/create-partial"},{"title":"List Partials","openapi":"get /prompts/partials","href":"/api-reference/admin-api/control-plane/prompts/partials/list-partials"},{"title":"Retrieve Partial","openapi":"get /prompts/partials/{promptPartialId}","href":"/api-reference/admin-api/control-plane/prompts/partials/retrieve-partial"},{"title":"Update Partial","openapi":"put /prompts/partials/{promptPartialId}","href":"/api-reference/admin-api/control-plane/prompts/partials/update-partial"},{"title":"Delete Partial","openapi":"delete /prompts/partials/{promptPartialId}","href":"/api-reference/admin-api/control-plane/prompts/partials/delete-partial"},{"title":"List Partial Versions","openapi":"get /prompts/partials/{promptPartialId}/versions","href":"/api-reference/admin-api/control-plane/prompts/partials/list-partial-versions"},{"title":"Publish Partial","openapi":"put /prompts/partials/{promptPartialId}/makeDefault","href":"/api-reference/admin-api/control-plane/prompts/partials/publish-partial"}]},{"group":"Prompt Labels","pages":[{"title":"Create Label","openapi":"post /labels","href":"/api-reference/admin-api/control-plane/prompts/labels/create-label"},{"title":"List Labels","openapi":"get /labels","href":"/api-reference/admin-api/control-plane/prompts/labels/list-labels"},{"title":"Retrieve Label","openapi":"get /labels/{labelId}","href":"/api-reference/admin-api/control-plane/prompts/labels/retrieve-label"},{"title":"Update Label","openapi":"put /labels/{labelId}","href":"/api-reference/admin-api/control-plane/prompts/labels/update-label"},{"title":"Delete Label","openapi":"delete /labels/{labelId}","href":"/api-reference/admin-api/control-plane/prompts/labels/delete-label"}]},{"group":"Prompt Collections","pages":[{"title":"Create Prompt Collection","openapi":"post /collections","href":"/api-reference/admin-api/control-plane/prompts/collections/create-collection"},{"title":"List Prompt Collections","openapi":"get /collections","href":"/api-reference/admin-api/control-plane/prompts/collections/list-collections"},{"title":"Retrieve Prompt Collection","openapi":"get /collections/{collectionId}","href":"/api-reference/admin-api/control-plane/prompts/collections/retrieve-collection"},{"title":"Update Prompt Collection","openapi":"put /collections/{collectionId}","href":"/api-reference/admin-api/control-plane/prompts/collections/update-collection"},{"title":"Delete Prompt Collection","openapi":"delete /collections/{collectionId}","href":"/api-reference/admin-api/control-plane/prompts/collections/delete-collection"}]}]},{"group":"API Keys","pages":[{"title":"Create API Key","openapi":"post /api-keys/{type}/{sub-type}","href":"/api-reference/admin-api/control-plane/api-keys/create-api-key"},{"title":"Update API Key","openapi":"put /api-keys/{id}","href":"/api-reference/admin-api/control-plane/api-keys/update-api-key"},{"title":"Rotate API Key","openapi":"post /api-keys/{id}/rotate","href":"/api-reference/admin-api/control-plane/api-keys/rotate-api-key"},{"title":"Delete an API Key","openapi":"delete /api-keys/{id}","href":"/api-reference/admin-api/control-plane/api-keys/delete-an-api-key"},{"title":"Retrieve an API Key","openapi":"get /api-keys/{id}","href":"/api-reference/admin-api/control-plane/api-keys/retrieve-an-api-key"},{"title":"List API Key","openapi":"get /api-keys","href":"/api-reference/admin-api/control-plane/api-keys/list-api-keys"}]},{"group":"Analytics [BETA]","pages":[{"group":"Summary","pages":[{"title":"Get User Grouped Data","openapi":"get /analytics/groups/users","href":"/api-reference/admin-api/control-plane/analytics/summary/get-all-cache-data"}]},{"group":"Groups Paginated Data","pages":[{"title":"Get Metadata Grouped Data","openapi":"get /analytics/groups/metadata/{metadataKey}","href":"/api-reference/admin-api/control-plane/analytics/groups-paginated-data/get-metadata-grouped-data"},{"title":"Get Model Grouped Data","openapi":"get /analytics/groups/ai-models","href":"/api-reference/admin-api/control-plane/analytics/groups-paginated-data/get-model-grouped-data"},{"title":"Get Provider Grouped Data","openapi":"get /analytics/groups/provider","href":"/api-reference/admin-api/control-plane/analytics/groups-paginated-data/get-provider-grouped-data"},{"title":"Get User Grouped Data","openapi":"get /analytics/groups/users","href":"/api-reference/admin-api/control-plane/analytics/groups-paginated-data/get-user-grouped-data"}]},{"group":"Graphs - Time Series Data","pages":[{"title":"Get cache hit latency data","openapi":"get /analytics/graphs/cache/latency","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-cache-hit-latency-data"},{"title":"Get cache hit rate data","openapi":"get /analytics/graphs/cache/hit-rate","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-cache-hit-rate-data"},{"title":"Get cost data","openapi":"get /analytics/graphs/cost","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-cost-data"},{"title":"Get error rate data","openapi":"get /analytics/graphs/errors/rate","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-error-rate-data"},{"title":"Get errors data","openapi":"get /analytics/graphs/errors","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-errors-data"},{"title":"Get feedback data","openapi":"get /analytics/graphs/feedbacks","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-feedback-data"},{"title":"Get feedback per ai models data","openapi":"get /analytics/graphs/feedbacks/ai-models","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-feedback-per-ai-models-data"},{"title":"Get feedback score distribution data","openapi":"get /analytics/graphs/feedbacks/scores","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-feedback-score-distribution-data"},{"title":"Get latency data","openapi":"get /analytics/graphs/latency","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-latency-data"},{"title":"Get requests data","openapi":"get /analytics/graphs/requests","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-requests-data"},{"title":"Get requests per user data","openapi":"get /analytics/graphs/users/requests","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-requests-per-user-data"},{"title":"Get rescued requests data","openapi":"get /analytics/graphs/requests/rescued","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-rescued-requests-data"},{"title":"Get status code data","openapi":"get /analytics/graphs/errors/stacks","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-status-code-data"},{"title":"Get tokens data","openapi":"get /analytics/graphs/tokens","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-tokens-data"},{"title":"Get unique status code data","openapi":"get /analytics/graphs/errors/status-codes","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-unique-status-code-data"},{"title":"Get users data","openapi":"get /analytics/graphs/users","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-users-data"},{"title":"Get weighted feedback data","openapi":"get /analytics/graphs/feedbacks/weighted","href":"/api-reference/admin-api/control-plane/analytics/graphs-time-series-data/get-weighted-feedback-data"}]}]},{"group":"Users","pages":[{"title":"Retrieve a user","openapi":"get /admin/users/{userId}","href":"/api-reference/admin-api/control-plane/users/retrieve-a-user"},{"title":"Retrieve all users","openapi":"get /admin/users","href":"/api-reference/admin-api/control-plane/users/retrieve-all-users"},{"title":"Update a user","openapi":"put /admin/users/{userId}","href":"/api-reference/admin-api/control-plane/users/update-a-user"},{"title":"Remove a user","openapi":"delete /admin/users/{userId}","href":"/api-reference/admin-api/control-plane/users/remove-a-user"}]},{"group":"User Invites","pages":[{"title":"Invite a User","openapi":"post /admin/users/invites","href":"/api-reference/admin-api/control-plane/user-invites/invite-a-user"},{"title":"Retrieve an user invite","openapi":"get /admin/users/invites/{inviteId}","href":"/api-reference/admin-api/control-plane/user-invites/retrieve-an-invite"},{"title":"Retrieve all user invite","openapi":"get /admin/users/invites","href":"/api-reference/admin-api/control-plane/user-invites/retrieve-all-user-invites"},{"title":"Delete a user invite","openapi":"delete /admin/users/invites/{inviteId}","href":"/api-reference/admin-api/control-plane/user-invites/delete-a-user-invite"},{"title":"Resend a user invite","openapi":"post /admin/users/invites/{inviteId}/resend","href":"/api-reference/admin-api/control-plane/user-invites/resend-a-user-invite"}]},{"group":"Workspaces","pages":[{"title":"Create Workspace","openapi":"post /admin/workspaces","href":"/api-reference/admin-api/control-plane/workspaces/create-workspace"},{"title":"Retrieve all Workspaces","openapi":"get /admin/workspaces","href":"/api-reference/admin-api/control-plane/workspaces/retrieve-all-workspaces"},{"title":"Retrieve a Workspace","openapi":"get /admin/workspaces/{workspaceId}","href":"/api-reference/admin-api/control-plane/workspaces/retrieve-a-workspace"},{"title":"Update Workspace","openapi":"put /admin/workspaces/{workspaceId}","href":"/api-reference/admin-api/control-plane/workspaces/update-workspace"},{"title":"Delete a Workspace","openapi":"delete /admin/workspaces/{workspaceId}","href":"/api-reference/admin-api/control-plane/workspaces/delete-a-workspace"}]},{"group":"Workspace Members","pages":[{"title":"Add a Workspace Member","openapi":"post /admin/workspaces/{workspaceId}/users","href":"/api-reference/admin-api/control-plane/workspace-members/add-a-workspace-member"},{"title":"Retrieve all Workspace Member","openapi":"get /admin/workspaces/{workspaceId}/users","href":"/api-reference/admin-api/control-plane/workspace-members/retrieve-all-workspace-members"},{"title":"Retrieve a Workspace Member","openapi":"get /admin/workspaces/{workspaceId}/users/{userId}","href":"/api-reference/admin-api/control-plane/workspace-members/retrieve-a-workspace-member"},{"title":"Update Workspace Member","openapi":"put /admin/workspaces/{workspaceId}/users/{userId}","href":"/api-reference/admin-api/control-plane/workspace-members/update-workspace-member"},{"title":"Remove Workspace Member","openapi":"delete /admin/workspaces/{workspaceId}/users/{userId}","href":"/api-reference/admin-api/control-plane/workspace-members/remove-workspace-member"}]},{"group":"SCIM Workspace Mappings","pages":[{"title":"List SCIM Workspace Mappings","openapi":"get /scim/workspaces","href":"/api-reference/admin-api/control-plane/scim-workspace-mappings/list-scim-workspace-mappings"},{"title":"Create SCIM Workspace Mapping","openapi":"post /scim/workspaces","href":"/api-reference/admin-api/control-plane/scim-workspace-mappings/create-scim-workspace-mapping"},{"title":"Delete SCIM Workspace Mapping","openapi":"delete /scim/workspaces/{scimWorkspaceGroupId}","href":"/api-reference/admin-api/control-plane/scim-workspace-mappings/delete-scim-workspace-mapping"}]},{"group":"Audit Logs","pages":[{"title":"List Audit Logs","openapi":"get /audit-logs","href":"/api-reference/admin-api/control-plane/audit-logs/list-audit-logs"}]},{"group":"Guardrails","pages":[{"title":"Create Guardrail","openapi":"post /guardrails","href":"/api-reference/admin-api/control-plane/guardrails/create-guardrail"},{"title":"List Guardrails","openapi":"get /guardrails","href":"/api-reference/admin-api/control-plane/guardrails/list-guardrails"},{"title":"Retrieve Guardrail","openapi":"get /guardrails/{guardrailId}","href":"/api-reference/admin-api/control-plane/guardrails/retrieve-guardrail"},{"title":"Update Guardrail","openapi":"put /guardrails/{guardrailId}","href":"/api-reference/admin-api/control-plane/guardrails/update-guardrail"},{"title":"Delete Guardrail","openapi":"delete /guardrails/{guardrailId}","href":"/api-reference/admin-api/control-plane/guardrails/delete-guardrail"}]},{"group":"Secret References","pages":[{"title":"Create Secret Reference","openapi":"post /secret-references","href":"/api-reference/admin-api/control-plane/secret-references/create-secret-reference"},{"title":"List Secret References","openapi":"get /secret-references","href":"/api-reference/admin-api/control-plane/secret-references/list-secret-references"},{"title":"Retrieve Secret Reference","openapi":"get /secret-references/{secretReferenceId}","href":"/api-reference/admin-api/control-plane/secret-references/retrieve-secret-reference"},{"title":"Update Secret Reference","openapi":"put /secret-references/{secretReferenceId}","href":"/api-reference/admin-api/control-plane/secret-references/update-secret-reference"},{"title":"Delete Secret Reference","openapi":"delete /secret-references/{secretReferenceId}","href":"/api-reference/admin-api/control-plane/secret-references/delete-secret-reference"}]},{"group":"Policies","pages":[{"group":"Usage Limits","pages":[{"title":"Create Usage Limits Policy","openapi":"post /policies/usage-limits","href":"/api-reference/admin-api/control-plane/policies/usage-limits/create-usage-limits-policy"},{"title":"List Usage Limits Policy","openapi":"get /policies/usage-limits","href":"/api-reference/admin-api/control-plane/policies/usage-limits/list-usage-limits-policy"},{"title":"Retrieve Usage Limits Policy","openapi":"get /policies/usage-limits/{policyUsageLimitsId}","href":"/api-reference/admin-api/control-plane/policies/usage-limits/retrieve-usage-limits-policy"},{"title":"Update Usage Limits Policy","openapi":"put /policies/usage-limits/{policyUsageLimitsId}","href":"/api-reference/admin-api/control-plane/policies/usage-limits/update-usage-limits-policy"},{"title":"Delete Usage Limits Policy","openapi":"delete /policies/usage-limits/{policyUsageLimitsId}","href":"/api-reference/admin-api/control-plane/policies/usage-limits/delete-usage-limits-policy"},{"title":"List Usage Limits Policy Entities","openapi":"get /policies/usage-limits/{policyUsageLimitsId}/entities","href":"/api-reference/admin-api/control-plane/policies/usage-limits/list-usage-limits-policy-entities"},{"title":"Reset Usage Limits Policy Entity","openapi":"put /policies/usage-limits/{policyUsageLimitsId}/entities/{entityId}/reset","href":"/api-reference/admin-api/control-plane/policies/usage-limits/reset-usage-limits-policy-entity"}]},{"group":"Rate Limits","pages":[{"title":"Create Rate Limits Policy","openapi":"post /policies/rate-limits","href":"/api-reference/admin-api/control-plane/policies/rate-limits/create-rate-limits-policy"},{"title":"List Rate Limits Policy","openapi":"get /policies/rate-limits","href":"/api-reference/admin-api/control-plane/policies/rate-limits/list-rate-limits-policy"},{"title":"Retrieve Rate Limits Policy","openapi":"get /policies/rate-limits/{rateLimitsPolicyId}","href":"/api-reference/admin-api/control-plane/policies/rate-limits/retrieve-rate-limits-policy"},{"title":"Update Rate Limits Policy","openapi":"put /policies/rate-limits/{rateLimitsPolicyId}","href":"/api-reference/admin-api/control-plane/policies/rate-limits/update-rate-limits-policy"},{"title":"Delete Rate Limits Policy","openapi":"delete /policies/rate-limits/{rateLimitsPolicyId}","href":"/api-reference/admin-api/control-plane/policies/rate-limits/delete-rate-limits-policy"}]}]},{"group":"OpenAPI","pages":[{"title":"OpenAPI Specification","url":"https://github.com/Portkey-AI/openapi","href":"/api-reference/admin-api/open-api-specification"}]}]},{"tab":"Cookbooks","pages":[{"title":"Cookbooks","href":"/guides/use-cases/run-batch-evals"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026/september"}]},{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help-center/you-do-not-have-enough-permissions"}]}]},{"version":"Prisma AIRS","pages":[{"title":"Prisma AIRS","href":"/aigw/introduction/welcome"}]},{"version":"Virtual Keys (Deprecated)","pages":[{"title":"Virtual Keys (Deprecated)","href":"/virtual_key_old/introduction/what-is-portkey"}]}]},"basePath":"","title":"Create MCP Integration - Portkey (Prisma AIRS AI Gateway) Docs","buildId":"dpl_GWQzn6k13MqphA3qck3hQKoQXDzM","deploymentId":"dpl_GWQzn6k13MqphA3qck3hQKoQXDzM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-vlKR2tYY.js","utils-DBDPZSWe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CxHK4zz2.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-27b98BOz.js","snippetPresets-DNnui32z.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-cDVS2zyo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BEE-OyDQ.js","shallow-fqEMZOYR.js","getApiPlaygroundDisplay-BPut1_OB.js","CodeSnippet-h9vp8UTG.js","CodeSnippets-DoMjCW5Q.js","Page-BOWGOUSK.js","getPastedJson-C4r-hmQ_.js","icon-CCDahfhO.js","MethodPill-Dpq0JSrS.js","DuplicateIcon-BGPwFt-j.js","createIcon-DBULrQp7.js","DynamicMarkdown-B74atANy.js","SectionHeading-DZCpbSmT.js","axios-vUo_bRtp.js","Markdown-BwkgxkAH.js","clsx-CEIlvfOI.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-f6OgbvLC.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DvlTOml0.js"]}