Tool Details: file_roots

Basic Information

MCP Tool Usage Examples

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "file_roots",
    "arguments": {
      "input": "your input here"
    }
  }
}

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_roots",
      "arguments": {
        "input": "your input here"
      }
    }
  }'

import requests
import json

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

response = requests.post(url, json=payload)
result = response.json()
print(result)

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_roots',
        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 File Roots",
  "description": "List the named filesystem roots configured for this venue. Returns each root's name, display path, kind (host/temp/dlfs), and read-only flag. Agents must use one of these names as the 'root' parameter for other file operations. Roots can be backed by host directories, ephemeral temp dirs, or DLFS drives — the file: surface is uniform regardless. If the operator has not configured any roots, the venue defaults to a single ephemeral 'tmp' root that is created at startup and deleted on JVM exit.",
  "creator": "Covia",
  "operation": {
    "adapter": "file:roots",
    "toolName": "file_roots",
    "input": {
      "type": "object",
      "properties": {}
    },
    "output": {
      "type": "object",
      "properties": {
        "roots": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "path": { "type": "string", "description": "Host path for host/temp roots; 'dlfs:<drive>' for DLFS-backed roots" },
              "kind": { "type": "string", "enum": ["host", "temp", "dlfs"] },
              "readOnly": { "type": "boolean" },
              "description": { "type": "string", "description": "Operator-supplied description (only present if configured)" }
            }
          }
        }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index