Skip to main content

Tools Configuration

KhunQuant ships with 60+ built-in tools. The tools section of config.json controls which tools are enabled, what paths are accessible, and rate limits for external calls.

Key fields (tools)​

FieldTypeDefaultDescription
filter_sensitive_databoolfalseScrub secrets from tool output before sending to LLM
filter_min_lengthint0Minimum string length before sensitive-data filter runs
allow_read_paths[]string[]Filesystem paths the agent may read
allow_write_paths[]string[]Filesystem paths the agent may write

Tool categories​

Filesystem​

read_file · write_file · edit_file · append_file · list_dir

Execution​

exec (shell) · spawn (subagent) · cron (scheduled tasks) · subagent

Web & Discovery​

web_search · web_fetch · tool_search_bm25 · tool_search_regex · find_skills · install_skill

Market Data​

get_ticker · get_tickers · get_ohlcv · get_orderbook · get_markets

Order Execution​

create_order · cancel_order · get_order · get_open_orders · get_order_history · get_trade_history · emergency_stop

Portfolio & Account​

get_assets_list · get_total_value · list_portfolios · transfer_funds · paper_trade

Technical Analysis​

calculate_indicators (RSI, MACD, BB, EMA, …) · market_analysis · portfolio_allocation

Alerts​

set_price_alert · set_indicator_alert

Snapshots​

take_snapshot · query_snapshots · snapshot_summary · delete_snapshots

Hardware (Linux only)​

i2c · spi

MCP​

mcp_tool — wraps any MCP server tool dynamically

Hidden tools​

Tools that are rarely needed start as hidden to reduce system prompt token cost. The agent can discover and unlock them at runtime using tool_search_bm25 or tool_search_regex. Hidden tools are promoted for one turn then expire back to hidden.

Example config snippet​

{
  "tools": {
    "filter_sensitive_data": true,
    "allow_read_paths": ["~/.khunquant/workspace"],
    "allow_write_paths": ["~/.khunquant/workspace"],
    "web": {
      "search_provider": "brave",
      "brave_api_key": "BRAVE_API_KEY"
    },
    "exec": {
      "enabled": true,
      "allow_commands": ["python3", "node"]
    }
  }
}