Skip to main content
GET
/
mcp-integrations
/
{mcpIntegrationId}
Get MCP Integration
curl --request GET \
  --url https://api.portkey.ai/v1/mcp-integrations/{mcpIntegrationId} \
  --header 'x-portkey-api-key: <api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "owner_id": "<string>",
  "status": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "last_updated_at": "2023-11-07T05:31:56Z",
  "configurations": {},
  "global_workspace_access": {},
  "workspace_id": "<string>",
  "slug": "<string>",
  "url": "<string>",
  "secret_mappings": [
    {
      "target_field": "key",
      "secret_reference_id": "my-aws-secret",
      "secret_key": "<string>",
      "value_format": "json"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.portkey.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-portkey-api-key
string
header
required

Path Parameters

​
mcpIntegrationId
string
required

MCP Integration ID (UUID) or slug

Response

200 - application/json

OK

​
id
string<uuid>
​
name
string
​
description
string | null
​
owner_id
string
​
status
string
​
created_at
string<date-time>
​
last_updated_at
string<date-time>
​
configurations
object
​
global_workspace_access
object
​
workspace_id
string | null

Workspace ID or slug (when workspace-scoped)

​
slug
string
​
url
string<uri>
​
auth_type
enum<string>
Available options:
oauth_auto,
oauth_client_credentials,
headers,
none
​
transport
enum<string>
Available options:
http,
sse,
interactive
​
type
enum<string>
Available options:
workspace,
organisation
​
secret_mappings
object[]

Secret reference mappings for this MCP integration. Valid target_field values are "configurations.".

Last modified on May 20, 2026