MCP
Scope: SessionRpc (per-session operations tied to a Session) For an overview of RPC and the list of all RPC pages, see RPC.MCP Apps (experimental)
You can call MCP Apps RPCs from$session->rpc()->mcp()->apps(). listTools() and callTool() require originServerName, the name of the calling MCP server. The result of callTool() is returned as a free-form MCP result.
use Revolution\Copilot\Types\Rpc\MCPAppsDiagnoseRequest;
use Revolution\Copilot\Types\Rpc\MCPAppsListToolsRequest;
use Revolution\Copilot\Types\Rpc\McpAppsCallToolRequest;
use Revolution\Copilot\Types\Rpc\McpAppsReadResourceRequest;
use Revolution\Copilot\Types\Rpc\McpAppsSetHostContextDetails;
use Revolution\Copilot\Types\Rpc\McpAppsSetHostContextRequest;
$apps = $session->rpc()->mcp()->apps();
$tools = $apps->listTools(new MCPAppsListToolsRequest(
serverName: 'my-server',
originServerName: 'my-server',
));
$result = $apps->callTool(new McpAppsCallToolRequest(
serverName: 'my-server',
toolName: 'lookup',
originServerName: 'my-server',
arguments: ['query' => 'hello'],
));
$resource = $apps->readResource(new McpAppsReadResourceRequest(
serverName: 'my-server',
uri: 'ui://my-app/index.html',
));
$context = $apps->getHostContext();
$apps->setHostContext(new McpAppsSetHostContextRequest(
context: new McpAppsSetHostContextDetails(theme: 'dark', locale: 'ja-JP'),
));
$diagnostics = $apps->diagnose(new MCPAppsDiagnoseRequest(serverName: 'my-server'));
readResource() returns resource data such as HTML. The SDK doesn’t render in a browser or manipulate iframes, so rendering the retrieved content is the responsibility of the calling application.
// mcp (experimental: MCP server management)
$servers = $session->rpc()->mcp()->list();
// Configured URL for HTTP/SSE servers: $servers->servers[0]->url
$session->rpc()->mcp()->enable(new McpEnableRequest(serverName: 'server-name'));
$session->rpc()->mcp()->disable(new McpDisableRequest(serverName: 'server-name'));
$session->rpc()->mcp()->reload();
// Move in-progress MCP loading to the background (releases the waiting turn)
$session->rpc()->mcp()->moveLoadingToBackground();
// Start or restart an MCP server in the session (doesn't change persisted settings)
use Revolution\Copilot\Types\Rpc\McpRestartServerRequest;
use Revolution\Copilot\Types\Rpc\McpStartServerRequest;
$session->rpc()->mcp()->startServer(new McpStartServerRequest(
serverName: 'server-name',
config: ['type' => 'http', 'url' => 'https://mcp.example.com'],
));
$session->rpc()->mcp()->restartServer(new McpRestartServerRequest(
serverName: 'server-name',
expectedInstallationId: 'installation-id',
));
// Remove the automatically managed GitHub MCP server and set how environment variable values are resolved
$removed = $session->rpc()->mcp()->removeGitHub();
$mode = $session->rpc()->mcp()->setEnvValueMode(['mode' => 'indirect']);
// $removed->removed, $mode->mode
// Run and cancel MCP sampling
use Revolution\Copilot\Types\Rpc\McpCancelSamplingExecutionParams;
use Revolution\Copilot\Types\Rpc\McpExecuteSamplingParams;
$sampling = $session->rpc()->mcp()->executeSampling(new McpExecuteSamplingParams(
requestId: 'sampling-1',
serverName: 'server-name',
mcpRequestId: 'mcp-request-1',
request: ['messages' => [], 'maxTokens' => 256],
));
$cancelled = $session->rpc()->mcp()->cancelSamplingExecution(
new McpCancelSamplingExecutionParams(requestId: 'sampling-1'),
);
// Check whether an MCP server is running
use Revolution\Copilot\Types\Rpc\McpIsServerRunningRequest;
$result = $session->rpc()->mcp()->isServerRunning(new McpIsServerRunningRequest(serverName: 'my-server'));
// $result->running - Whether the server is running
// Get an MCP server's tool list
use Revolution\Copilot\Types\Rpc\McpListToolsRequest;
$result = $session->rpc()->mcp()->listTools(new McpListToolsRequest(serverName: 'my-server'));
// $result->tools - Array of McpTools (name, description)
// List and get MCP prompts (experimental)
use Revolution\Copilot\Types\Rpc\McpPromptsGetRequest;
use Revolution\Copilot\Types\Rpc\McpPromptsListRequest;
$prompts = $session->rpc()->mcp()->listPrompts(new McpPromptsListRequest(serverName: 'my-server'));
$rendered = $session->rpc()->mcp()->getPrompt(new McpPromptsGetRequest(
serverName: 'my-server',
promptName: 'summarize',
arguments: ['document' => 'README.md'],
));
// $prompts->prompts - MCP prompt definitions
// $rendered->messages - Rendered prompt (not sent to the model)
// Stop an MCP server
use Revolution\Copilot\Types\Rpc\McpStopServerRequest;
$session->rpc()->mcp()->stopServer(new McpStopServerRequest(serverName: 'my-server'));
// Get the list of MCP resources (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesListRequest;
$result = $session->rpc()->mcp()->resources()->list(new McpResourcesListRequest(serverName: 'my-server'));
// $result->resources - Array of McpResource (uri, name, title, mimeType, etc.)
// $result->nextCursor - Cursor for the next page (if any)
// Get an MCP resource (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesReadRequest;
$result = $session->rpc()->mcp()->resources()->read(new McpResourcesReadRequest(serverName: 'my-server', uri: 'ui://example'));
// $result->contents - Array of McpResourceContent
// Get the list of MCP resource templates (experimental)
use Revolution\Copilot\Types\Rpc\McpResourcesListTemplatesRequest;
$result = $session->rpc()->mcp()->resources()->listTemplates(new McpResourcesListTemplatesRequest(serverName: 'my-server'));
// MCP OAuth login (for MCP servers that require authentication)
use Revolution\Copilot\Types\Rpc\McpOauthCompleteRequest;
use Revolution\Copilot\Types\Rpc\McpOauthLoginRequest;
use Revolution\Copilot\Types\Rpc\McpOauthProbeRequest;
use Revolution\Copilot\Types\Rpc\SessionMcpOauthCancelLoginRequest;
use Revolution\Copilot\Types\Rpc\SessionMcpOauthPrepareLoginRequest;
$result = $session->rpc()->mcp()->login(new McpOauthLoginRequest(serverName: 'my-server'));
// $result->authorizationUrl - URL for the OAuth flow (when authentication is required)
// For a host-managed OAuth redirect flow, specify redirectUri and call complete() after the callback
$result = $session->rpc()->mcp()->login(new McpOauthLoginRequest(
serverName: 'my-server',
redirectUri: 'http://localhost:3000/oauth/callback',
));
$session->rpc()->mcp()->complete(new McpOauthCompleteRequest(
authorizationId: $result->authorizationId,
callbackUrl: $callbackUrl,
));
// Check the OAuth state, and prepare or cancel a login tied to an owned installation
$probe = $session->rpc()->mcp()->oauth()->probe(new McpOauthProbeRequest(serverName: 'my-server'));
$prepared = $session->rpc()->mcp()->oauth()->prepareLogin(new SessionMcpOauthPrepareLoginRequest(
serverName: 'my-server',
expectedInstallationId: 'installation-id',
));
$cancelled = $session->rpc()->mcp()->oauth()->cancelLogin(new SessionMcpOauthCancelLoginRequest(
expectedInstallationId: 'installation-id',
loginId: $prepared->loginId,
));
mcp reloadWithConfig (disabled servers on reload)
When you pass configuration toreloadWithConfig(), configuredDisabledServers is the list of servers disabled by settings that your application resolved. Specify it separately from the session-level disabledServers and the CLI’s cliEnabledServers. Settings-based disabling has lower priority than CLI enabling and explicit session disabling, so don’t merge configuredDisabledServers into disabledServers.
$session->rpc()->mcp()->reloadWithConfig([
'config' => [
'mcpServers' => $mcpServers,
'disabledServers' => ['session-disabled'],
'cliEnabledServers' => ['cli-enabled'],
'configuredDisabledServers' => ['settings-disabled'],
],
]);