Router endpoint
Use the router when the caller needs to find and select an application. The packaged shared HTTPS route is /api/application/mcp, which forwards to the router on port 5194. Deployments that support a personal URL in the application account card send it to the same router. The router validates the URL against the issuer and subject of the MCP-audience access token.
Discover, select and verify
- Call
read_v2_session_identitywith{}and verify the returned identity. Then calllist_v2_applications. For another page, supply the returnednextAfterasafteruntil it isnull. - Pass the selected row's stable IDs to
list_v2_functionsasworkspace_idandapplication_id. Verifylistener.scopeisrouted_applicationand match both IDs. - Use the same scope arguments on each application-scoped request through the router. For example, the routed
read_v2_programrequires both IDs plusprogram. See Select and discover for the exact arguments and the next bounded read.
A valid identity can still lack enrollment or the target grant. If a personal URL returns PERSONAL_MCP_IDENTITY_MISMATCH, use the account that owns the URL or get the correct URL for your account. If a release lacks personal routing, use the operator-provided shared router URL with your own credentials.