Skip to content

Config reference: mcp

  • Enterprise tuning surface

    Defaults + constraints are rendered directly from Pydantic.

  • Env keys when available

    Many fields have an env-style alias (from TriBridConfig.to_flat_dict()).

  • Tooltip-level guidance

    If a matching glossary entry exists, you’ll see deeper tuning notes.

Config reference Config API & workflow Glossary

Total parameters: 10

Group index
  • (root)

(root)

JSON key Env key(s) Type Default Constraints Summary
mcp.allowed_hosts — list[str] ["localhost:*", "127.0.0.1:*"] — Allowed Host header values for MCP HTTP (supports wildcard ':*').
mcp.allowed_origins — list[str] ["http://localhost:*", "http://127.0.0.1:*"] — Allowed Origin header values for MCP HTTP (supports wildcard ':*').
mcp.default_mode MCP_DEFAULT_MODE Literal["tribrid", "dense_only", "sparse_only", "graph_only"] "tribrid" allowed="tribrid", "dense_only", "sparse_only", "graph_only" Default retrieval mode for MCP search/answer tools when not provided.
mcp.default_top_k MCP_DEFAULT_TOP_K int 20 ≥ 1, ≤ 200 Default top_k for MCP search/answer tools when not provided.
mcp.enable_dns_rebinding_protection MCP_HTTP_DNS_REBIND_PROTECTION bool true — Enable DNS rebinding protection for MCP HTTP (recommended).
mcp.enabled MCP_HTTP_ENABLED bool true — Enable the embedded MCP Streamable HTTP server.
mcp.json_response MCP_HTTP_JSON_RESPONSE bool true — Prefer JSON responses for MCP Streamable HTTP (recommended).
mcp.mount_path MCP_HTTP_PATH str "/mcp" — Mount path for the MCP Streamable HTTP endpoint (e.g. /mcp).
mcp.require_api_key MCP_REQUIRE_API_KEY bool false — Require Authorization: Bearer $MCP_API_KEY for MCP HTTP access.
mcp.stateless_http MCP_HTTP_STATELESS bool true — Run MCP Streamable HTTP in stateless mode (recommended).

Details (glossary)

mcp.mount_path (MCP_HTTP_PATH) — MCP HTTP Path

Category: general

URL path for the HTTP MCP endpoint (default /mcp). Example: http://localhost:8013/mcp. Customize for reverse proxies or routing needs. Must match client configuration if changed.

Links: - URL Structure - URI Standard - MCP Specification