curl -X GET "https://api.example.com/api/mcp/servers?projectId=proj_123" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://api.example.com/api/mcp/servers?projectId=proj_123',
{
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
import requests
response = requests.get(
'https://api.example.com/api/mcp/servers',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'projectId': 'proj_123'}
)
data = response.json()
{
"success": true,
"servers": [
{
"id": "mcp_abc123",
"projectId": "proj_123",
"name": "Production Server",
"description": "Main production MCP server",
"url": "https://mcp-server.example.com",
"transportType": "http",
"connectionType": "proxy",
"status": "connected",
"capabilities": {
"tools": true,
"resources": true,
"prompts": true
},
"lastConnectedAt": "2026-01-17T10:30:00Z",
"createdAt": "2026-01-01T00:00:00Z",
"updatedAt": "2026-01-17T10:30:00Z"
}
]
}
Server Management
List MCP Servers
Retrieves all MCP servers configured for a specific project
GET
/
api
/
mcp
/
servers
curl -X GET "https://api.example.com/api/mcp/servers?projectId=proj_123" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://api.example.com/api/mcp/servers?projectId=proj_123',
{
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
import requests
response = requests.get(
'https://api.example.com/api/mcp/servers',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'projectId': 'proj_123'}
)
data = response.json()
{
"success": true,
"servers": [
{
"id": "mcp_abc123",
"projectId": "proj_123",
"name": "Production Server",
"description": "Main production MCP server",
"url": "https://mcp-server.example.com",
"transportType": "http",
"connectionType": "proxy",
"status": "connected",
"capabilities": {
"tools": true,
"resources": true,
"prompts": true
},
"lastConnectedAt": "2026-01-17T10:30:00Z",
"createdAt": "2026-01-01T00:00:00Z",
"updatedAt": "2026-01-17T10:30:00Z"
}
]
}
Query Parameters
string
required
Project ID to filter servers
Response
boolean
Whether the request was successful
array
Array of MCP server objects
Show Server Object
Show Server Object
string
Unique server identifier
string
Associated project ID
string
Server name
string | null
Server description
string | null
Server URL
string
Transport type:
stdio, http, or ssestring
Connection type:
direct or proxystring
Server status:
connecting, connected, disconnected, or errorobject | null
Server capabilities
string | null
ISO 8601 timestamp of last connection
string
ISO 8601 timestamp of creation
string
ISO 8601 timestamp of last update
curl -X GET "https://api.example.com/api/mcp/servers?projectId=proj_123" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://api.example.com/api/mcp/servers?projectId=proj_123',
{
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
import requests
response = requests.get(
'https://api.example.com/api/mcp/servers',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'projectId': 'proj_123'}
)
data = response.json()
{
"success": true,
"servers": [
{
"id": "mcp_abc123",
"projectId": "proj_123",
"name": "Production Server",
"description": "Main production MCP server",
"url": "https://mcp-server.example.com",
"transportType": "http",
"connectionType": "proxy",
"status": "connected",
"capabilities": {
"tools": true,
"resources": true,
"prompts": true
},
"lastConnectedAt": "2026-01-17T10:30:00Z",
"createdAt": "2026-01-01T00:00:00Z",
"updatedAt": "2026-01-17T10:30:00Z"
}
]
}
⌘I

