Test MCP Server Connection
curl --request POST \
--url https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test \
--header 'x-portkey-api-key: <api-key>'import requests
url = "https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test"
headers = {"x-portkey-api-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-portkey-api-key': '<api-key>'}};
fetch('https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test', 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://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"x-portkey-api-key: <api-key>"
],
]);
$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://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("x-portkey-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test")
.header("x-portkey-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-portkey-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"status_code": 123,
"response_time_ms": 123,
"url": "<string>",
"server_name": "<string>",
"error": "<string>"
}Test MCP Server connection
Test connectivity to the MCP server via its integration URL.
POST
/
mcp-servers
/
{mcpServerId}
/
test
Test MCP Server Connection
curl --request POST \
--url https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test \
--header 'x-portkey-api-key: <api-key>'import requests
url = "https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test"
headers = {"x-portkey-api-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-portkey-api-key': '<api-key>'}};
fetch('https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test', 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://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"x-portkey-api-key: <api-key>"
],
]);
$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://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("x-portkey-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test")
.header("x-portkey-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/test")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-portkey-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"status_code": 123,
"response_time_ms": 123,
"url": "<string>",
"server_name": "<string>",
"error": "<string>"
}Portkey is now PRISMA AIRS AI Gateway. See it in action.
Contact Us
Authorizations
Path Parameters
MCP Server ID (UUID) or slug
Last modified on August 3, 2026
Was this page helpful?
⌘I

