Tool Details: file_mkdir

Basic Information

Tool Name:file_mkdir
Asset Name:Create Directory
Description:Create a directory under a configured filesystem root. Set 'parents' to true to create missing intermediate directories (mkdir -p). Existing directories are accepted and reported with created=false. Read-only roots reject mkdir.
Adapter:file
Asset Hash:0x0b07eb9ae6b096e63263afc21c1e394c2a49ce08b236cdc5611d460267401803
Input
PropertyTypeDescription
path*stringDirectory path relative to the root
parentsbooleanCreate intermediate parents if missing (default false)
root*stringConfigured root name
Output
PropertyTypeDescription
createdbooleanTrue if a new directory was created
pathstringAbsolute host path of the directory

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://api.getmine.ai/mcp

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

url = "https://api.getmine.ai/mcp"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "file_mkdir",
        "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://api.getmine.ai/mcp';
const payload = {
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
        name: 'file_mkdir',
        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": "Create Directory",
  "description": "Create a directory under a configured filesystem root. Set 'parents' to true to create missing intermediate directories (mkdir -p). Existing directories are accepted and reported with created=false. Read-only roots reject mkdir.",
  "creator": "Covia",
  "operation": {
    "adapter": "file:mkdir",
    "toolName": "file_mkdir",
    "input": {
      "type": "object",
      "properties": {
        "root": { "type": "string", "description": "Configured root name" },
        "path": { "type": "string", "description": "Directory path relative to the root" },
        "parents": { "type": "boolean", "description": "Create intermediate parents if missing (default false)" }
      },
      "required": ["root", "path"]
    },
    "output": {
      "type": "object",
      "properties": {
        "created": { "type": "boolean", "description": "True if a new directory was created" },
        "path": { "type": "string", "description": "Absolute host path of the directory" }
      }
    }
  }
}

Navigation

Back to adapter details

Back to all adapters

Back to index