Daemon Configuration

Global Configuration

Precedence

The order of precedence for these options is: CLI flag > configuration file > default value

The mcpd daemon command supports persistent configuration through configuration files and CLI commands. This allows you to configure API server settings, CORS policies, and various timeout values that persist across daemon restarts.

The daemon configuration is managed using the following commands:

• mcpd config daemon get [key] - Retrieve configuration values
• mcpd config daemon set <key=value> - Set configuration values
• mcpd config daemon remove <key> - Remove configuration values
• mcpd config daemon list - List currently configured and all available configuration keys
• mcpd config daemon validate - Validate current configuration

For further information, please visit our CLI Overview.

---

Configuration Structure

The daemon configuration is organized into two main sections:

API Configuration (api.*)

Controls the HTTP API server settings.

Setting	Type	Description	Default	Example
api.addr	string	Server bind address (host:port)	0.0.0.0:8090	localhost:8080
api.timeout.shutdown	duration	Graceful shutdown timeout	30s	60s

CORS Configuration (api.cors.*)

Cross-Origin Resource Sharing settings for browser clients.

Setting	Type	Description	Default	Example
api.cors.enable	bool	Enable CORS support	false	true
api.cors.allow_origins	[]string	Allowed request origins	["*"]	["localhost:3000", "https://app.example.com"]
api.cors.allow_methods	[]string	Allowed HTTP methods	["GET", "POST", "PUT", "DELETE"]	["GET", "POST"]
api.cors.allow_headers	[]string	Allowed request headers	["Content-Type", "Authorization"]	["Content-Type", "API-Key"]
api.cors.expose_headers	[]string	Headers exposed to client	[]	["ETag", "Last-Modified"]
api.cors.allow_credentials	bool	Allow credentials in requests	false	true
api.cors.max_age	duration	Preflight cache duration	0s	24h

MCP Configuration (mcp.*)

Model Context Protocol server management settings.

Setting	Type	Description	Default	Example
mcp.timeout.init	duration	Server initialization timeout	30s	60s
mcp.timeout.shutdown	duration	Server shutdown timeout	10s	30s
mcp.timeout.health	duration	Health check timeout	5s	10s
mcp.timeout.request	duration	Tool call request timeout	15s	60s
mcp.interval.health	duration	Health check interval	30s	60s

Configuration Examples

Basic API Configuration

# Set server address
mcpd config daemon set api.addr="localhost:8080"

# Configure shutdown timeout
mcpd config daemon set api.timeout.shutdown="60s"

CORS Configuration

# Enable CORS
mcpd config daemon set api.cors.enable=true

# Set allowed origins
mcpd config daemon set api.cors.allow_origins="localhost:3000,https://app.example.com"

# Allow credentials
mcpd config daemon set api.cors.allow_credentials=true

# Set preflight cache duration
mcpd config daemon set api.cors.max_age="24h"

MCP Server Configuration

# Set longer initialization timeout
mcpd config daemon set mcp.timeout.init="60s"

# Configure health check frequency
mcpd config daemon set mcp.interval.health="60s"

# Set health check timeout
mcpd config daemon set mcp.timeout.health="10s"

# Set tool call request timeout
mcpd config daemon set mcp.timeout.request="60s"

Retrieving Configuration

# Get all configuration
mcpd config daemon get

# Get API configuration only
mcpd config daemon get api

# Get specific setting
mcpd config daemon get api.cors.enable

# List all configured keys
mcpd config daemon list

# List all available keys
mcpd config daemon list --available

Removing Configuration

# Remove a specific setting (reverts to default)
mcpd config daemon remove api.cors.enable

# Remove entire section
mcpd config daemon remove api.cors

# Remove multiple settings
mcpd config daemon remove api.cors.enable api.cors.max_age

Configuration File Storage

Configuration is stored in the .mcpd.toml file in TOML format:

[[servers]]
  name = "time"
  package = "uvx::mcp-server-time@2025.8.4"
  tools = ["get_current_time", "convert_time"]

[daemon]
  [daemon.api]
    addr = "localhost:8080"
    [daemon.api.timeout]
      shutdown = "1m0s"
    [daemon.api.cors]
      enable = true
      allow_origins = ["localhost:3000", "https://app.example.com"]
      allow_credentials = true
      max_age = "24h0m0s"
  [daemon.mcp]
    [daemon.mcp.timeout]
      shutdown = "30s"
      init = "1m0s"
      health = "10s"
    [daemon.mcp.interval]
      health = "1m0s"

Data Types

Duration Format

Duration values follow this time/duration format:

• 30s - 30 seconds
• 5m - 5 minutes
• 2h - 2 hours
• 1m30s - 1 minute 30 seconds

String Arrays

String arrays can be provided as comma-separated values:

mcpd config daemon set api.cors.allow_origins "localhost:3000,https://app.example.com"

Boolean Values

Boolean values should use: true, false.

Configuration Validation

Use the validate command to check your configuration:

mcpd config daemon validate

Common validation errors:

• Invalid address formats (must be host:port)
• Invalid duration formats
• Invalid CORS origin URLs

For step-by-step diagnosis of browser requests, CORS issues, or unexpected API addresses, see Troubleshooting.