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
- Place servers in
mcp.json(mcpServersmap). - Point Core at the file via default path,
mcp.external_path,--mcp-config, orLOCAL_AI_MCP_CONFIG. - Tools appear as
mcp_{server}_{tool}and are auto-granted to agents. - 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 onload_message— when message archive enabledload_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.