flamel_mcp

The core MCP server. Handles plans, file operations, shell commands, code search, and UI interactions. Every flamel session has this wired in by default.

Plans

Tool	What it does
`plan(action="create", ...)`	Create a new plan with a title and list of items
`plan(action="get", plan_id="...")`	Get full plan details including item IDs and statuses
`plan(action="list")`	List plans, defaulting to the current session when available
`plan(action="update_item", ...)`	Update item status: todo / in_progress / done / blocked
`plan(action="add_items", ...)`	Append new items to an existing plan
`plan(action="replace_items", ...)`	Replace all items (for restructuring a plan)
`plan(action="rename", ...)`	Rename a plan

File operations

Tool	What it does
`read_file`	Read a file with optional line range
`create_text_file`	Create or overwrite a file
`flamel_replace`	Exact-string replacement in a file
`replace_content`	Regex or multi-line replacement
`replace_symbol_body`	Rewrite an entire function, class, or method by name
`find_file`	Find files by glob pattern
`list_dir`	List directory contents

Code search & navigation

Tool	What it does
`search_for_pattern`	Regex search across files (replaces grep)
`find_symbol`	Find a function, class, or type by name
`get_symbols_overview`	Outline a file's structure — functions, classes, types
`find_referencing_symbols`	Find all callers / references to a symbol
`get_imports`	Get import graph for a file

Shell

Tool	When to use
`flamel_shell`	Quick one-shot commands (ls, git status, fast scripts)
`shell_run`	Blocking builds — streams output, waits for exit (cargo build, npm install, pytest)
`shell_start`	Interactive processes that need stdin (SSH, password prompts)
`shell_read`	Drain output from an interactive session
`shell_write`	Write to stdin of an interactive session
`shell_kill`	Terminate an interactive session

Other tools

Tool	What it does
`thinking`	Extended reasoning — for architectural decisions and hard problems
`AskUserQuestion`	Pause execution and ask the user a question with optional choices
`fetch_image`	Fetch and view an image from a URL
`create_model3d`	Generate a 3D model from OpenSCAD code