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:0x4ea6e68607c5ef15817033e0479f714125624486b60df7885202c98bb3fd8de4
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-test.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-test.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-test.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-test.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",
    "readOnly": false,
    "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