nat.plugins.a365.tooling.service

A365 tooling service for MCP server discovery and configuration.

Classes

A365ToolingService

Service for discovering and configuring MCP tool servers from Agent 365.

Module Contents

class A365ToolingService(logger: logging.Logger | None = None)

Service for discovering and configuring MCP tool servers from Agent 365.

This service wraps the A365 SDK’s McpToolServerConfigurationService to provide a NAT-friendly interface for discovering MCP servers configured for an agent.

Initialize the A365 tooling service.

Args:

logger: Optional logger instance. Defaults to module logger if not provided.

_logger

_service

async list_tool_servers(

agentic_app_id: str,

auth_token: str,

) → list[microsoft_agents_a365.tooling.MCPServerConfig]

Get the list of MCP servers configured for the agent.

In development mode (ENVIRONMENT=Development), reads from ToolingManifest.json. In production mode, retrieves configuration from the A365 tooling gateway.

Args:

agentic_app_id: The Agent 365 agentic app ID. auth_token: Authentication token for accessing the tooling gateway.

Returns:

List of MCPServerConfig objects representing configured MCP servers.

Raises:

ValueError: If required parameters are invalid or empty. Exception: If there’s an error communicating with the tooling gateway or reading the manifest file.

Example:

servers = await service.list_tool_servers(
    agentic_app_id="my-agent-123",
    auth_token="bearer-token-here"
)