diff --git a/mcp.conf b/mcp.conf
new file mode 100644
index 0000000..d41bd20
--- /dev/null
+++ b/mcp.conf
@@ -0,0 +1,75 @@
+# ==============================================================================
+# MCP Configuration File
+# ==============================================================================
+
+# CHECK STATUS:           ./mcp.sh status
+# VIEW LOGS:              tail -f /path/to/your/logs
+# TOGGLE GIT UPDATES:     kill -USR2 $(cat mcp.pid)
+# SHOW STATUS IN LOGS:    kill -USR1 $(cat mcp.pid)
+# GRACEFUL SHUTDOWN:      kill -TERM $(cat mcp.pid)
+# FORCE SHUTDOWN:         kill -KILL $(cat mcp.pid)
+
+# ------------------------------------------------------------------------------
+# MCP CORE SETTINGS
+# ------------------------------------------------------------------------------
+[mcp]
+
+# PID file location for MCP instance enforcement.
+pid_file = ./mcp.pid
+
+# Main loop interval, from 1 to 3600 seconds.
+interval = 30
+
+# Delay before restarting crashed clients, from 0 to 60 seconds.
+restart_delay = 5
+
+# Logging verbosity level: ERROR, WARN, INFO, DEBUG.
+log_level = INFO
+
+# ------------------------------------------------------------------------------
+# GIT REPOSITORY SETTINGS
+# ------------------------------------------------------------------------------
+[git.default]
+
+# Default git branch to track for updates.
+branch = main
+
+# Git update check interval, from 60 to 86400 seconds.
+check_interval = 300
+
+# Enable/disable automatic git updates globally.
+enabled = true
+
+# ------------------------------------------------------------------------------
+# DEFAULT BOT SETTINGS
+# Applied to all clients unless overridden in individual [client.NAME] sections
+# ------------------------------------------------------------------------------
+[bot.default]
+
+# Default script filename to execute in each client directory.
+script_name = io.js
+
+# Default PID filename within each client directory.
+pid_filename = io.pid
+
+# Default delay between client startups, from 0 to 60 seconds.
+start_stagger = 2
+
+# ------------------------------------------------------------------------------
+# CLIENT CONFIGURATIONS
+# Each [client.NAME] section defines one managed bot instance
+# ------------------------------------------------------------------------------
+
+# Simple client configuration:
+# [client.sample1]
+# directory = ./bots/sample1
+# enabled = true
+
+# Client configuration with overrides:
+# [client.sample2]
+# directory = ./bots/sample2
+# git_branch = stable
+# enabled = true
+# script_name = custom-sample-script.js
+# pid_filename = custom-sample-script.pid
+# start_stagger = 5
\ No newline at end of file