read_text_file

Read UTF-8 text file contents securely, optionally within a specified line range. Ensures access only within allowed directories and handles 1-indexed line numbers for precise extraction.

Instructions

Read the contents of a UTF-8 text file, optionally within a line range.

Args: path (str): File path to read (absolute or relative to allowed directories) fromLine (int, optional): Starting line number (1-indexed, inclusive) toLine (int, optional): Ending line number (1-indexed, inclusive)

Returns: str: File contents as text, or error message if failed

Note:

- Path must be within allowed directory roots
- Only reads UTF-8 text files (binary files will return error)
- If line range specified, returns only those lines
- Line numbers are 1-indexed

Input Schema

Name	Required	Description	Default
`fromLine`	No
`path`	Yes
`toLine`	No

Input Schema (JSON Schema)

{
  "properties": {
    "fromLine": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Fromline"
    },
    "path": {
      "title": "Path",
      "type": "string"
    },
    "toLine": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Toline"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

Filesystem MCP Server

read_text_file

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Filesystem MCP Server

Related Tools

MCP directory API