MCP Reference

list_directory: List files and directories.

interface ListDirectoryParams {
  dir_path: string;
}
// Returns: string[]

read_file: Read the contents of a file.

interface ReadFileParams {
  file_path: string;
  start_line?: number;
  end_line?: number;
}
// Returns: string

grep_search: Search for a pattern in files.

interface GrepSearchParams {
  pattern: string;
  dir_path?: string;
  case_sensitive?: boolean;
}
// Returns: { file_path: string; line: string; line_number: number }[]

glob: Find files matching a glob pattern.

interface GlobParams {
  pattern: string;
}
// Returns: string[]

replace: Replace text within a file.

interface ReplaceParams {
  file_path: string;
  old_string: string;
  new_string: string;
  allow_multiple?: boolean;
}
// Returns: void

write_file: Write content to a file.

interface WriteFileParams {
  file_path: string;
  content: string;
}
// Returns: void

run_shell_command: Execute a shell command.

interface RunShellCommandParams {
  command: string;
  dir_path?: string;
}
// Returns: { stdout: string; stderr: string; exit_code: number }

web_fetch: Fetch content from a URL.

interface WebFetchParams {
  prompt: string; // Contains URL(s) and instructions
}
// Returns: string

google_web_search: Perform a Google web search.

interface GoogleWebSearchParams {
  query: string;
}
// Returns: { title: string; link: string; snippet: string }[]

Example Agent Workflow

An agent might use these tools sequentially to accomplish a task, such as finding all TODO comments and consolidating them into a single file.

1. glob({ pattern: "**/*.ts" })
2. For each file -> grep_search({ pattern: "TODO", file_path: file })
3. write_file({ file_path: "TODOs.md", content: ... })

Allowlist & Permissions

By default, agents operate with a restrictive allowlist. File system access is limited to the project directory. The run_shell_command tool can only execute a pre-approved set of safe commands.

Rate Limiting

The MCP API is rate-limited to prevent abuse. The standard limit is 100 requests per minute. Please contact support for higher limits.

Notifications

Agents can send notifications to the user interface by emitting a specially formatted JSON object to stdout.