MCP Commands

Manage MCP server configurations within your 1MCP instance.

These commands allow you to discover, install, configure, and manage the lifecycle of MCP servers through both manual configuration and the 1MCP registry.

For a detailed guide on server management, including registry-based installation and best practices, please see the Server Management Guide.

Registry-Based Commands (Recommended)

install

Install MCP servers from the 1MCP registry with automatic dependency resolution and version management.

npx -y @1mcp/agent mcp install filesystem
npx -y @1mcp/agent mcp install --interactive

uninstall

Safely remove MCP servers with automatic backup creation and dependency validation.

npx -y @1mcp/agent mcp uninstall filesystem
npx -y @1mcp/agent mcp uninstall test-server --force

search

Search the MCP registry for available servers.

npx -y @1mcp/agent mcp search database
npx -y @1mcp/agent mcp search --category=filesystem

Manual Configuration Commands

add

Manually add a new MCP server to the configuration.

npx -y @1mcp/agent mcp add my-server --type=stdio --command="node server.js"

remove

Remove an MCP server from the configuration.

npx -y @1mcp/agent mcp remove my-server

update

Update an existing MCP server's configuration.

npx -y @1mcp/agent mcp update my-server --tags=prod

enable / disable

Enable or disable an MCP server without removing it.

npx -y @1mcp/agent mcp disable my-server

list

List all configured MCP servers.

npx -y @1mcp/agent mcp list --tags=prod

status

Check the status and details of configured servers.

npx -y @1mcp/agent mcp status my-server

tokens

Estimate MCP token usage for server capabilities by connecting to servers and analyzing their tools, resources, and prompts.

npx -y @1mcp/agent mcp tokens --model=gpt-3.5-turbo --format=summary

See Also

• Server Management Guide
• Registry Commands - Server discovery and installation
• App Consolidation Guide