Command Reference

1MCP Agent provides a comprehensive command-line interface for managing MCP servers and desktop application configurations.

Quick Reference

Main Commands

• serve - Start the 1MCP server (default command)
• app - Manage desktop application MCP configurations
• mcp - Manage MCP server configurations
• preset - Manage server presets for dynamic filtering

Global Options

All 1MCP commands support the following global options:

• --help, -h - Show help information
• --version - Show version information
• --config, -c <path> - Specify configuration file path
• --config-dir, -d <path> - Path to the config directory

Environment Variables: All global options can be set via environment variables with the ONE_MCP_ prefix:

• ONE_MCP_CONFIG=/path/to/config.json
• ONE_MCP_CONFIG_DIR=/path/to/config/dir

Command-Specific Options

In addition to global options, each command may have specific options. Use --help with any command to see all available options:

npx -y @1mcp/agent mcp add --help
npx -y @1mcp/agent preset create --help
npx -y @1mcp/agent serve --help

Command Groups

App Commands

Manage desktop application MCP configurations. Consolidate MCP servers from various desktop applications into 1MCP.

npx -y @1mcp/agent app consolidate claude-desktop    # Consolidate Claude Desktop servers
npx -y @1mcp/agent app restore claude-desktop        # Restore original configuration
npx -y @1mcp/agent app list                          # List supported applications

MCP Commands

Manage MCP server configurations within your 1MCP instance.

npx -y @1mcp/agent mcp add myserver --type=stdio --command=node --args=server.js
npx -y @1mcp/agent mcp list                       # List configured servers
npx -y @1mcp/agent mcp status                     # Check server status

Preset Commands

Manage server presets for dynamic filtering and context switching.

npx -y @1mcp/agent preset create dev --filter "web,api,database"
npx -y @1mcp/agent preset list                    # List all presets
npx -y @1mcp/agent preset show development        # Show preset details
npx -y @1mcp/agent preset edit staging           # Edit preset configuration

Serve Command

Start the 1MCP server with various configuration options.

npx -y @1mcp/agent serve                            # Start with default settings
npx -y @1mcp/agent serve --port=3052                # Start on custom port
npx -y @1mcp/agent serve --transport=stdio          # Use stdio transport

Getting Started

If you're new to 1MCP Agent, start with:

1. Installation Guide - Install 1MCP Agent
2. Quick Start - Basic setup and first server
3. App Commands - Consolidate existing MCP configurations
4. MCP Commands - Add and manage MCP servers
5. Preset Commands - Create and manage server presets

Examples

Basic Usage

# Start 1MCP server
npx -y @1mcp/agent serve

# Add a new MCP server
npx -y @1mcp/agent mcp add filesystem --type=stdio --command=mcp-server-filesystem

# Consolidate Claude Desktop configuration
npx -y @1mcp/agent app consolidate claude-desktop

# Check status
npx -y @1mcp/agent mcp status

Advanced Usage

# Start with custom configuration
npx -y @1mcp/agent serve --config=/custom/path/config.json --port=3052

# Add HTTP-based MCP server
npx -y @1mcp/agent mcp add remote-api --type=http --url=https://api.example.com/mcp

# Bulk consolidate multiple applications
npx -y @1mcp/agent app consolidate claude-desktop cursor vscode --yes

# Filter servers by tags with detailed information
ONE_MCP_LOG_LEVEL=debug npx -y @1mcp/agent mcp list --tags=prod,api

# Create and use presets for dynamic server selection
npx -y @1mcp/agent preset create production --filter "web AND database AND monitoring"
npx -y @1mcp/agent preset url production

Environment Variables

All command-line options can also be set via environment variables with the ONE_MCP_ prefix:

export ONE_MCP_PORT=3052
export ONE_MCP_HOST=0.0.0.0
export ONE_MCP_CONFIG_PATH=/custom/config.json

Configuration Files

1MCP Agent uses JSON configuration files to store server definitions and settings. See the Configuration Guide for detailed information about configuration file formats and options.