Tool Details: file_delete

Basic Information

Tool Name:file_delete
Asset Name:Delete File
Description:Delete a file or empty directory under a configured filesystem root. Set 'recursive' to true to remove a non-empty directory and all its contents. The root itself cannot be deleted. Read-only roots reject deletes.
Adapter:file
Asset Hash:0x62117fefd5569fdbc2554737651ce456c812f880ff0da5a66a24e928adb9313d
Input
PropertyTypeDescription
recursivebooleanRecursively delete directory contents (default false)
path*stringPath relative to root or a canonical DLFS path
rootstringConfigured root name; omit for a canonical DLFS path
Output
PropertyTypeDescription
deletedbooleanTrue if the target was deleted
existedbooleanTrue if the target existed prior to the call

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-2.covia.ai/mcp

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

url = "https://venue-2.covia.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "file_delete",
        "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-2.covia.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'file_delete',
        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": "Delete File",
  "description": "Delete a file or empty directory under a configured filesystem root. Set 'recursive' to true to remove a non-empty directory and all its contents. The root itself cannot be deleted. Read-only roots reject deletes.",
  "creator": "Covia",
  "operation": {
    "adapter": "file:delete",
    "toolName": "file_delete",
    "input": {
      "type": "object",
      "properties": {
        "root": { "type": "string", "description": "Configured root name; omit for a canonical DLFS path" },
        "path": { "type": "string", "description": "Path relative to root or a canonical DLFS path" },
        "recursive": { "type": "boolean", "description": "Recursively delete directory contents (default false)" }
      },
      "required": ["path"]
    },
    "output": {
      "type": "object",
      "properties": {
        "deleted": { "type": "boolean", "description": "True if the target was deleted" },
        "existed": { "type": "boolean", "description": "True if the target existed prior to the call" }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index