page:docs-agent-mux-tutorials-plugins
Plugins (MCP) reference
agent-mux normalizes plugin management across adapters that support the Model Context Protocol. Under the hood it writes to each agent's MCP config file.
Plugins (MCP)
agent-mux normalizes plugin management across adapters that support the **Model Context Protocol**. Under the hood it writes to each agent's MCP config file.
Which adapters support plugins?
| Adapter | supportsPlugins |
|---|---|
claude | yes |
cursor | yes |
gemini | yes |
opencode | yes |
openclaw | yes |
codex, copilot, hermes, pi, omp, agent-mux-remote | no |
Install
amux plugin install claude @modelcontextprotocol/server-filesystem \
--arg /workspaceProgrammatic:
await client.installPlugin({
agent: 'claude',
name: 'filesystem',
command: 'npx',
args: ['-y', '@modelcontextprotocol/server-filesystem', '/workspace'],
env: {},
});List
amux plugin list claudeReturns InstalledPlugin[] with the name, command, args, and env currently configured.
Uninstall
amux plugin uninstall claude filesystemWhere it writes
Each adapter points at its native MCP location — e.g. ~/.claude/settings.json for Claude Code, ~/.config/gemini/settings.json for Gemini. See the per-agent page for the exact file.
Registry
Plugin discovery uses the MCP registry at https://modelcontextprotocol.io. The registry is not currently searchable from the CLI (searchable: false), so you install by name.