MCP Tools

MCP Tools

95 tools exposed by mq-mcp, generated from docs/tool_contracts.json.

Tool	Class	Resolver	Writes	Subprocess	Description
analyze_csv	A	resolve_repo_file	no	no	Analyserar en CSV-fil inom repo-katalogen.
analyze_guitar_pro	B	resolve_allowed_local_file	no	no	Analyserar en Guitar Pro-fil (GP3, GP4, GP5).
bootstrap_learning_memory	C	none	yes	no	Seed the learn layer from existing architecture memory ADRs.
bootstrap_semantic_memory	C	none	yes	no	Ingest key mq-mcp docs into semantic memory for use as review context.
build_repo_context	C	none	yes	yes	Rebuild the repo context artifacts used by the review engine.
check_port	B	none	no	yes	Check whether a TCP port is in use on localhost.
create_note	D	none	no	yes	Create a new note in Notes.app.
detect_architecture_drift	A	none	no	no	Detect drift between declared documentation and actual runtime state.
edit_image	C	resolve_allowed_local_file	yes	no	Redigerar en bild (resize, rotate, grayscale).
export_symbol_index	C	none	yes	no	Write the current callgraph symbol map to generated/symbols/symbol_index.json.
extract_coding_conventions	C	none	yes	no	Extract generalizable coding conventions from the last review of a file
find_large_files	B	none	no	yes	Find files larger than a given size in a directory.
find_recent_files	B	none	no	yes	Find files modified within the last N days.
get_architecture_decision	A	none	no	no	Return the full text of a specific architecture memory entry by ID.
get_battery_status	B	none	no	yes	Return battery level, charging state, and estimated time remaining.
get_clipboard	B	none	no	no	Return the current contents of the macOS clipboard.
get_last_review	A	resolve_repo_file	no	no	Return the most recent review findings for a repo file.
get_learning	A	none	no	no	Show a single stored lesson by id (prefix match).
get_public_ip	B	none	no	no	Return the current public IP address.
get_semantic_memory	A	none	no	no	Return the full content of a semantic memory item by exact key.
get_system_resources	B	none	no	no	CPU, minne och disk-info.
get_todays_events	B	none	no	yes	Return today's events from Calendar.app.
get_wifi_info	B	none	no	yes	Return the current Wi-Fi network name and signal info.
git_diff	A	run_repo_command	no	yes	Show git diff for the repo or a specific relative path. Read-only.
git_status	A	run_repo_command	no	yes	Show current git branch, status, and latest commit. Read-only.
hal_repo_report	D	none	no	yes	Run a read-only mq-hal repository report.
learn_from_diff	C	none	yes	yes	Create a learning record with the current git diff as context.
learn_from_review	C	resolve_repo_file	yes	no	Create a learning record from the last review findings for a file.
learning_status	A	none	no	no	Return a summary of the local learn layer: counts by source, risk, and repo.
list_architecture_decisions	A	none	no	no	List all architecture memory entries (ADRs, boundaries, philosophy, rejected patterns).
list_architecture_docs	A	none	no	no	List all architecture documents with freshness status relative to server.py.
list_learnings	A	none	no	no	List stored engineering lessons, with optional filters.
list_local_repos	A	none	no	no	List all registered local repositories by name and path. Read-only.
list_openable_apps	A	none	no	no	List all applications Bridget can open or control directly.
list_repo_files	A	none	no	no	List files in the repository, excluding common cache/build folders.
list_review_contracts	A	none	no	no	List available review contracts and their modes.
list_review_history	A	none	no	no	List all files that have review history and their last review summary.
list_review_skills	A	none	no	no	List available review skills, their trigger paths, and extensions.
list_running_apps	B	none	no	yes	List all visible macOS applications currently running.
list_semantic_memory	A	none	no	no	List all items in semantic memory with key, tags, and content preview.
lock_screen	D	none	no	yes	Lock the macOS screen immediately.
open_app	D	none	no	yes	Launch a macOS application by name.
open_chrome	D	none	no	yes	Open Google Chrome, optionally to a specific URL.
open_finder	D	none	no	yes	Open Finder at a given path, or at the home directory if no path is given.
open_in_app	D	resolve_allowed_local_file	no	yes	Öppnar en fil i dess standardprogram (t.ex. GP8 eller Photoshop).
open_messages	D	none	no	yes	Open Messages.app, optionally to a specific contact or phone number.
open_repo_terminal	D	none	no	yes	Open a registered local repository in a new Terminal window.
open_spotify	D	none	no	yes	Open Spotify, optionally to a track, album, playlist, or search.
open_terminal	D	none	no	yes	Open a new Terminal window, optionally cd'd into a given path.
open_url	D	none	no	yes	Open a URL in the default browser.
open_vscode	D	none	no	yes	Open Visual Studio Code, optionally at a file or folder.
promote_learning	A	none	no	no	Preview how a lesson would look if promoted to a target document.
read_repo_file	A	resolve_repo_file	no	no	Läser innehållet i en fil inom repo-katalogen.
record_architecture_decision	C	resolve_repo_file	yes	no	Record a new architecture decision (ADR) in the architecture_memory/ store.
record_learning	C	none	yes	no	Store a verified engineering lesson in the local learn layer.
repo_signal_analyze	B	resolve_allowed_local_file	no	yes	Run repo-signal analyze on a local repository. Read-only.
repo_signal_checklist	B	resolve_allowed_local_file	no	yes	Run repo-signal publish checklist on a local repository. Read-only.
repo_signal_doctor_json	B	resolve_allowed_local_file	no	yes	Run repo-signal doctor --json and return structured doctor.v1 data. Read-only.
repo_signal_inspect	B	resolve_allowed_local_file	no	yes	Run repo-signal inspect --json and return structured inspect.v1 data. Read-only.
repo_signal_status	A	none	no	no	Report whether repo-signal export packs are present, their age, and merge status.
review_architecture_doc	A	resolve_repo_file	no	no	Review an architecture document against current runtime state.
review_diff	A	none	no	no	Review all files changed in the working tree or staging area.
review_file	A	resolve_repo_file	no	no	Run an AI review on a repo file using the configured review contract.
review_repo	A	none	no	no	Review the least-recently-reviewed Python files in the repo.
review_runtime_contract	A	none	no	no	Review docs/RUNTIME_CONTRACT.md against actual runtime state.
risk_review_diff	A	none	no	no	Risk pass over all files changed in the working tree or staging area.
risk_review_file	A	resolve_repo_file	no	no	Targeted risk pass on a single file with a declared risk mode.
run_mqlaunch	D	none	no	yes	Öppnar mqlaunch i ett nytt Terminal-fönster. mqlaunch är ett interaktivt TUI och kräver en riktig terminal.
run_mqlaunch_ask	D	none	no	yes	Ask mqlaunch a natural-language question about the current repo.
run_mqlaunch_bundle	D	none	yes	yes	Run mqlaunch bundle — create a debug bundle for support/diagnostics.
run_mqlaunch_demo	D	none	no	yes	Run mqlaunch demo — guided demo of mqlaunch features.
run_mqlaunch_doctor	D	none	no	yes	Run mqlaunch doctor — environment and dependency health check.
run_mqlaunch_perf	D	none	no	yes	Run mqlaunch perf — performance monitoring menu.
run_mqlaunch_release_check	D	none	no	yes	Run mqlaunch release-check — pre-release gate for macos-scripts.
run_mqlaunch_selftest	D	none	no	yes	Run mqlaunch selftest — internal smoke tests for mqlaunch itself.
run_mqlaunch_system_check	D	none	no	yes	Run mqlaunch system check — system health and environment overview.
run_mqlaunch_version	D	none	no	yes	Run mqlaunch version — show mqlaunch version information.
run_tests	D	none	no	yes	Run pytest in a registered local repository.
search_learnings	A	none	no	no	Full-text search across stored lessons (task, lesson, validation, repo).
search_repo	A	run_repo_command	no	yes	Search repository text using git grep. Read-only.
search_semantic_memory	A	none	no	no	Search semantic memory by keywords across keys, tags, and content.
set_clipboard	C	none	yes	yes	Copy text to the macOS clipboard.
set_reminder	D	none	no	yes	Create a reminder in Reminders.app.
set_volume	D	none	no	yes	Set the macOS system output volume.
set_wallpaper	D	none	no	yes	Set the macOS desktop wallpaper.
show_notification	D	none	no	yes	Send a macOS notification via osascript.
speak_text	D	none	no	yes	Speak text aloud using macOS text-to-speech.
store_semantic_memory	C	none	yes	no	Store or update a knowledge item in semantic memory.
summarize_learnings	A	none	no	no	Summarize stored lessons — counts by source and risk, recent entries.
take_screenshot	C	none	yes	yes	Take a screenshot and save it to a file.
toggle_dark_mode	D	none	no	yes	Toggle macOS between dark mode and light mode.
tool_safety_report	A	none	no	no	Return the documented MCP tool safety classification.
update_repo_file	C	resolve_repo_file	yes	no	Safely update a text file inside the repo by replacing exact text. Does not commit.
validate_orchestration_contract	A	none	no	no	Verify that the current tool set satisfies the orchestration contract.
validate_project	D	none	no	yes	Run the local project validation script if it exists.