GET
/
api
/
v1
/
mcp-servers
/
{server_id}
curl --request GET \
  --url https://api.kambrium.com/api/v1/mcp-servers/{server_id} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Connection retrieved successfully",
  "connection": {
    "connection_id": "conn_123abc",
    "mcp_server_id": "mcp_456def",
    "server_type": "pipedrive",
    "name": "My Pipedrive Connection",
    "description": "Connection to Pipedrive CRM",
    "status": "active",
    "auth_method": "api_key",
    "oauth2_client_id": "oauth_client_123",
    "oauth2_scopes": [
      "<string>"
    ],
    "config": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

​
Overview

This endpoint retrieves detailed information about a specific MCP server connection, including configuration, status, and metadata.

​
Prerequisites

  • Valid OAuth Token - Bearer token with mgmt.read scope
  • Existing Connection - Valid MCP server connection ID

​
Request

GET /api/v1/mcp-servers/{server_id}

​
Path Parameters

ParameterTypeRequiredDescription
server_idintegerYesThe MCP server connection ID

​
Headers

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token from OAuth authentication
Content-TypestringYesMust be application/json

​
Response

​
Success Response (200 OK)

{
  "success": true,
  "data": {
    "id": 123,
    "mcp_server_name": "Pipedrive",
    "api_key_verification_status": "verified",
    "oauth2_client_id": "client_abc123",
    "oauth2_scopes": ["mcp.read", "mcp.write"],
    "agent_enabled": true,
    "disabled_tools": [],
    "created_at": "2025-06-27T10:30:00Z"
  }
}

​
Response Fields

FieldTypeDescription
successbooleanWhether the request was successful
data.idintegerUnique identifier for the connection
data.mcp_server_namestringHuman-readable name of the integration
data.api_key_verification_statusstringAPI key validation status (“pending”, “verified”, “failed”)
data.oauth2_client_idstringOAuth2 client ID for MCP server communication
data.oauth2_scopesarrayOAuth2 scopes granted for this connection
data.agent_enabledbooleanWhether the connection is enabled for agent use
data.disabled_toolsarrayList of disabled tool IDs
data.created_atstringISO timestamp when connection was created

​
Error Responses

​
Connection Not Found (404)

{
  "detail": "MCP server 123 not found or not accessible"
}

​
Unauthorized (401)

{
  "detail": "Authentication credentials were not provided."
}

​
Forbidden (403)

{
  "detail": "You do not have permission to access this connection."
}

​
Internal Server Error (500)

{
  "detail": "Failed to get MCP server details: database error"
}

​
Examples

​
Get Connection Details

curl -X GET "https://api.kambrium.com/api/v1/mcp-servers/123" \
  -H "Authorization: Bearer your_oauth_token" \
  -H "Content-Type: application/json"

​
Response

{
  "success": true,
  "data": {
    "id": 123,
    "mcp_server_name": "Pipedrive",
    "api_key_verification_status": "verified",
    "oauth2_client_id": "client_abc123",
    "oauth2_scopes": ["mcp.read", "mcp.write"],
    "agent_enabled": true,
    "disabled_tools": [],
    "created_at": "2025-06-27T10:30:00Z"
  }
}

​
Implementation Notes

​
Access Control

  • Users can only access their own connections
  • Connection ownership is verified against the authenticated user
  • Admin users may have broader access (implementation-dependent)

​
Data Privacy

  • Sensitive information like API keys are not returned in responses
  • Only metadata and configuration are included
  • OAuth client secrets are never exposed

​
Status Information

  • API key verification status reflects the current state
  • OAuth scopes show the permissions granted to this connection
  • Agent enabled status indicates if the connection is active

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
server_id
string
required
Example:

"srv_123abc"

Response

200 - application/json

MCP server connection details

The response is of type object.