Skip to main content
LangBot can call tools from MCP servers. Once an MCP server is added, the built-in Agent — with tool use enabled on its model — can invoke those tools during a conversation.
Install from LangBot Space for the smoothest setup — listed MCPs are pre-configured and ready to use.You can also fetch from ModelScope, mcp.so, or composio.dev, then add them manually as shown below.

​
Two Transport Modes

ModeWhen to useNotes
Remote (mode: "remote")Remote MCP service — just paste the URLLangBot connects to the remote URL directly and auto-detects the transport (tries Streamable HTTP first, falls back to SSE) — no need to choose by hand
Local / stdio (mode: "stdio")MCP server launched by a local commandOnly available when Box Runtime is up
Earlier versions split the remote mode into separate http (Streamable HTTP) and sse options; these are now unified into a single remote mode, with the transport auto-detected by the backend. Existing http / sse rows in the database are normalized to remote on upgrade, and their connection args (URL, headers, timeout) are preserved unchanged.
MCP tools require the pipeline to use the built-in Agent, with a model that has tool use enabled — see Models. External runners (Dify, n8n, Langflow, Coze, etc.) use their own tool mechanisms.

​
Installing an MCP Server

​
From LangBot Space (Preferred)

LangBot Space is the official LangBot marketplace, with a curated list of ready-to-use MCP servers. In the WebUI, browse and install them with one click under Plugin Management → MCP Management — URL, command, and mode are filled in by the listing, so nothing has to be configured by hand. This covers most cases. For services that aren’t listed, use the manual flow below.

​
Adding Manually

Open Plugin Management → MCP Management: MCP management page Click Add in the top right, choose Add MCP Server, pick Local (stdio) or Remote mode: for remote just paste the URL, for local fill in the launch command. Click Test to verify connectivity, then Submit: create new MCP server After saving, toggle the switch on the card to connect. Click the card to see details: MCP server detail

​
Enabling in a Pipeline

Once an MCP server is added, the pipeline extension config decides which servers the Agent can see:
  • Enable “all MCP servers”, or
  • Bind only specific MCP servers
Tools from unbound servers won’t appear in that pipeline’s tool list.

​
Advanced: stdio MCP

stdio MCP is hosted by Box Runtime. Before the connection is ready, LangBot:
  1. Creates or reuses a shared MCP Box session
  2. If a local project path can be inferred from the command, stages the project into the workspace
  3. Installs dependencies if the project has requirements.txt, pyproject.toml, setup.py, or setup.cfg
  4. Connects the MCP process’s stdin/stdout through a WebSocket relay
To fine-tune mount, network, or timeout behavior, add a box override under the MCP extra_args: 
{
  "mode": "stdio",
  "extra_args": {
    "command": "python",
    "args": ["server.py"],
    "env": {},
    "box": {
      "host_path": "/path/to/mcp-project",
      "network": "on",
      "host_path_mode": "ro",
      "startup_timeout_sec": 120,
      "image": "python:3.11-slim"
    }
  }
}
Common fields:
FieldNotes
host_pathMCP project directory on the host. Must be within box.local.allowed_mount_roots
networkWhether network is allowed (typically for dependency install)
host_path_modeAccess mode when staging host_path; defaults to ro. stdio MCP usually stages into the workspace
startup_timeout_secBox prep + dependency install timeout, default 120s. Connection wait gets about 30s extra
imageRuntime image when the Docker backend is used
memory_mbPer-server memory cap (MB); overrides global box.default_memory_mb for this server
stdio MCP runs inside Box. Dependency install and process startup are subject to the sandbox profile, network permission, resource limits, and the mount allowlist.

​
Common Issues

SymptomWhat to check
MCP connection failsURL, command, arguments, env vars are correct
stdio MCP stuck connectingBox Runtime status; startup_timeout_sec may be too short
Dependency install failsSandbox network permission; dependency files are correct
Local files inaccessiblehost_path exists; it’s inside allowed_mount_roots
Agent doesn’t see MCP toolsPipeline uses built-in Agent; model has tool use enabled; MCP is bound on the pipeline