Get the consent URL for per-user MCP server authorization
curl --request GET \
--url https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize \
--header 'Authorization: Bearer <token>'import requests
url = "https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "authenticated",
"method": "oauth",
"expiresAt": "2026-10-01T12:40:00.000Z",
"isRefreshable": true,
"lastUpdatedAt": "2026-10-01T11:40:00.000Z",
"refreshFailureCount": 0,
"refreshFailureMessage": "invalid_grant: refresh token expired"
}MCP Servers V2
Get the consent URL for per-user MCP server authorization
Returns the per-subject auth status for the MCP server. When status is authentication_required, the response additionally includes an authorization_endpoint: a single MCP-gateway-proxied consent URL that seeds the chained consent flow for the requested server. For virtual MCP servers the chain walks every source still needing auth before landing the user on the tenant control-plane mcp-server-success page.
GET
/
api
/
svc
/
v1
/
mcp
/
{mcpServerId}
/
authorize
Get the consent URL for per-user MCP server authorization
curl --request GET \
--url https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize \
--header 'Authorization: Bearer <token>'import requests
url = "https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{controlPlaneURL}/api/svc/v1/mcp/{mcpServerId}/authorize")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "authenticated",
"method": "oauth",
"expiresAt": "2026-10-01T12:40:00.000Z",
"isRefreshable": true,
"lastUpdatedAt": "2026-10-01T11:40:00.000Z",
"refreshFailureCount": 0,
"refreshFailureMessage": "invalid_grant: refresh token expired"
}Authorizations
Path Parameters
Query Parameters
Response
Per-subject auth status; the AUTHENTICATION_REQUIRED branch carries the consent URL to open.
- MCPServerAuthStatusAuthenticated
- MCPServerAuthorizeAuthRequired
- MCPServerAuthStatusAuthNotRequired
Was this page helpful?