curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/mcps" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"mcp_ids": ["dir_5e6f7a"]}'
runtm-api session load-mcps a6414511-4430-4e1f-8c51-8ea8824dadec dir_5e6f7a
{
"loaded": [{"id": "dir_5e6f7a", "name": "notion"}],
"needs_auth": [],
"skipped": []
}
Capabilities
Load MCP Servers
Hot-load MCP servers into a running session
POST
/
api
/
sessions
/
{session_id}
/
mcps
curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/mcps" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"mcp_ids": ["dir_5e6f7a"]}'
runtm-api session load-mcps a6414511-4430-4e1f-8c51-8ea8824dadec dir_5e6f7a
{
"loaded": [{"id": "dir_5e6f7a", "name": "notion"}],
"needs_auth": [],
"skipped": []
}
Loads MCP servers into a running sandbox without a template rebuild. IDs are agent-directive IDs (from List MCP Servers with
type_family=mcp). Servers whose connections still need credentials are reported under needs_auth rather than failing the call.
Required scope: sessions:write
Path Parameters
string
required
The session ID.
Request Body
string[]
required
Agent-directive IDs of the MCP servers to load.
Response
array
{id, name} for each server that loaded.string[]
Servers skipped because their connection has no credentials yet.
string[]
IDs that were unknown or not MCP servers.
curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/mcps" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"mcp_ids": ["dir_5e6f7a"]}'
runtm-api session load-mcps a6414511-4430-4e1f-8c51-8ea8824dadec dir_5e6f7a
{
"loaded": [{"id": "dir_5e6f7a", "name": "notion"}],
"needs_auth": [],
"skipped": []
}