Server management

1
server = composio.mcp.create(
2
    name="my-gmail-server",
3
    toolkits=[{
4
        "toolkit": "gmail",
5
        "auth_config": "ac_xyz123"
6
    }],
7
    allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]
8
)
9
10
print(f"Created server: {server.id}")

1
# List all servers
2
servers = composio.mcp.list()
3
print(f"Found {len(servers['items'])} servers")
4
5
# Filter by toolkit
6
gmail_servers = composio.mcp.list(
7
    toolkits="gmail",
8
    limit=20
9
)
10
11
# Filter by name
12
production_servers = composio.mcp.list(
13
    name="production"
14
)

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

1
updated = composio.mcp.update(
2
    server_id="mcp_server_id",
3
    name="updated-name",
4
    allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]
5
)

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

1
server = composio.mcp.create(
2
    name="productivity-suite",
3
    toolkits=[
4
        {"toolkit": "gmail", "auth_config": "ac_gmail"},
5
        {"toolkit": "slack", "auth_config": "ac_slack"},
6
        {"toolkit": "github", "auth_config": "ac_github"}
7
    ],
8
    allowed_tools=[
9
        "GMAIL_FETCH_EMAILS",
10
        "SLACK_SEND_MESSAGE",
11
        "GITHUB_CREATE_ISSUE"
12
    ]
13
)

1
# Generate instance for user
2
instance = server.generate("user@example.com")
3
4
print(f"URL: {instance['url']}")
5
print(f"Tools: {instance['allowed_tools']}")
6
7
# Chat-based authentication is enabled by default
8
# Set manually_manage_connections=True to disable it:
9
instance_manual = server.generate(
10
    "user@example.com", 
11
    manually_manage_connections=True
12
)