Tool Details: file_list

Basic Information

Tool Name:file_list
Asset Name:List Directory
Description:List entries in a directory under a configured filesystem root. Returns each entry's name, type (file/directory/symlink/other), size in bytes, and last-modified time (epoch millis). Omit 'path' to list the root itself.
Adapter:file
Asset Hash:0x67239e85ffd32009d5134e625bf69f741a5306c6d61e80e54d16a03ff74e735d
Input
PropertyTypeDescription
pathstringDirectory relative to root or dlfs/<drive>[/<path>]
rootstringConfigured root name; omit for a canonical DLFS path
Output
PropertyTypeDescription
entriesarray-
warningsarrayNon-fatal advisories. Present when entries disappeared during traversal and were omitted.

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_list",
    "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_list",
      "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_list",
        "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_list',
        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": "List Directory",
  "description": "List entries in a directory under a configured filesystem root. Returns each entry's name, type (file/directory/symlink/other), size in bytes, and last-modified time (epoch millis). Omit 'path' to list the root itself.",
  "creator": "Covia",
  "operation": {
    "adapter": "file:list",
    "toolName": "file_list",
    "input": {
      "type": "object",
      "properties": {
        "root": { "type": "string", "description": "Configured root name; omit for a canonical DLFS path" },
        "path": { "type": "string", "description": "Directory relative to root or dlfs/<drive>[/<path>]" }
      },
      "anyOf": [
        { "required": ["root"] },
        { "required": ["path"] }
      ]
    },
    "output": {
      "type": "object",
      "properties": {
        "entries": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "type": { "type": "string" },
              "size": { "type": "integer" },
              "modified": { "type": "integer" }
            }
          }
        },
        "warnings": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Non-fatal advisories. Present when entries disappeared during traversal and were omitted."
        }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index