Read a UTF-8 (or other specified encoding) text file from the workspace.

Args: path: Path to the file, relative to the workspace root. encoding: Text encoding to decode with (default "utf-8").

Returns: The file's path, size in bytes, encoding, and full text content. Fails if the file does not exist, isn't a file, exceeds the configured max file size, or isn't valid text in that encoding.

Create or overwrite a text file inside the workspace.

Args: path: Destination path, relative to the workspace root. Parent directories are created automatically. content: Text content to write (UTF-8). overwrite: If False and the file already exists, fails instead of overwriting it.

Returns: The path and number of bytes written.

Append text to an existing file inside the workspace.

Args: path: Path to an existing file, relative to the workspace root. content: Text to append.

Returns: The path and number of bytes appended. Fails if the file does not exist or if appending would exceed the max file size.

Delete a single file inside the workspace.

Args: path: Path to the file to delete, relative to the workspace root.

Returns: The deleted path. Fails if the path does not exist or is a directory (use delete_directory for directories).

Copy a file within the workspace, preserving metadata.

Args: source: Existing file path, relative to the workspace root. destination: Destination path; parent directories are created automatically.

Move or rename a file within the workspace.

Args: source: Existing file path, relative to the workspace root. destination: New path; parent directories are created automatically.

Check whether a given path exists and is a regular file.

Args: path: Path to check, relative to the workspace root.

Get metadata about a file: size, modified/created time, extension.

Args: path: Path to the file, relative to the workspace root.

List the contents of a directory inside the workspace.

Args: path: Directory to list, relative to the workspace root (default: the workspace root itself). recursive: If True, walk subdirectories too (capped by MCP_MAX_DIRECTORY_DEPTH).

Returns: Each entry's name, relative path, whether it's a file or directory, and file size when applicable.

Create a directory (and any missing parent directories) in the workspace.

Args: path: Directory path to create, relative to the workspace root.

Delete a directory inside the workspace.

Args: path: Directory to delete, relative to the workspace root. recursive: Required to be True to delete a non-empty directory and everything inside it. The workspace root itself can never be deleted.

Check whether a given path exists and is a directory.

Args: path: Path to check, relative to the workspace root.

Recursively find files under a directory matching a glob pattern.

Args: path: Directory to search under, relative to the workspace root. pattern: Filename glob, e.g. ".py" or ".md" (matched against the filename only, not the full path).

Returns: Up to 500 matching relative file paths.

Recursively calculate the total size of a directory's contents.

Args: path: Directory to measure, relative to the workspace root.

Returns: Total size in bytes and megabytes, plus the number of files counted.

Get basic host information: OS, kernel release, architecture, hostname, Python version, and boot time.

Get CPU information: core counts, current utilization (overall and per-core), clock frequency, and 1/5/15-minute load averages.

Get RAM and swap usage in gigabytes and as a percentage.

Get disk usage (total/used/free, in GB) for the filesystem containing the given workspace-relative path.

Args: path: Path (inside the workspace) whose filesystem to inspect.

List running processes on the host (read-only; cannot start, stop, or signal anything).

Args: limit: Max number of processes to return (1-200). sort_by: "cpu" or "memory" -- which usage metric to sort by, descending.

Returns: Each process's pid, name, username, cpu%, memory%, and status.

Get the systemctl status output for one systemd service (read-only; cannot start, stop, restart, enable, or disable services).

Args: service_name: Service unit name, e.g. "nginx" or "ssh.service". Only letters, digits, '@', '.', '_', and '-' are allowed.

Fetch a public HTTP/HTTPS URL and return its status, headers, and body.

Blocks requests to localhost, loopback, link-local, and private IP ranges to prevent SSRF (unless MCP_ALLOW_PRIVATE_NETWORK=true). Response bodies are capped at MCP_MAX_RESPONSE_SIZE bytes.

Args: url: The http:// or https:// URL to fetch. timeout: Optional per-request timeout in seconds (defaults to MCP_HTTP_TIMEOUT).

Check whether a TCP port on a public host is reachable.

Args: host: Hostname or IP to test (private/loopback hosts are blocked). port: TCP port number (1-65535). timeout: Connection timeout in seconds.

Resolve a hostname to its IP address(es) and flag whether any are private.

Args: hostname: The hostname to resolve.

Validate that a string is a well-formed http/https URL (syntax check only; does not make a network request).

Args: url: The URL string to validate.

Break a URL down into scheme, hostname, port, path, query, and fragment.

Args: url: The URL to parse.

Construct a URL from a base URL, an appended path, and optional query parameters.

Args: base_url: Base http/https URL. path: Path segment to append. query: Optional dict of query parameters to encode and attach.

Get git status (branch info + changed files) for a repository inside the workspace.

Args: path: Path to the git repository, relative to the workspace root.

Get recent commit history for a repository inside the workspace.

Args: path: Path to the git repository, relative to the workspace root. limit: Number of commits to return (1-200).

Get the current diff for a repository inside the workspace.

Args: path: Path to the git repository, relative to the workspace root. staged: If True, show staged (index) changes instead of the working-tree diff. file_path: Optional single file to limit the diff to.

List local branches for a repository inside the workspace, marking which one is currently checked out.

Args: path: Path to the git repository, relative to the workspace root.

Get the name of the currently checked-out branch.

Args: path: Path to the git repository, relative to the workspace root.

Guess the project type(s) present in a directory by looking for common marker files (pyproject.toml, package.json, Cargo.toml, etc.).

Args: path: Directory to inspect, relative to the workspace root.

Recursively regex-search text files under a directory (like a scoped grep), confined to the workspace.

Args: path: Directory to search under, relative to the workspace root. pattern: Python regular expression to search each line for. file_glob: Glob to filter which files are searched, e.g. "*.py". max_results: Maximum number of matching lines to return (1-500).

Count words, characters, and lines in a block of text.

Args: text: The text to analyze.

Pretty-print (reformat) a JSON string with the given indentation.

Args: json_text: Raw JSON text to parse and reformat. indent: Number of spaces per indent level (0-8).

Check whether a string is valid JSON without modifying it.

Args: json_text: The text to validate.

Read a CSV file from the workspace and convert it to a list of row objects keyed by header column.

Args: path: Path to the CSV file, relative to the workspace root.

Read just the header row of a CSV file in the workspace.

Args: path: Path to the CSV file, relative to the workspace root.