Share via


McpToolServerConfigurationService class

Service responsible for discovering and normalizing MCP (Model Context Protocol) tool servers and producing configuration objects consumable by the Claude SDK.

Constructors

McpToolServerConfigurationService()

Construct a McpToolServerConfigurationService.

Methods

getMcpClientTools(string, MCPServerConfig)

Connect to the MCP server and return tools with names prefixed by the server name. Throws if the server URL is missing or the client fails to list tools.

listToolServers(string, string)

Return MCP server definitions for the given agent. In development (NODE_ENV=Development) this reads the local ToolingManifest.json; otherwise it queries the remote tooling gateway.

Constructor Details

McpToolServerConfigurationService()

Construct a McpToolServerConfigurationService.

new McpToolServerConfigurationService()

Method Details

getMcpClientTools(string, MCPServerConfig)

Connect to the MCP server and return tools with names prefixed by the server name. Throws if the server URL is missing or the client fails to list tools.

function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>

Parameters

mcpServerName

string

mcpServerConfig
MCPServerConfig

Returns

Promise<McpClientTool[]>

listToolServers(string, string)

Return MCP server definitions for the given agent. In development (NODE_ENV=Development) this reads the local ToolingManifest.json; otherwise it queries the remote tooling gateway.

function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>

Parameters

agenticAppId

string

The agentic app id for which to discover servers.

authToken

string

Optional bearer token used when querying the remote tooling gateway.

Returns

Promise<MCPServerConfig[]>

A promise resolving to an array of normalized MCP server configuration objects.