GET
/
api
/
v1
/
mcp-servers
/
available
curl --request GET \
  --url https://api.kambrium.com/api/v1/mcp-servers/available \
  --header 'Authorization: Bearer <token>'
{
  "message": "Available MCP servers retrieved successfully",
  "mcp_servers": [
    {
      "server_type": "pipedrive",
      "name": "Pipedrive CRM",
      "description": "Connect to Pipedrive CRM for contacts and deals",
      "version": "1.0.0",
      "capabilities": [
        "tools",
        "resources"
      ]
    }
  ],
  "total_count": 5
}

​
Overview

This endpoint returns all available MCP server integrations that users can connect to. It provides information about each integration including the number of available tools.

​
Prerequisites

  • Valid OAuth Token - Bearer token with mgmt.read scope

​
Request

GET /api/v1/mcp-servers/available

​
Headers

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

​
Response

​
Success Response (200 OK)

{
  "success": true,
  "data": [
    {
      "name": "pipedrive",
      "description": "Pipedrive CRM integration with deal and contact management",
      "number_of_tools": 15
    },
    {
      "name": "hubspot",
      "description": "HubSpot CRM and marketing automation platform",
      "number_of_tools": 23
    },
    {
      "name": "salesforce",
      "description": null,
      "number_of_tools": 8
    }
  ]
}

​
Response Fields

FieldTypeDescription
successbooleanWhether the request was successful
dataarrayArray of available integrations

​
Integration Object Fields

Each integration in the data array contains:

FieldTypeDescription
namestringUnique identifier for the integration
descriptionstring/nullHuman-readable description of the integration
number_of_toolsintegerNumber of tools available in this integration

​
Error Responses

​
Unauthorized (401)

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

​
Forbidden (403)

{
  "detail": "You do not have permission to view available integrations."
}

​
Examples

​
Get Available Integrations

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

​
Response

{
  "success": true,
  "data": [
    {
      "name": "pipedrive",
      "description": "Pipedrive CRM integration with deal and contact management",
      "number_of_tools": 15
    },
    {
      "name": "hubspot",
      "description": "HubSpot CRM and marketing automation platform",
      "number_of_tools": 23
    },
    {
      "name": "salesforce",
      "description": "Salesforce CRM and sales cloud platform",
      "number_of_tools": 18
    },
    {
      "name": "slack",
      "description": "Slack team communication and workflow integration",
      "number_of_tools": 12
    },
    {
      "name": "notion",
      "description": "Notion workspace and knowledge management",
      "number_of_tools": 9
    }
  ]
}

​
Implementation Notes

​
Integration Discovery

  • Integrations are loaded from the main database
  • Only active and supported integrations are returned
  • Tool counts are calculated dynamically

​
Tool Counting

  • Includes both local MCP server tools and external API endpoints
  • Only publicly available tools are counted
  • Tool counts may vary based on integration configuration

​
Caching

  • Results are cached for improved performance
  • Cache is invalidated when new integrations are added
  • Fresh tool counts are calculated periodically

Authorizations

​
Authorization
string
header
required

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

Response

200 - application/json

List of available MCP servers

The response is of type object.