MCP & Tools Configuration
Model Context Protocol (MCP) and tool system settings.
MCP Settings
| Variable | Default | Sensitive | Description |
|---|---|---|---|
ENABLE_MCP | true | No | Enable MCP tool system. |
MCP_ENCRYPTION_SALT | (auto-generated) | Yes | Salt 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.
| Variable | Default | Description |
|---|---|---|
ENABLE_DEFERRED_TOOL_LOADING | true | Enable deferred/lazy tool loading. |
DEFERRED_TOOL_THRESHOLD | 20 | Tool count threshold to trigger deferred loading. |
DEFERRED_TOOL_SEARCH_LIMIT | 25 | Maximum tools returned in a search. |
DEFERRED_TOOL_PROMPT_LIMIT | 25 | Maximum tools included in a prompt. |
Skills
| Variable | Default | Description |
|---|---|---|
ENABLE_SKILLS | true | Enable the skills system. |
Code Interpreter
| Variable | Default | Description |
|---|---|---|
ENABLE_CODE_INTERPRETER | false | Enable the experimental QuickJS code interpreter for agent runs. |
Audio Transcription
| Variable | Default | Sensitive | Description |
|---|---|---|---|
ENABLE_AUDIO_TRANSCRIPTION | false | No | Enable audio transcription tool. |
AUDIO_TRANSCRIPTION_API_KEY | (empty) | Yes | Transcription API key. |
AUDIO_TRANSCRIPTION_BASE_URL | (empty) | No | Transcription API base URL. |
AUDIO_TRANSCRIPTION_MODEL | gpt-4o-mini-transcribe | No | Transcription model name. |
Image Generation
| Variable | Default | Sensitive | Description |
|---|---|---|---|
ENABLE_IMAGE_GENERATION | false | No | Enable the image generation tool. |
IMAGE_GENERATION_API_KEY | (empty) | Yes | Image generation API key. |
IMAGE_GENERATION_BASE_URL | https://api.openai.com/v1 | No | OpenAI-compatible image API base URL. |
IMAGE_GENERATION_MODEL | gpt-image-2 | No | Image model name. |
IMAGE_GENERATION_TIMEOUT | 120 | No | Request timeout in seconds. |
Example
bash
# MCP
ENABLE_MCP=true
MCP_ENCRYPTION_SALT=your-random-salt-here
# Skills
ENABLE_SKILLS=true
# Code Interpreter (optional)
ENABLE_CODE_INTERPRETER=false
# Audio Transcription (optional)
ENABLE_AUDIO_TRANSCRIPTION=true
AUDIO_TRANSCRIPTION_API_KEY=sk-your-key
AUDIO_TRANSCRIPTION_MODEL=gpt-4o-mini-transcribe
# Image Generation (optional)
ENABLE_IMAGE_GENERATION=true
IMAGE_GENERATION_API_KEY=sk-your-key
IMAGE_GENERATION_MODEL=gpt-image-2TIP
Set MCP_ENCRYPTION_SALT to a stable value in production. If it changes, previously encrypted MCP credentials will become unreadable.