MCamner/mq-mcp

tools

• analyze_csv

  analyzes CSV files inside the repo

• analyze_guitar_pro

  analyzes Guitar Pro files in repo or allowed roots

• check_port

  checks whether a TCP port is in use on localhost

• create_note

  creates a new note in Notes.app

• edit_image

  edits an image with supported actions (rotate, grayscale)

• find_large_files

  finds files larger than a given size in a directory

• find_recent_files

  finds files modified within the last N days

• get_battery_status

  returns battery level, charging state, and estimated time remaining

• get_clipboard

  reads the current macOS clipboard

• get_public_ip

  returns the current public IP address

• get_system_resources

  shows CPU, memory, and disk information

• get_todays_events

  returns today's events from Calendar.app

• get_wifi_info

  returns current Wi-Fi network name and signal info

• git_diff

  shows current git diff, optionally for one path

• git_status

  shows branch, working tree status, and recent commits

• hal_repo_report

  runs a read-only mq-hal repo report (audit, brief, release-brief, repo-status, ci)

• list_local_repos

  lists registered local repositories from MQ_MCP_LOCAL_REPOS

• list_openable_apps

  returns static list of apps Bridget can open or control

• list_repo_files

  lists repository files up to a chosen depth

• list_running_apps

  lists all visible macOS applications currently running

• lock_screen

  locks the macOS screen immediately

• open_app

  launches any macOS application by name

• open_chrome

  opens Google Chrome, optionally to a URL

• open_finder

  opens Finder at a given path

• open_in_app

  opens a repo file or explicitly allowed local file in the default app

• open_messages

  opens Messages.app, optionally to a contact

• open_repo_terminal

  opens a registered local repository in a new Terminal window

• open_spotify

  opens Spotify, optionally to a track, album, or search

• open_terminal

  opens a new Terminal window, optionally at a path

• open_url

  opens a URL in the default browser

• open_vscode

  opens VS Code, optionally at a file or folder

• read_repo_file

  reads a file inside the repository root

• release_gate_run

  runs Release Gate v2 deterministic release validation

• repo_signal_analyze

  runs repo-signal analyze on a local repository (read-only)

• repo_signal_checklist

  runs repo-signal publish checklist on a local repository (read-only)

• repo_signal_doctor_json

  runs repo-signal doctor --json and returns structured doctor.v1 data

• repo_signal_inspect

  runs repo-signal inspect --json and returns structured inspect.v1 data

• repo_signal_status

  reports whether repo-signal export packs are present and merged (Class A, read-only)

• run_mqlaunch

  runs mqlaunch.sh

• run_mqlaunch_bundle

  runs mqlaunch bundle (TUI; bundle NOT created headless)

• run_mqlaunch_demo

  runs mqlaunch demo (interactive TUI; no output headless)

• run_mqlaunch_doctor

  runs mqlaunch doctor (structured PASS/FAIL health report)

• run_mqlaunch_perf

  runs mqlaunch perf (TUI menu; no parseable output headless)

• run_mqlaunch_release_check

  runs mqlaunch release-check (pre-release gate)

• run_mqlaunch_selftest

  runs mqlaunch selftest (internal smoke checks)

• run_mqlaunch_system_check

  runs mqlaunch system check (TUI; structured data not available headless)

• run_mqlaunch_version

  runs mqlaunch version (TUI output; version extracted heuristically)

• run_tests

  runs pytest in a registered local repository

• search_repo

  searches repository text

• set_clipboard

  copies text to the macOS clipboard

• set_reminder

  creates a reminder in Reminders.app

• set_volume

  sets the macOS system output volume

• set_wallpaper

  sets the macOS desktop wallpaper

• show_notification

  sends a macOS system notification

• speak_text

  speaks text aloud via macOS text-to-speech

• take_screenshot

  captures the screen and saves to a file

• toggle_dark_mode

  toggles macOS between dark mode and light mode

• tool_safety_report

  returns the MCP tool safety classification from docs/TOOL_SAFETY.md

• update_repo_file

  safely replaces exact text in allowed repo files without committing

• validate_project

  runs scripts/validate.sh when available