Serve Command

Start the 1MCP server with various transport and configuration options.

Synopsis

npx -y @1mcp/agent [serve] [options]
npx -y @1mcp/agent [options]  # serve is the default command

Description

The serve command starts the 1MCP server, which acts as a unified proxy/multiplexer for multiple MCP servers. It can operate in different transport modes and provides a unified interface for MCP clients.

For a complete list of command-line flags, environment variables, and JSON configuration options, please see the **Configuration Deep Dive

Examples

Basic Usage

# Start with default settings (HTTP on localhost:3051)
npx -y @1mcp/agent serve

# Start on custom port
npx -y @1mcp/agent serve --port=3052

# Start with stdio transport
npx -y @1mcp/agent serve --transport=stdio

Custom Configuration

# Use custom configuration file
npx -y @1mcp/agent serve --config=/path/to/config.json

# Start with debug logging
npx -y @1mcp/agent serve --log-level=debug --log-file=/var/log/npx -y @1mcp/agent.log

Production Deployment

# Production HTTP server with authentication
npx -y @1mcp/agent serve \
  --host=0.0.0.0 \
  --port=3051 \
  --auth \
  --enhanced-security \
  --trust-proxy=true

# With external URL for OAuth redirects
npx -y @1mcp/agent serve \
  --external-url=https://mcp.yourdomain.com \
  --auth

Development

# Development with debug logging and file watching
npx -y @1mcp/agent serve \
  --log-level=debug \
  --health-info-level=full

See Also

• Configuration Deep Dive
• Security Guide
• Health Check API Reference