search_files

Recursively locate files and directories using a case-insensitive pattern match from a specified path. Control search depth and result limits to efficiently find matching items, even when exact locations are unknown. Ideal for quick file discovery within permitted directories.

Instructions

Recursively search for files and directories matching a pattern. Searches through all subdirectories from the starting path. The search is case-insensitive and matches partial names. Returns full paths to all matching items. Requires maxDepth (default 2) and maxResults (default 10) parameters. Great for finding files when you don't know their exact location. Only searches within allowed directories.

Input Schema

Name	Required	Description
`excludePatterns`	No
`maxDepth`	Yes	Maximum directory depth to search. Must be a positive integer. Handler default: 2.
`maxResults`	Yes	Maximum number of results to return. Must be a positive integer. Handler default: 10.
`path`	Yes
`pattern`	Yes

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "excludePatterns": {
      "default": [],
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "maxDepth": {
      "description": "Maximum directory depth to search. Must be a positive integer. Handler default: 2.",
      "exclusiveMinimum": 0,
      "type": "integer"
    },
    "maxResults": {
      "description": "Maximum number of results to return. Must be a positive integer. Handler default: 10.",
      "exclusiveMinimum": 0,
      "type": "integer"
    },
    "path": {
      "type": "string"
    },
    "pattern": {
      "type": "string"
    }
  },
  "required": [
    "path",
    "pattern",
    "maxDepth",
    "maxResults"
  ],
  "type": "object"
}

Filesystem MCP Server

search_files

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Filesystem MCP Server

Related Tools

MCP directory API