Tool Details: file_move

Basic Information

Tool Name:file_move
Asset Name:Move File
Description:Rename or relocate a file or directory. Endpoints may be relative paths plus root/toRoot, file://<root>/<path>, or canonical DLFS references. The destination must not exist and its parent must exist. Same-drive DLFS moves remain provider-native. Both endpoints must be writable.
Adapter:file
Asset Hash:0x868d5e09fb7422f9724f48c1ff48e357a6f264b2bc228dfa31ef3e98b167e25c
Input
PropertyTypeDescription
to*stringRelative destination, file:// reference, or canonical DLFS reference
rootstringSource root and default destination root; optional when from is a file:// reference
from*stringRelative source, file:// reference, or canonical DLFS reference
toRootstringOptional destination root override; a qualified to reference may name it instead
Output
PropertyTypeDescription
to*stringCanonical destination resource
from*stringCanonical source resource
moved*boolean-

MCP Tool Usage Examples

This tool can be called via the MCP (Model Context Protocol) endpoint. Here are examples of how to use it:

JSON-RPC Call Example:

POST to https://venue-3.covia.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "file_move",
    "arguments": {
      "input": "your input here"
    }
  }
}
cURL Example:
curl -X POST https://venue-3.covia.ai/mcp \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "file_move",
      "arguments": {
        "input": "your input here"
      }
    }
  }'
Python Example:
import requests
import json

url = "https://venue-3.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "file_move",
        "arguments": {
            "input": "your input here"
        }
    }
}

response = requests.post(url, json=payload)
result = response.json()
print(result)
JavaScript/Node.js Example:
const fetch = require('node-fetch');

const url = 'https://venue-3.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'file_move',
        arguments: {
            input: 'your input here'
        }
    }
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));

Asset Metadata

{
  "name": "Move File",
  "description": "Rename or relocate a file or directory. Endpoints may be relative paths plus root/toRoot, file://<root>/<path>, or canonical DLFS references. The destination must not exist and its parent must exist. Same-drive DLFS moves remain provider-native. Both endpoints must be writable.",
  "creator": "Covia",
  "mcp": {
    "annotations": {
      "readOnlyHint": false,
      "destructiveHint": false,
      "idempotentHint": false,
      "openWorldHint": false
    }
  },
  "operation": {
    "adapter": "file:move",
    "toolName": "file_move",
    "input": {
      "type": "object",
      "properties": {
        "root": { "type": "string", "description": "Source root and default destination root; optional when from is a file:// reference" },
        "toRoot": { "type": "string", "description": "Optional destination root override; a qualified to reference may name it instead" },
        "from": { "type": "string", "description": "Relative source, file:// reference, or canonical DLFS reference" },
        "to": { "type": "string", "description": "Relative destination, file:// reference, or canonical DLFS reference" }
      },
      "required": ["from", "to"]
    },
    "output": {
      "type": "object",
      "properties": {
        "moved": { "type": "boolean" },
        "from": { "type": "string", "description": "Canonical source resource" },
        "to": { "type": "string", "description": "Canonical destination resource" }
      },
      "required": ["moved", "from", "to"]
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index