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:0x079681a1f50bead0959aae80ed755fc58a90ed104a9c592a3b311010e9b07224
Input
PropertyTypeDescription
root*stringConfigured root name
recursivebooleanRecursively delete directory contents (default false)
path*stringFile or directory path relative to the root
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-3.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-3.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-3.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-3.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" },
        "path": { "type": "string", "description": "File or directory path relative to the root" },
        "recursive": { "type": "boolean", "description": "Recursively delete directory contents (default false)" }
      },
      "required": ["root", "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