<< Click to Display Table of Contents >> Navigation:  3. Script Language > Internet and Network > MCP. - MCP (Model-Context Protocol) server operations > Functional Memory - Tool execution and security management (SLL-ONLY) > MCP Commands - Functional Memory

---

MiniRobot Language (MRL) - Functional Memory (SPR only - not in public MCP-Server)

 

⚡ SPR only - not in public MCP-Server FEATURE

This command is only available when using the MCP server as an SLL (Server-Side Library). It cannot be called via HTTP/MCP protocol.

 

MCP.Move / MCP.FM.Move

Move result from FM to permanent memory

 

Syntax

 

MCP.Move|$$SOURCE_KEY|$$DEST_KEY|$$RETURN_VAR

MCP.FM.Move|$$SOURCE_KEY|$$DEST_KEY|$$RETURN_VAR

 

Parameters

 

$$SOURCE_KEY

The Functional Memory key to read from (e.g., "FileTools::ReadFile", "DataTools::Query").

 

$$DEST_KEY

The destination key in standard (permanent) memory where the result should be stored.

 

$$RETURN_VAR

The variable to receive the success status: "1" (TRUE) if the move was successful, "0" (FALSE) if the source key was not found.

 

Return Value

 

Returns "1" (TRUE) if the result was successfully moved, "0" (FALSE) if the source key did not exist.

 

Description

 

MCP.Move atomically transfers a result from Functional Memory to standard (permanent) memory. This is useful for preserving results that would otherwise be lost after a read-once operation from the Functional Memory system.

 

The operation performs two steps atomically:

1. Reads and deletes the result from the FM source key (read-once behavior)

2. Stores the result in permanent memory under the destination key

 

Examples

 

Example 1: Move a result to permanent storage

' Move result from FM to permanent memory

MCP.Move|FileTools::GetDirectoryListing|$$SavedDirListing|$$Success

IVV.$$Success!0

DSP.Directory listing saved successfully

ELS.

DSP.Failed to move result (source not found)

EIF.

 

Example 2: Preserve query results

' Save database query result for later use

MCP.Move|DataTools::Query|$$QueryResult_001|$$Moved

' Later, recall from permanent memory

MEM.RCL|$$QueryResult_001|$$Data

 

SLL Implementation

 

SLL Function: MCP_FM_Move

Source File: MCP_FuncMem_Subs.inc

 

Remarks

 

• This command is SPR only - not in public MCP-Server and cannot be called via the MCP HTTP protocol

• The source key is deleted after the move (FM read-once behavior)

• The destination is stored as permanent memory (survives until explicitly deleted)

• Use this to preserve FM results that need to be accessed multiple times

• If the source key doesn't exist, the destination is not modified

 

See also:

 

• MCP.Read - Read result from FM

• MEM.STO - Store in permanent memory

• MEM.RCL - Recall from memory