|
<< Click to Display Table of Contents >> Navigation: 3. Script Language > Internet and Network > MCP. - MCP (Model-Context Protocol) server operations > Server Operations - Server control and execution > MCP Commands - Server Management |
MiniRobot Language (MRL) - MCP Server Management Commands
MCP.RegisterWithHost
Register with Host
Purpose
The MCP.RegisterWithHost command registers the MCP server with a host application or client. This registration establishes a communication channel between the MCP server and the host, enabling the host to invoke MCP tools and receive responses. It is typically used when integrating the MCP server with custom applications or alternative AI platforms.
This command is particularly useful when:
• Integrating with custom host applications
• Connecting to third-party MCP clients
• Setting up distributed MCP environments
• Registering with alternative AI platforms
Syntax
MCP.RegisterWithHost|$$HOST_URL|$$API_KEY|$$RETURN_VAR
Parameters
$$HOST_URL - The URL of the host application API endpoint.
$$API_KEY - The authentication key or token for the host (use empty string if not required).
$$RETURN_VAR - The variable that will receive the registration result status.
Return Value
The command populates $$RETURN_VAR with a status string containing:
SUCCESS - Registration completed successfully
ERROR: [message] - Registration failed with error description
Examples
' Example 1: Register with a custom host
MCP.RegisterWithHost|http://localhost:8080/api/mcp||$$Result
PRT.Host registration: $$Result
' Example 2: Register with authentication
$$ApiKey=my-secret-api-key-12345
MCP.RegisterWithHost|https://ai.example.com/mcp|$$ApiKey|$$Status
SCH.In|$$Status|SUCCESS|$$Ok
IVV.$$Ok!0
PRT.Connected to remote host
ELS.
PRT.Connection failed: $$Status
EIF.
' Example 3: Register with host from configuration
MEM.RCL|$$MCP_HOST_URL|$$HostUrl
MEM.RCL|$$MCP_API_KEY|$$Key
MCP.RegisterWithHost|$$HostUrl|$$Key|$$RegStatus
Remarks
The MCP.RegisterWithHost command establishes a connection between the MCP server and a host application. The host must implement the MCP protocol and expose the appropriate endpoints for registration and tool invocation.
Unlike MCP.RegisterLMStudio which is specific to LM Studio, this command provides a generic registration mechanism that can be used with any MCP-compatible host application. The API key parameter can be left empty if the host does not require authentication.
The registration remains active until explicitly disconnected or until the connection times out. Some hosts may require periodic re-registration or keep-alive messages.
Error Conditions
The command will fail with an error if:
• The host URL parameter is missing or invalid
• The return variable parameter is missing
• The host is not reachable or not responding
• Authentication fails (invalid API key)
• The host rejects the registration request
• Network connectivity issues prevent connection
See also:
• MCP.RegisterLMStudio - Register with LM Studio
• MCP.WriteConfig - Write Configuration