MCP Servers for developers

1
// Check if a user has connected accounts for all required toolkits
2
const connectionStatus = await composio.mcp.getUserConnectionStatus(
3
  "user123@example.com",
4
  mcpConfig.id
5
);
6
7
console.log("Overall connection status:", connectionStatus.connected);
8
console.log("Individual toolkit status:", connectionStatus.connectedToolkits);
9
10
// Handle missing connections
11
if (!connectionStatus.connected) {
12
  Object.entries(connectionStatus.connectedToolkits).forEach(([toolkit, status]) => {
13
    if (!status.connected) {
14
      console.log(`❌ ${toolkit} not connected`);
15
      // Guide user through authentication
16
    }
17
  });
18
}

1
// Retrieve a server by its name
2
const serverDetails = await composio.mcp.getByName("Gmail MCP Server");
3
console.log("Server details:", serverDetails);

1
// List servers with filtering options
2
const servers = await composio.mcp.list({
3
  page: 1,
4
  limit: 10,
5
  toolkits: ["gmail", "slack"], // Filter by toolkits
6
  name: "production" // Filter by name
7
});
8
9
console.log("Found servers:", servers.items);

1
// Update an existing server (uses traditional API signature)
2
const updatedServer = await composio.mcp.update(
3
  "server-uuid",
4
  "Updated Gmail Server",
5
  [
6
    {
7
      toolkit: "gmail",
8
      authConfigId: "ac_new_auth_config",
9
      allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]
10
    }
11
  ],
12
  { isChatAuth: true }
13
);

1
// Check what authentication is needed
2
const authParams = await composio.mcp.getConnectionParams(
3
  mcpConfig.id,
4
  "gmail"
5
);
6
7
// Initiate authentication for a user
8
const authRequest = await composio.mcp.authorize(
9
  "user123@example.com",
10
  mcpConfig.id,
11
  "gmail"
12
);
13
14
if (authRequest.redirectUrl) {
15
  console.log("Please complete authentication:", authRequest.redirectUrl);
16
}

1
const serverUrls = await composio.mcp.getServer(
2
  mcpConfig.id,
3
  "user123@example.com"
4
);
5
6
// The server URLs will include helper actions that guide users through authentication