List mcp server connected agents
GET/business-applications/v1/mcp-servers/:id/connected-agents
This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.
Returns the AI agents connected to an MCP server. Results are sorted by name ascending unless sorters is provided. Filtering is not supported on this endpoint. Requires the idn:business-application:read right and the Machine Identity Security product to be enabled for the tenant. Returns 404 if MCP server discovery is not enabled for the tenant.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
A list of AI agents connected to the MCP server.
Response Headers
Included when count=true.
Client Error - Returned if id is not a valid UUID, if filters is provided, or if sorters names an unsupported field.
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
Not Found - Returned if no MCP server exists for the given ID, or if MCP server discovery is not enabled for the tenant.
Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.
Internal Server Error - Returned if there is an unexpected error.