Required variables
Common runtime variables
| Variable | Default | Purpose |
|---|
PORT | 3001 | HTTP server port |
DZAP_OPENAI_MODEL | gpt-4o-mini | Model override |
DZAP_MODEL_MAX_RETRIES | 2 | Model retry count |
DZAP_MODEL_TIMEOUT_MS | 4500000 | Model timeout |
LOG_LEVEL | info | Runtime logging level |
DB_PATH | schedules.db | Scheduler SQLite path |
CLI-specific variables
| Variable | Purpose |
|---|
DZAP_CLI_DEBUG | Toggle debug output defaults |
DZAP_CONFIRM_TRANSACTIONS | Default transaction confirmation behavior |
RPC override variables
Resolution order for transaction execution:
DZAP_RPC_URL_<chainId>RPC_URL_<chainId>DZAP_RPC_URL- built-in public RPC fallback list
Optional provider keys
| Variable | Used by |
|---|
TAVILY_API_KEY | WebSearchTool and the TrendingNewsTool news fallback |
CRYPTOPANIC_API_KEY | TrendingNewsTool (primary source; falls back to Tavily when unavailable) |
COINSTATS_API_KEY | CoinStats wrapper tools |
MORALIS_API_KEY | Moralis wrapper tools |
TrendingNewsTool tries CryptoPanic first and automatically falls back to a
Tavily news search, so TAVILY_API_KEY is the practical requirement for news.
MCP HTTP server variables
| Variable | Purpose |
|---|
DZAP_MCP_HTTP_ENABLED | Enable/disable the /mcp HTTP transport (default on) |
DZAP_MCP_HTTP_TOKEN | When set, every /mcp request must send Authorization: Bearer <token> |
DZAP_MCP_ALLOWED_ORIGINS | Comma-separated Origin allowlist for /mcp |
Profile file
- macOS/Linux:
~/.dzapai/config.json
- Windows:
%USERPROFILE%\.dzapai\config.json
Example:
{
"wallet": "0xYourAddress",
"chain": "42161",
"blockchain": "evm",
"privateKey": "0x..."
}
Scheduler storage
By default, schedules are persisted to schedules.db in the runtime working directory.
