File

Role

sublime_mcp.py

ST plugin — runs an HTTP server inside Sublime Text

mcp_server.py

MCP server — wraps the HTTP API for MCP clients

Tool

Description

get_active_file

Path, full content, cursor line/col, dirty flag, and syntax name

get_selection

Current selection(s): text and begin/end line+col for each

get_cursor_context

lines lines above and below cursor, with 1-based line numbers prepended

get_open_files

All files open in the current window (path, name, is_dirty)

get_project_folders

Project root folder paths

get_file_content

Full content of any already-open file by path

get_view_content

Full content of any open tab by name (partial match). Works for Terminus tabs and nameless views

get_view_size

Total character count of any open tab. Use to compute offsets before get_view_chars

get_view_chars

Text at character offsets begin..end (0-based, end exclusive). Clamps to buffer bounds

get_view_phantoms

Phantom HTML and extracted plain text from a named view; filters by phantom key

get_output_panel

Text content of a named output panel. Omit name for the active panel; name='exec' for build output

get_active_panel

Active panel id and, if it is an output panel, its content

get_symbols

All symbols (functions, classes, etc.) in the active file with line numbers

lookup_symbol

Find where a symbol is defined across all open files

get_project_data

Raw .sublime-project JSON for the current project

get_variables

ST build variables: $file, $project_path, $platform, etc.

get_command_palette

Command Palette entries from installed *.sublime-commands resources; filterable by package, command, or caption

get_commands

Runnable command ids from loaded command classes, optionally merged with palette metadata

get_menu_items

Menu items from *.sublime-menu resources; filterable by menu filename, caption, or command

get_syntaxes

All syntax definitions available in ST (name + path)

get_scope_at_cursor

Full syntax scope string at the cursor position

get_word_at_cursor

Word under the cursor and its line/col

get_bookmarks

All bookmarked positions in the active file

get_line_count

Total number of lines in the active file

get_encoding

Character encoding of the active file

get_setting

A ST setting by key. scope='view' (default) or 'window'

get_layout

Current window layout (groups, cells) and which files are in each group

Tool

Description

open_file

Open a file, optionally jumping to a specific line and column

goto_line

Move cursor to line (and optional column) in the active file

show_panel

Bring an output panel to the front. Default name='exec' for the build panel

focus_group

Move focus to a pane group by 0-based index

Tool

Description

replace_selection

Replace the current selection(s) with text

replace_lines

Replace lines begin..end (inclusive, 1-based) in the active file

insert_snippet

Insert at the cursor using ST snippet syntax ($1 for tab stops, etc.)

duplicate_line

Duplicate the current line(s)

toggle_comment

Toggle line comment, or block comment if block=True

sort_lines

Sort selected lines, or all lines if nothing is selected

select_lines

Select lines begin..end (1-based, inclusive)

fold_lines

Fold (collapse) lines begin..end in the active file

undo

Undo the last edit

redo

Redo the last undone edit

run_command

Run any ST command with optional args. scope='window' (default) or 'view'

Tool

Description

find_in_file

Find all occurrences of a pattern in the active file. Returns {line, col, text} list

find_in_files

Search across project folders (or a supplied list). Skips .git, __pycache__, node_modules, .venv. Returns {path, line, match} list, capped at max_results (default 200)

Tool

Description

save_file

Save the active file

save_all

Save all open files

close_file

Close a file by path, or the active file if path is omitted

revert_file

Revert the active file to its last saved state

add_folder

Add a folder to the current project (no-op if already present)

remove_folder

Remove a folder from the current project by path

Tool

Description

set_syntax

Set the syntax of the active file by name (case-insensitive partial match)

set_encoding

Set the character encoding of the active file (e.g. 'UTF-8', 'Western (Windows 1252)')

Tool

Description

set_setting

Set a ST setting by key. scope='view' (default) or 'window'

toggle_sidebar

Show or hide the sidebar

set_layout

Set the window pane layout. Accepts a ST layout dict with cols, rows, cells

set_status

Write a message to ST's status bar

Tool

Description

run_build

Trigger the current build system, or pass cmd/shell_cmd + working_dir for a custom command

Tool

Description

send_to_view

Send a string to any open tab by name. For Terminus tabs, types the text as if the user typed it. Include a trailing \n to execute a command

Tool

Description

eval_python

Execute arbitrary Python in ST's main thread. Locals available: sublime, window, view, print. Returns captured stdout in output