Skip to main content

Skills, plugins, agents, instructions, and extensions

Scope: ServerRpc (server-wide operations tied to the Client) For an overview of RPC and the list of all RPC pages, see RPC.

Agent Plugin catalog candidates

Require agent-plugin-discovery in catalog.search and specify plugin in the search kinds to get Agent Plugin candidates. To receive application/vnd.anthropic.claude-plugin+json and application/agent-plugin+json in addition to the standard format application/vnd.github.copilot-plugin, require agent-plugin-formats in addition to agent-plugin-discovery. agent-plugin-confirmed-installation is a capability that returns installability and a plan for review. Require it together with agent-plugin-discovery as well. When granted, candidates include installability, whose value is one of installable, install-data-unavailable, feature-disabled, or not-installable-kind. installPlan is included only when installability is installable. The plan is data for review, and this catalog RPC never performs the installation. The plan’s sources contains materialization, marketplace, and repository candidates in priority order. A marketplace records its name and repository, and a direct repository records the repository and an optional path. In a materialization-only plan, pluginName is omitted and components is empty. Check the name and what will actually be installed in the review returned by plugins.planInstall(). For a selected candidate, plugins.planInstall() creates a validated plan with no side effects. plugins.applyInstall() asks the user for explicit confirmation and applies the plan if allowed. The plugin is registered in a disabled state after it’s applied. The review’s mcpServers shows the server names, transport, and, for remote servers, the host declared by the validated files. This isn’t a safety guarantee, so have the user review the contents before giving explicit confirmation. An installed plugin’s description comes from the manifest. verifiedSource shows the GitHub repository and pinned commit, and exists only for direct installs pinned to a commit. iconUrl is external, untrusted content, so don’t send credentials or GitHub credentials when fetching it. Credentials themselves are never returned as refusal reasons. For a network-failure installation result, you can check the CatalogNetworkFailureReason, the HTTP statusCode, an optional retryAfterSeconds, and a message that’s safe to display.
To plan from an Agent Finder materialisation reference, use catalog.planInstallFromReference(). The result’s outcome->kind is one of plugin-install-planned, skill-install-planned, or refused. Pass plugin plans to plugins.applyInstall() and skill plans to skills.applyInstall().

agentRegistry (experimental: agent registry)

Creates, lists, and removes agent registry entries. The list result doesn’t include connection credentials.

LSP (server-wide language server settings)

lsp() lists the server-wide language server settings. For per-session initialization, start, stop, and similar operations, use lsp() on SessionRpc (for usage examples, see Workspaces, agents, Fleet, and skills).
Last modified on November 19, 2026