Add MCP server support: events and session management methods

src/main/java/com/github/copilot/sdk/CopilotSession.java

@@ -35,6 +35,7 @@
 import com.github.copilot.sdk.json.AgentInfo;
 import com.github.copilot.sdk.json.GetMessagesResponse;
 import com.github.copilot.sdk.json.HookInvocation;
+import com.github.copilot.sdk.json.McpServerInfo;
 import com.github.copilot.sdk.json.MessageOptions;
 import com.github.copilot.sdk.json.PermissionHandler;
 import com.github.copilot.sdk.json.PermissionInvocation;
@@ -1275,6 +1276,74 @@ public CompletableFuture<Void> compact() {
         return rpc.invoke("session.compaction.compact", Map.of("sessionId", sessionId), Void.class);
     }
 
+    /**
+     * Lists the MCP servers configured for this session, including their connection
+     * status.
+     *
+     * @return a future that resolves with the list of MCP server info objects
+     * @throws IllegalStateException
+     *             if this session has been terminated
+     * @since 1.0.0
+     */
+    public CompletableFuture<List<McpServerInfo>> listMcpServers() {
+        ensureNotTerminated();
+        return rpc.invoke("session.mcp.list", Map.of("sessionId", sessionId), McpListResponse.class)
+                .thenApply(response -> response.servers() != null
+                        ? Collections.unmodifiableList(response.servers())
+                        : Collections.emptyList());
+    }
+
+    /**
+     * Enables a previously disabled MCP server in this session.
+     *
+     * @param serverName
+     *            the name of the MCP server to enable (the key used in the
+     *            {@link com.github.copilot.sdk.json.SessionConfig#setMcpServers(java.util.Map)}
+     *            map)
+     * @return a future that completes when the server has been enabled
+     * @throws IllegalStateException
+     *             if this session has been terminated
+     * @since 1.0.0
+     */
+    public CompletableFuture<Void> enableMcpServer(String serverName) {
+        ensureNotTerminated();
+        return rpc.invoke("session.mcp.enable", Map.of("sessionId", sessionId, "serverName", serverName), Void.class);
+    }
+
+    /**
+     * Disables an MCP server in this session without removing its configuration.
+     * <p>
+     * A disabled server can be re-enabled later via
+     * {@link #enableMcpServer(String)}.
+     *
+     * @param serverName
+     *            the name of the MCP server to disable
+     * @return a future that completes when the server has been disabled
+     * @throws IllegalStateException
+     *             if this session has been terminated
+     * @since 1.0.0
+     */
+    public CompletableFuture<Void> disableMcpServer(String serverName) {
+        ensureNotTerminated();
+        return rpc.invoke("session.mcp.disable", Map.of("sessionId", sessionId, "serverName", serverName), Void.class);
+    }
+
+    /**
+     * Reloads all MCP servers in this session.
+     * <p>
+     * This disconnects and reconnects all configured MCP servers, which can be
+     * useful to pick up configuration changes or recover from failed connections.
+     *
+     * @return a future that completes when the reload is initiated
+     * @throws IllegalStateException
+     *             if this session has been terminated
+     * @since 1.0.0
+     */
+    public CompletableFuture<Void> reloadMcpServers() {
+        ensureNotTerminated();
+        return rpc.invoke("session.mcp.reload", Map.of("sessionId", sessionId), Void.class);
+    }
+
     /**
      * Verifies that this session has not yet been terminated.
      *
@@ -1330,4 +1399,10 @@ private record AgentGetCurrentResponse(@JsonProperty("agent") AgentInfo agent) {
     private record AgentSelectResponse(@JsonProperty("agent") AgentInfo agent) {
     }
 
+    // ===== Internal response types for MCP API =====
+
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    private record McpListResponse(@JsonProperty("servers") List<McpServerInfo> servers) {
+    }
+
 }

src/main/java/com/github/copilot/sdk/events/AbstractSessionEvent.java

@@ -55,7 +55,7 @@ public abstract sealed class AbstractSessionEvent permits
         SessionModelChangeEvent, SessionModeChangedEvent, SessionPlanChangedEvent, SessionWorkspaceFileChangedEvent,
         SessionHandoffEvent, SessionTruncationEvent, SessionSnapshotRewindEvent, SessionUsageInfoEvent,
         SessionCompactionStartEvent, SessionCompactionCompleteEvent, SessionShutdownEvent, SessionContextChangedEvent,
-        SessionTaskCompleteEvent,
+        SessionTaskCompleteEvent, SessionMcpServersLoadedEvent, SessionMcpServerStatusChangedEvent,
         // Assistant events
         AssistantTurnStartEvent, AssistantIntentEvent, AssistantReasoningEvent, AssistantReasoningDeltaEvent,
         AssistantMessageEvent, AssistantMessageDeltaEvent, AssistantStreamingDeltaEvent, AssistantTurnEndEvent,

src/main/java/com/github/copilot/sdk/events/SessionEventParser.java

@@ -66,6 +66,8 @@ public class SessionEventParser {
         TYPE_MAP.put("session.compaction_complete", SessionCompactionCompleteEvent.class);
         TYPE_MAP.put("session.context_changed", SessionContextChangedEvent.class);
         TYPE_MAP.put("session.task_complete", SessionTaskCompleteEvent.class);
+        TYPE_MAP.put("session.mcp_servers_loaded", SessionMcpServersLoadedEvent.class);
+        TYPE_MAP.put("session.mcp_server_status_changed", SessionMcpServerStatusChangedEvent.class);
         TYPE_MAP.put("user.message", UserMessageEvent.class);
         TYPE_MAP.put("pending_messages.modified", PendingMessagesModifiedEvent.class);
         TYPE_MAP.put("assistant.turn_start", AssistantTurnStartEvent.class);

src/main/java/com/github/copilot/sdk/events/SessionMcpServerStatusChangedEvent.java

@@ -0,0 +1,90 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.events;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Event: session.mcp_server_status_changed
+ * <p>
+ * Fired when the connection status of an MCP server changes during the session
+ * (e.g., from {@code pending} to {@code connected} or {@code failed}).
+ *
+ * @since 1.0.0
+ */
+@JsonIgnoreProperties(ignoreUnknown = true)
+public final class SessionMcpServerStatusChangedEvent extends AbstractSessionEvent {
+
+    @JsonProperty("data")
+    private SessionMcpServerStatusChangedData data;
+
+    @Override
+    public String getType() {
+        return "session.mcp_server_status_changed";
+    }
+
+    public SessionMcpServerStatusChangedData getData() {
+        return data;
+    }
+
+    public void setData(SessionMcpServerStatusChangedData data) {
+        this.data = data;
+    }
+
+    /**
+     * Data payload for the {@code session.mcp_server_status_changed} event.
+     */
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public static class SessionMcpServerStatusChangedData {
+
+        @JsonProperty("serverName")
+        private String serverName;
+
+        @JsonProperty("status")
+        private String status;
+
+        /**
+         * Gets the name of the MCP server whose status changed.
+         *
+         * @return the server name
+         */
+        public String getServerName() {
+            return serverName;
+        }
+
+        /**
+         * Sets the server name.
+         *
+         * @param serverName
+         *            the server name
+         */
+        public void setServerName(String serverName) {
+            this.serverName = serverName;
+        }
+
+        /**
+         * Gets the new connection status.
+         * <p>
+         * Possible values: {@code "connected"}, {@code "failed"}, {@code "pending"},
+         * {@code "disabled"}, {@code "not_configured"}.
+         *
+         * @return the status string
+         */
+        public String getStatus() {
+            return status;
+        }
+
+        /**
+         * Sets the new connection status.
+         *
+         * @param status
+         *            the status string
+         */
+        public void setStatus(String status) {
+            this.status = status;
+        }
+    }
+}

src/main/java/com/github/copilot/sdk/events/SessionMcpServersLoadedEvent.java

@@ -0,0 +1,68 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *--------------------------------------------------------------------------------------------*/
+
+package com.github.copilot.sdk.events;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.copilot.sdk.json.McpServerInfo;
+
+import java.util.List;
+
+/**
+ * Event: session.mcp_servers_loaded
+ * <p>
+ * Fired after all MCP servers have been initialized for the session. Contains a
+ * summary of each server's connection status.
+ *
+ * @since 1.0.0
+ */
+@JsonIgnoreProperties(ignoreUnknown = true)
+public final class SessionMcpServersLoadedEvent extends AbstractSessionEvent {
+
+    @JsonProperty("data")
+    private SessionMcpServersLoadedData data;
+
+    @Override
+    public String getType() {
+        return "session.mcp_servers_loaded";
+    }
+
+    public SessionMcpServersLoadedData getData() {
+        return data;
+    }
+
+    public void setData(SessionMcpServersLoadedData data) {
+        this.data = data;
+    }
+
+    /**
+     * Data payload for the {@code session.mcp_servers_loaded} event.
+     */
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public static class SessionMcpServersLoadedData {
+
+        @JsonProperty("servers")
+        private List<McpServerInfo> servers;
+
+        /**
+         * Gets the list of MCP server status summaries.
+         *
+         * @return the servers list
+         */
+        public List<McpServerInfo> getServers() {
+            return servers;
+        }
+
+        /**
+         * Sets the list of MCP server status summaries.
+         *
+         * @param servers
+         *            the servers list
+         */
+        public void setServers(List<McpServerInfo> servers) {
+            this.servers = servers;
+        }
+    }
+}

src/main/java/com/github/copilot/sdk/events/package-info.java

@@ -52,6 +52,14 @@
  * execution progress update</li>
  * </ul>
  *
+ * <h3>MCP Server Events</h3>
+ * <ul>
+ * <li>{@link com.github.copilot.sdk.events.SessionMcpServersLoadedEvent} - MCP
+ * servers have been initialized</li>
+ * <li>{@link com.github.copilot.sdk.events.SessionMcpServerStatusChangedEvent}
+ * - An MCP server's connection status changed</li>
+ * </ul>
+ *
  * <h3>Subagent Events</h3>
  * <ul>
  * <li>{@link com.github.copilot.sdk.events.SubagentSelectedEvent} - Subagent