Server management

This guide covers all server management operations for MCP servers.

Create a server

server = composio.mcp.create(
    name="my-gmail-server",
    toolkits=[{
        "toolkit": "gmail",
        "auth_config": "ac_xyz123"
    }],
    allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]
)

print(f"Created server: {server.id}")

const server = await composio.mcp.create(
  "my-gmail-server",
  {
    toolkits: [
      {
        authConfigId: "ac_xyz123",
        toolkit: "gmail"
      }
    ],
    allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"],
    manuallyManageConnections: false
  }
);

console.log(`Created server: ${server.id}`);

List servers

Find and filter your MCP servers.

# List all servers
servers = composio.mcp.list()
print(f"Found {len(servers['items'])} servers")

# Filter by toolkit
gmail_servers = composio.mcp.list(
    toolkits="gmail",
    limit=20
)

# Filter by name
production_servers = composio.mcp.list(
    name="production"
)

// List all servers
const servers = await composio.mcp.list({
  limit: 10,
  page: 1,
  authConfigs: [],
  toolkits: []
});
console.log(`Found ${servers.items.length} servers`);

// Filter by toolkit
const gmailServers = await composio.mcp.list({
  limit: 20,
  page: 1,
  authConfigs: [],
  toolkits: ["gmail"]
});

// Filter by name
const productionServers = await composio.mcp.list({
  limit: 10,
  page: 1,
  authConfigs: [],
  toolkits: [],
  name: "production"
});

Get server details

# Get by ID
server = composio.mcp.get("mcp_server_id")
print(f"Server name: {server.name}")
print(f"Toolkits: {server.toolkits}")

// Get by ID
const server = await composio.mcp.get("mcp_server_id");

console.log(`Server: ${server.name}`);
console.log(`Toolkits: ${server.toolkits}`);

Update a server

Modify server configuration, tools, or auth configs.

updated = composio.mcp.update(
    server_id="mcp_server_id",
    name="updated-name",
    allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]
)

const updated = await composio.mcp.update(
  "mcp_server_id",
  {
    name: "updated-name",
    toolkits: [
      {
        toolkit: "gmail",
        authConfigId: "ac_new_config"
      }
    ],
    allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"],
    manuallyManageConnections: false
  }
);

console.log(updated);

Delete a server

result = composio.mcp.delete("mcp_server_id")
if result['deleted']:
    print("Server deleted successfully")

const result = await composio.mcp.delete("mcp_server_id");
if (result.deleted) {
  console.log("Server deleted successfully");
}

Multi-toolkit servers

Combine multiple services in a single MCP server.

server = composio.mcp.create(
    name="productivity-suite",
    toolkits=[
        {"toolkit": "gmail", "auth_config": "ac_gmail"},
        {"toolkit": "slack", "auth_config": "ac_slack"},
        {"toolkit": "github", "auth_config": "ac_github"}
    ],
    allowed_tools=[
        "GMAIL_FETCH_EMAILS",
        "SLACK_SEND_MESSAGE",
        "GITHUB_CREATE_ISSUE"
    ]
)

const server = await composio.mcp.create(
  "productivity-suite",
  {
    toolkits: [
      {
        authConfigId: "ac_gmail",
        toolkit: "gmail"
      },
      {
        authConfigId: "ac_slack",
        toolkit: "slack"
      },
      {
        authConfigId: "ac_github",
        toolkit: "github"
      }
    ],
    allowedTools: [
      "GMAIL_FETCH_EMAILS",
      "SLACK_SEND_MESSAGE",
      "GITHUB_CREATE_ISSUE"
    ],
    manuallyManageConnections: false
  }
);

Generate user URLs

After creating a server, generate unique URLs for each user.

# Generate instance for user
instance = server.generate("user@example.com")

print(f"URL: {instance['url']}")
print(f"Tools: {instance['allowed_tools']}")

# Chat-based authentication is enabled by default
# Set manually_manage_connections=True to disable it:
instance_manual = server.generate(
    "user@example.com",
    manually_manage_connections=True
)

// Generate instance for user
const instance = await server.generate("user@example.com");

console.log("URL:", instance.url);
console.log("Tools:", instance.allowedTools);

// Chat-based authentication is enabled by default
// Set manuallyManageConnections: true to disable it:
const instanceManual = await composio.mcp.generate(
  "user@example.com",
  server.id,
  { manuallyManageConnections: true }
);

Chat-based authentication:

TypeScript: Enabled by default (set manuallyManageConnections=false or omit it)
Python: Enabled by default (set manually_manage_connections=False or omit it)

When enabled, the agent can authenticate users dynamically during conversation if they're missing required connections. Set manuallyManageConnections=true (TypeScript) or manually_manage_connections=True (Python) to disable it.

Best practices

Use descriptive names - Makes servers easy to find
Limit tools appropriately - Only include necessary tools
Reuse servers - Don't create duplicates for same configuration
Store server IDs - Keep track of created server IDs

Server management

On this page