Skip to content

List the discovery metadata for all of the discovered MCP server toolsets

Request

Beta
OAuth 2.0 scope:
  • okta.resourceServers.mcpServers.read
Admin roles:
  • SUPER_ADMIN

Lists the discovery metadata for a third-party Model Context Protocol (MCP) server. Each entry corresponds to a unique credential used to discover tools.

Path
mcpServerIdstringrequired

ID of an MCP server

Example:ems8nUa7p0g4zrZbs2f4
Query
afterstring

The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the Link response header. See Pagination and Link header.

limitinteger, [ 1 .. 200 ]

A limit on the number of objects to return

Default:20
searchstring, (scim-filter)

Searches for discovery metadata by credential. Supports the following operators:

  • eq operator for the credential.authType property
  • eq operator for the credential.clientAuthSettingsId property

Note: This operation requires URL encoding. See Special characters.

Examples:
Search by CLIENT_AUTH_SETTINGS auth type
search=credential.authType eq "CLIENT_AUTH_SETTINGS"
Search by IDENTITY_ASSERTION auth type
search=credential.authType eq "IDENTITY_ASSERTION"
Search by type and specific credential
search=credential.authType eq "CLIENT_AUTH_SETTINGS" and credential.clientAuthSettingsId eq "rsc2c8xwvBn4h2Ry50g7"
curl -i -X GET \
  'https://subdomain.okta.com/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery?after=string&limit=20&search=credential.authType%20eq%20%22CLIENT_AUTH_SETTINGS%22'

Responses

OK

Headers
Bodyapplication/json
dataArray of objects(MCPServerDiscovery)required
Response
{ "data": [ { … }, { … }, { … } ], "_links": { "self": { … } } }