Skip to content

MCP & Tools Configuration

Model Context Protocol (MCP) and tool system settings.

MCP Settings

VariableDefaultSensitiveDescription
ENABLE_MCPtrueNoEnable MCP tool system.
MCP_ENCRYPTION_SALT(auto-generated)YesSalt for encrypting MCP secrets. Auto-generated if not set. Recommended to set for consistency across restarts.

Deferred Tool Loading

For MCP servers with many tools, deferred loading reduces prompt size by loading tools on-demand.

VariableDefaultDescription
ENABLE_DEFERRED_TOOL_LOADINGtrueEnable deferred/lazy tool loading.
DEFERRED_TOOL_THRESHOLD20Tool count threshold to trigger deferred loading.
DEFERRED_TOOL_SEARCH_LIMIT25Maximum tools returned in a search.
DEFERRED_TOOL_PROMPT_LIMIT25Maximum tools included in a prompt.

Skills

VariableDefaultDescription
ENABLE_SKILLStrueEnable the skills system.

Audio Transcription

VariableDefaultSensitiveDescription
ENABLE_AUDIO_TRANSCRIPTIONfalseNoEnable audio transcription tool.
AUDIO_TRANSCRIPTION_API_KEY(empty)YesTranscription API key.
AUDIO_TRANSCRIPTION_BASE_URL(empty)NoTranscription API base URL.
AUDIO_TRANSCRIPTION_MODELgpt-4o-mini-transcribeNoTranscription model name.

Example

bash
# MCP
ENABLE_MCP=true
MCP_ENCRYPTION_SALT=your-random-salt-here

# Skills
ENABLE_SKILLS=true

# Audio Transcription (optional)
ENABLE_AUDIO_TRANSCRIPTION=true
AUDIO_TRANSCRIPTION_API_KEY=sk-your-key
AUDIO_TRANSCRIPTION_MODEL=gpt-4o-mini-transcribe

TIP

Set MCP_ENCRYPTION_SALT to a stable value in production. If it changes, previously encrypted MCP credentials will become unreadable.