1. Docs
2. /
3. Tool reference
4. /
5. Studio Apps
6. /
7. searchStudioAppFile

Studio Apps

searchStudioAppFile

Search Studio App Files

Search the current text files of a Studio app with a safe JavaScript regular expression, without paging whole files through readStudioAppFile.

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "find this CSS rule in my app", and it calls searchStudioAppFile.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "appId": "<appId>"
  },
  "name": "searchStudioAppFile"
}

Arguments

• appIdstringrequiredThe Studio app ID
• maxMatchesintegeroptionalMaximum matches to return. Defaults to 20; maximum 100. The response says when more exist.
• pathstringoptionalOptional file path within the app. Omit to search every text file. Binary files are never searched.
• patternstringoptionalJavaScript regular-expression source without slash delimiters. Case-sensitive; unsafe backtracking shapes are rejected. Canonical name: this is a regex, not a free-text query: but `query` is accepted too.
• querystringoptionalAlias of `pattern`, for the spelling the other search verbs use. `pattern` wins if you send both; the value is still read as a regex.

Returns

Returns each matching span with UTF-8 byteStart/byteEnd, 1-based lineStart/lineEnd, bounded surrounding contextLines, and exact character offsets.

Declared limits

• maxMatches: greater than 0
• maxMatches: maximum 100
• pattern: minimum length 1
• pattern: maximum length 500
• query: minimum length 1
• query: maximum length 500

Ask for it

The Cloud routes these requests to this verb.

• find this CSS rule in my app
• search my app files for cart-toggle
• where is this selector defined

Pair it with

The verbs that finish the job.

• readStudioAppFile
• editStudioAppFile

Questions

• What does searchStudioAppFile do?

  Search the current text files of a Studio app with a safe JavaScript regular expression, without paging whole files through readStudioAppFile. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use searchStudioAppFile from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "find this CSS rule in my app", and it calls searchStudioAppFile.

• Is searchStudioAppFile safe to let an AI call?

  searchStudioAppFile is read-only: it changes nothing.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.