Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / mcp

Function: mcp()

ts
function mcp(cfg): McpToolSource;

Defined in: packages/core/src/tools/mcp.ts:303

Imports MCP tools as a McpToolSource. The client connects lazily on the first tools() call; tools/list is fetched with cursor pagination until exhaustion and cached per session; a listChanged notification invalidates the cache, affecting subsequently spawned agents only (a spawn's toolset snapshot is immutable by construction). The host owns the source's lifecycle: close() releases the client, the transport, and the stdio child once the runs using the source have settled; a one shot host should close in a finally block, or its process never exits naturally (v1.33.0 review P2).

Parameters

ParameterType
cfgMcpConfig

Returns

McpToolSource