Host integrations API (MCP)

Host integrations API (MCP)

LevPRO AI runtime is an API runtime. Third-party hosts (Desktop, IDE plugins, bots, custom launchers) inject MCP servers through an LM Studio–compatible mcp.json, plus optional CLI/env path overrides.

Surfaces

Surface How hosts inject
{runtime_data_dir}/mcp.json LM Studio–compatible MCP file (sole server source)
config.yaml mcp.external_path only (no YAML servers)
CLI --mcp-config PATH
Env LOCAL_AI_MCP_CONFIG
Embed create_app(config=...) after setting Config.mcp.external_path
Stdio local-ai serve-stdio — same config/CLI/env; NDJSON chat API

MCP

  1. Place servers in mcp.json (mcpServers map).
  2. Point Core at the file via default path, mcp.external_path, --mcp-config, or LOCAL_AI_MCP_CONFIG.
  3. Tools appear as mcp_{server}_{tool} and are auto-granted to agents.
  4. Supports stdio (command/args/env) and HTTP (url/headers).

Details: mcp.md.

local-ai serve-stdio --config config.yaml --mcp-config ~/.my-app/mcp.json
export LOCAL_AI_MCP_CONFIG=/path/to/mcp.json

Native tools (not MCP)

  • report_inability — always on
  • load_message — when message archive enabled
  • load_tool_result / search_tool_results — when memory enabled

Not part of Core

  • ZIP download / unpack UI
  • Plugin store / marketplace
  • Bundled filesystem/shell MCP servers (hosts supply those via mcp.json)

create_app() always applies env overrides and merges mcp.json before wiring tools.