Interface: McpIntegrationStrategy

Makaio Framework / ai-adapters-core / McpIntegrationStrategy

Interface: McpIntegrationStrategy

Defined in: ../../../adapters/core/src/types/mcp-integration.ts:31

Adapter-specific MCP consumption strategy.

Each adapter that supports MCP implements this interface to declare how it consumes MCP tools. Defined in adapter-core to avoid circular dependencies (McpService imports this interface, adapters implement it).

Properties

mode

readonly mode: "native-passthrough" | "tool-injection" | "observe-only"

Defined in: ../../../adapters/core/src/types/mcp-integration.ts:33

What this adapter needs from McpService

supportsMidSessionToolChange

readonly supportsMidSessionToolChange: boolean

Defined in: ../../../adapters/core/src/types/mcp-integration.ts:39

Whether this adapter supports mid-session tool list changes. If false, deferred injection is used (bridge current turn, native next turn).

Methods

onToolsChanged()?

optional onToolsChanged(changes): Promise<void>

Defined in: ../../../adapters/core/src/types/mcp-integration.ts:53

Called when MCP tools change mid-session (server reconnect, dynamic enable). Only invoked if supportsMidSessionToolChange is true.

Parameters

changes

McpToolChange

Description of what tools changed

Returns

Promise<void>

prepareMcpForSession()

prepareMcpForSession(context): Promise<McpSessionResources>

Defined in: ../../../adapters/core/src/types/mcp-integration.ts:46

Called when a session starts. Returns adapter-specific resources.

Parameters

context

Resolved MCP config for this session (post-visibility-chain)

directTools

object[] = ...

Tools resolved as direct-inject for this session

discoverableTools

object[] = ...

Tools available for discovery in this session

profileId

string | null = ...

Profile identifier (null for default)

projectId

string | null = ...

Project identifier (null for global)

servers

object[] = ...

Servers enabled for this session (post-project-filter)

sessionId

string = ...

Session identifier

Returns

Promise<McpSessionResources>

Resources the adapter needs to consume MCP tools