[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_120":121},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":-5,"_77":-5,"_78":48,"_79":-5,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","monglong0214","moduleId","logic-pro-mcp","@monglong0214/logic-pro-mcp","displayName","Logic Pro MCP","tagline","Local MCP server for stateful, fail-closed Logic Pro control and live project readback.","iconKey","https://raw.githubusercontent.com/MongLong0214/logic-pro-mcp/main/docs/media/logic-pro-mcp-thumbnail.png","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1783335618000,"updatedAt",1788775959000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.MongLong0214%2Flogic-pro-mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",75,"upstreamUpdatedAt",1788774855000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/MongLong0214/logic-pro-mcp","githubRepoFullName","MongLong0214/logic-pro-mcp","releaseId","ext-monglong0214-logic-pro-mcp","version","3.7.1","descriptionMarkdown","# Logic Pro MCP Server for Claude, Cursor, and AI Agents\n\n[![MCP Toplist](https://mcptoplist.com/badge/io.github.MongLong0214%2Flogic-pro-mcp.svg)](https://mcptoplist.com/server/io.github.MongLong0214%2Flogic-pro-mcp)\n\nA local Model Context Protocol (MCP) server that lets Claude Code, Claude Desktop, Cursor, VS Code, and custom AI agents control Logic Pro for AI music production: create tracks, write MIDI, operate transport and mixer state, inspect live project data, and verify results.\n\n[Install](#1-install) · [Watch demo](https://github.com/MongLong0214/logic-pro-mcp/blob/main/docs/media/logic-pro-mcp-demo.mp4) · [What it controls](#what-it-controls)\n\n> ### 🏆 Selected for Anthropic's [Claude for Open Source](https://claude.com/contact-sales/claude-for-oss) program\n> Logic Pro MCP has been **officially selected for Anthropic's Claude for Open Source program** — recognition from the makers of Claude that this project is open-source work worth supporting. This server is built with Claude, for Claude-powered agents — and is now officially supported by the program.\n\n

\n $\"Logic$ \n

\n\n

\n $\"Claude$ \n \n \n \n $\"CI\"$ \n \n \n \n

\n\n

\n \n $\"Actual$ \n \n

\n\n

\n An 82 BPM D-minor lofi loop composed live in Logic Pro 12.3 by the MCP — tempo, three MIDI parts, a Drummer, and playback, all from prompts.
\n ▶ Watch the 36-sec demo (with sound)\n

\n\n---\n\nLogic Pro MCP Server gives Claude, Cursor, and custom AI agents a structured way to control Logic Pro without brittle keyboard macros. Logic Pro does not ship a first-party API for agentic composition, session setup, mixer operations, or live project readback, so Logic Pro MCP fills that gap by combining **7 native macOS control channels** behind one MCP interface, then wrapping every high-risk operation in explicit state, confirmation, and verification contracts.\n\nThe result is not \"screen automation with prompts.\" It is a structured server for DAW agents: tools mutate, resources read, evidence is labeled, and uncertain outcomes stay uncertain instead of being reported as success.\n\n```\nYou: \"Make a 4-bar techno loop in A minor at 140 BPM\"\n\nMCP client → logic_tracks.record_sequence {\n bar: 1, tempo: 140,\n notes: \"45,0,95;57,107,95;45,214,95;...\"\n}\nMCP client → logic_tracks.set_instrument {\n index: 0, path: \"Electronic Drums/Roland TR-909\"\n}\n\nLogic Pro MCP: region imported, instrument routed, readback exposed through resources.\n```\n\n## At a Glance\n\n| Surface | Current source tree |\n|---------|---------------------|\n| MCP tools | 10 tools covering transport, tracks, mixer, MIDI, edit, navigation, project lifecycle, audio artifact analysis, system health, and verified plugin apply-back |\n| Read resources | 18 static resources for health, transport, tracks, mixer, markers, project metadata, project audit/cleanup planning, MIDI ports, MCU state, library inventory, stock plugin/instrument intelligence, Session Players, and workflow skills |\n| Resource templates | 12 templates for the generated operation catalog, track, region, mixer-strip, stock plugin detail/search, stock instrument detail/search, Session Player detail, session-plan dry run, and workflow detail/search lookup |\n| Control channels | MCU, Accessibility, AppleScript, CoreMIDI, CGEvent, Scripter, MIDI Key Commands |\n| Supported Logic Pro | **Latest Logic Pro first** — desktop **Logic Pro** (`com.apple.logic10`, `/Applications/Logic Pro.app`) and Apple Creator Studio **Logic Pro Creator Studio** (`com.apple.mobilelogic`, `/Applications/Logic Pro Creator Studio.app`). Desktop **Logic Pro** is the only variant the release qualification matrix covers (`shipVariants = [.desktop]`), so it is the only one this server claims to control. Creator Studio's bundle ID is recognised so that a machine with both installed is not targeted by accident and so the server can say which one it found — recognising a variant is not the same as qualifying it, and no qualification evidence exists for Creator Studio. Set `LOGIC_PRO_BUNDLE_ID` to pin the desktop variant when both are installed. Logic Pro 12.3 is the first-class, actively-validated target (macOS 15.6+); older versions down to 12.0.1 are best-effort |\n| Verification line | Current source tree: `3917` Swift tests; the last reproducible release build + repo-wide live qualification E2E (every registered operation against real Logic 12.3 with independent readback) ran green on the v3.12.0 release tree (2026-07-21, clean session). The last full strict live E2E ran on the v3.8.0 line (`372/373`); v3.9.0's two live-only surfaces (MIDI export read-back, Channel EQ verified params) were spike-tested against live Logic 12.3 and **honestly deferred** — see the CHANGELOG **Deferred** section. v3.12.0 adds live-verified coordinate-free actuation (menu AXPress toggle proof), consent-gated record-arm auto-setup with functional flip/restore verification, and the locale-neutral modal classifier |\n| Release state | Published stable [v3.15.0](https://github.com/MongLong0214/logic-pro-mcp/releases/tag/v3.15.0); previous stable `v3.14.0` remains available for pinned installs (note: v3.11.0 Homebrew bounce/export is broken by a packaging omission fixed in v3.12.0 — #427) |\n\nIf this project helps you make music with Claude, Cursor, or any MCP client, star the repo. It helps the project reach more Logic Pro users and maintainers.\n\nWant to contribute? Start with the [Contributing Guide](https://github.com/MongLong0214/logic-pro-mcp/blob/main/CONTRIBUTING.md) and the [open issues](https://github.com/MongLong0214/logic-pro-mcp/issues?q=is%3Aissue%20is%3Aopen). Many docs, examples, validation tests, and CLI-message improvements do not require Logic Pro.\n\n## Why It Exists\n\nMost Logic Pro automation attempts fall into one of three traps:\n\n1. **Prompt-only recipes** that drift away from the real tool surface.\n2. **Keyboard macro automation** that can click the wrong target and still look successful.\n3. **Single-channel control** that can write to Logic but cannot reliably read what Logic actually did.\n\nLogic Pro MCP uses a different model. It routes each operation to the strongest available channel, exposes live state through MCP resources, and forces callers to handle three outcomes: confirmed, uncertain, or failed.\n\n## What It Controls\n\n| Area | What agents can do | Safety/readback model |\n|------|--------------------|-----------------------|\n| Transport | Play, stop, record, locate, cycle, metronome, tempo | CoreMIDI/AX routing with live `logic://transport/state` readback |\n| Tracks | Create, delete, duplicate, select, rename, mute, solo, arm, set instruments | Mutating targets require explicit index/name; uncertain selection fails closed before writes |\n| MIDI composition | Generate SMF server-side, import MIDI, send notes/CC/MMC, create virtual ports | `.mid` imports are constrained to server-managed temp files and must create a live track |\n| Mixer | Volume, pan, plugin snapshots, guarded stock plugin insertion | AX writes with same-surface readback for volume/pan (since #83); `set_master_volume` uses MCU echo; `set_send` is not exposed (State C `command_not_exposed`); occupied plugin slots refuse replacement |\n| Library | Scan Logic's instrument library and load patches by path | Disk/AX inventory is cached; disk scan dedupes user/app-bundle `.patch` candidates and `resolve_path` classifies kind/source/loadable before `set_instrument` |\n| Navigation | Bars, markers, zoom, view toggles | Marker navigation is target-faithful; cold-cache misses return failure instead of \"next marker\" |\n| Project lifecycle | New, open, save, save-as, close, bounce, export plan, quit | Destructive operations require confirmation; dry-run export plans do not open Logic or write artifacts |\n\n## Agent-Grade Surfaces\n\n**Tools are for actions and local artifact checks.** The public write surface is intentionally small: `logic_transport`, `logic_tracks`, `logic_mixer`, `logic_plugins`, `logic_midi`, `logic_edit`, `logic_navigate`, `logic_project`, and `logic_system`. `logic_audio` is read-only and verifies exported files after Logic writes them.\n\n**Resources are for state.** Clients should read `logic://transport/state`, `logic://tracks`, `logic://mixer`, `logic://project/info`, `logic://project/audit`, `logic://project/cleanup-plan`, `logic://midi/ports`, and related resources instead of burning tool calls on polling.\n\n**Evidence is separated from claims.** The README points to release evidence, current-main verification, and live media artifacts instead of implying that a successful command equals a verified Logic state.\n\n## Trust Model\n\n- **Honest Contract envelopes**: mutating operations return State A confirmed, State B uncertain with a reason, or State C failure with an error.\n- **Verified plugin apply-back**: `logic_plugins.*` uses HC v2 (`hc_schema: 2`) and returns State A only after project identity, target track, physical insert slot, plugin identity, and readback all agree.\n- **Fail-closed targets**: dangerous mixer, marker, track, MIDI import, and plugin operations require explicit targets and validation.\n- **Confirmation levels**: destructive/project and plugin insertion flows require explicit confirmation metadata before execution.\n- **Provenance labels**: read surfaces expose source, freshness, and evidence labels instead of forcing clients to guess.\n- **Installer hardening**: Homebrew pins SHA256; the shell installer refuses to run without explicit hash/team pins unless same-origin provenance is explicitly allowed.\n- **Release honesty**: published `v3.15.0` is the current stable install line, and README claims stay tied to shipped artifacts, release-tree tests, or explicitly linked live evidence.\n\n## Quick Start\n\n**Prerequisites**: macOS 14+ for the MCP server, Logic Pro (latest release prioritized — currently **12.3**, which Apple lists as requiring macOS 15.6+; older Logic versions down to the 12.0.1 floor are best-effort), and an MCP client that can launch a stdio server. Published GitHub Actions/Homebrew assets are universal (`arm64` + `x86_64`) and do not require Xcode. Bounce/export uses the bundled native CGEvent helper with no third-party click binary.\n\n> **Logic Pro version policy.** Logic Pro MCP tracks the **latest Logic Pro release as its first-class target** and validates against it (the strict live E2E runs on Logic Pro 12.3). When Apple ships a new Logic Pro version, supporting it is the top priority — the Accessibility/UI tree shifts between releases, so the newest version is where fixes land first. Older versions above the 12.0.1 floor remain best-effort and may lose parity as those UI surfaces change.\n\nThe package manifest uses Swift tools 6.0 for compatibility. Current source verification uses Xcode 16.4 / Swift 6.2 in CI.\n\nThe current published stable release is `v3.15.0` (2026-08-31 UTC). It ships ADHOC-signed universal artifacts when Apple Developer ID credentials are absent, plus `SHA256SUMS.txt` and `RELEASE-METADATA.json` for pinned installs. The runtime surface becomes 10 tools / 18 resources / 12 resource templates — the generated read-only operation catalog `logic://system/operations` ships as the 12th template. Headlines: `logic_audio.recommend_eq` now names its loudness gate `minimum_level`, `logic_system.refresh_cache` reports `refreshed: true` only after the cache advances, ambiguous AX selection and unprovable plug-in-editor identity fail closed, and `logic_plugins.set_eq_band_verified`, unflagged spectrum/EQ analysis, and mixer detent receipts are available. It carries v3.14.0's ambiguity-refusing AX locator resolution and per-operation qualification evidence, and v3.12.0's coordinate-free actuation campaign (mute/solo/arm, app-menu items, region selection use AX actions and key commands with observed-effect verification; the external click-tool fallback is retired), consent-gated record-arm key-command auto-setup (`system.setup_arm_key`), a locale-neutral modal classifier (localized plugin editors and the Drummer Smart Controls pane no longer block unrelated operations, while genuine modals keep blocking), ADR kernel behavior on by default (session-stable `target_ref`, operation-contract registry with strict params, verified-mutation saga preflight, operation trace), SecureFD-hardened trace-clear/support-bundle paths with a bounded saga lifecycle deadline, and the Homebrew packaging fix restoring bounce/export (`logic_variants.py` now ships — #427). It keeps the v3.9.0 MCP capability additions (`transport.toggle_autopunch`, resource subscriptions, workflow prompts, per-tool `outputSchema` / `structuredContent`), the v3.9.2 verified-plugin closed-window fix, and v3.10.0 desktop/Creator Studio targeting. The two v3.9.0 live-only surfaces (MIDI export read-back, Channel EQ verified params) remain honestly deferred with spike evidence.\n\n### 1. Install\n\n```bash\nbrew tap MongLong0214/logic-pro-mcp https://github.com/MongLong0214/logic-pro-mcp\nbrew trust monglong0214/logic-pro-mcp # Homebrew 6.0+ requires trusting third-party taps\nbrew install logic-pro-mcp\n```\n\nThe Homebrew formula pins both the release tarball URL and its SHA256; Homebrew itself is a trusted delivery channel with its own signature chain. This is the hardened path for production installs. (On Homebrew older than 6.0 the `brew trust` step does not exist — skip it.)\n\nFor source-tree development, build locally:\n\n```bash\ngit clone https://github.com/MongLong0214/logic-pro-mcp.git\ncd logic-pro-mcp\nswift build -c release\n```\n\n### 2. Register with an MCP client\n\nClaude Code:\n\n```bash\nclaude mcp add --scope user logic-pro -- LogicProMCP\n```\n\nGeneric MCP client config:\n\n```json\n{\n \"mcpServers\": {\n \"logic-pro\": {\n \"command\": \"LogicProMCP\"\n }\n }\n}\n```\n\nIf you built from source, point the command at `.build/release/LogicProMCP`.\n\n### 3. Complete Logic Pro setup\n\nRun the local checks:\n\n```bash\nLogicProMCP --check-permissions\n```\n\nThen complete the two Logic-side setup steps in [docs/SETUP.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/docs/SETUP.md):\n\n- Register the `LogicProMCP-MCU-Internal` MCU control surface.\n- Add the bundled Scripter insert if you need plugin-parameter writes.\n\nLogic 12.2+ does not auto-import the legacy Key Commands plist; the bundled preset is staged as a Manual MIDI Learn reference.\n\n### 4. Test from your agent\n\nAsk the client:\n\n> Check Logic Pro MCP health and show all ready channels.\n\nExpected: all 7 channels `ready` after full setup, or 5 if you intentionally skipped Key Commands and Scripter.\n\n### Pinned shell installer\n\nThe installer is **fail-closed**: it refuses to run without explicit `LOGIC_PRO_MCP_SHA256` + `LOGIC_PRO_MCP_TEAM_ID` env pins. It verifies the downloaded `LogicProMCP-macOS-universal.tar.gz` archive, so copy the SHA from that archive entry in the release's `SHA256SUMS.txt`:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/MongLong0214/logic-pro-mcp/v3.15.0/Scripts/install.sh -o install.sh\n# inspect install.sh, then:\nLOGIC_PRO_MCP_SHA256= \\\nLOGIC_PRO_MCP_TEAM_ID= \\\nbash install.sh\n```\n\nIf you knowingly accept same-origin provenance (hash + Team ID fetched from the same release as the binary), opt in explicitly:\n\n```bash\nLOGIC_PRO_MCP_ALLOW_SAME_ORIGIN=1 \\\nbash <(curl -fsSL https://raw.githubusercontent.com/MongLong0214/logic-pro-mcp/v3.15.0/Scripts/install.sh)\n```\n\nSee [SECURITY.md §Installer trust model](https://github.com/MongLong0214/logic-pro-mcp/blob/main/SECURITY.md#installer-trust-model) for the trust tiers and threat model.\n\n## Setup Doctor\n\nGetting an agent to reliably drive Logic Pro is mostly a permissions-and-environment problem: TCC grants, the right Logic version, a live document, a registered control surface, no blocking modal. `LogicProMCP doctor` is a first-class, **intent-aware readiness platform** built for exactly this — not a boolean \"is it installed\" check, but a diagnostic that tells you *which capabilities are ready, which are blocked, why, and what to do next* — and never reports green for something it could not actually verify.\n\n```bash\nLogicProMCP doctor # human-readable report, color when a TTY\nLogicProMCP doctor --json # stable machine contract (schema logic_pro_mcp_doctor.v4)\nLogicProMCP doctor --strict # exit code encodes overall status (CI gate)\nLogicProMCP doctor --profile core --client claude-desktop\nLogicProMCP doctor --check-updates # opt-in: also checks for a newer release\n```\n\n**Intent-aware profiles.** You are not forced through checks you'll never use. `--profile` scopes the required set to how you actually drive Logic — `core` (transport/tracks/AX), `mixer`, `keycmd`, `legacy-scripter`, or `full`. `--client` (`claude-code`, `claude-desktop`, `cursor`, `vscode`, `terminal`, `custom`) adds the registration checks that matter for that host. Aggregate status is scoped to the *selected* profile's required checks, so an MCU-only workflow isn't marked unhealthy for a Scripter gap it will never hit.\n\n**Capability readiness, not just check pass/fail.** Every check is mapped to the capabilities it gates (`track_management`, `midi_import`, `mixer_ax`, `mixer_mcu`, `keycmd_only_ops`, `verified_plugin_applyback`, `project_lifecycle`, …). The report tells you *\"MIDI import is ready; verified-plugin apply-back is blocked by PostEvent\"* — the language an agent (or an operator) can act on directly.\n\n**Causal chain — `fix_plan` and `blocked_by`.** Failures are ordered into a `fix_plan` (the next actions, most-unblocking first), and each downstream check names the upstream check that `blocked_by` it — so you fix the root, not the symptom. The `headline` restates the single next action.\n\n**Honesty is the whole point.** A check that could not run (missing capability, unreadable TCC db) is reported as an explicit `skipped` with a reason — it is never silently folded into a pass. Intentional skips (`--skip-channel ` with an optional `--skip-note`, e.g. you deliberately didn't register Scripter) are recorded and excluded from readiness without faking green. TCC findings are redacted to service/principal/state summaries — no raw local paths in the report.\n\n**Permission surface it verifies.** `--check-permissions` folds the four TCC grants a real agent needs and exits non-zero if any is missing: **Accessibility**, **Automation → Logic Pro**, **Automation → System Events** (a *separate* target — Logic being granted does not imply it), and **PostEvent** (Input Monitoring, required by the CGEvent bounce/click fallback). The doctor treats these as distinct capabilities because they fail independently: e.g. a `-1743` / `errAEEventNotPermitted` from System Events is a *launcher-permission* gap (the process responsible for launching the server is denied Automation → System Events), reported as such with the exact fix — not misattributed to Logic.\n\n**Strict exit codes** (`--strict`, for CI/agent gating): `0` ok · `1` failed · `2` manual_action_required · `3` degraded. Codes `2`/`3` are status codes, not usage errors, and sit below the `sysexits.h` range.\n\nA real (redacted) run on a box mid-setup:\n\n```jsonc\n{\n \"schema\": \"logic_pro_mcp_doctor.v4\",\n \"doctor_profile\": \"core\",\n \"status\": \"failed\",\n \"headline\": \"Next action [permissions.accessibility]: Accessibility permission is not granted\",\n \"fix_plan\": [\"permissions.accessibility\", \"permissions.post_event_access\", \"install.binary_inventory\"],\n \"summary\": { \"total\": 26, \"passed\": 15, \"warnings\": 1, \"failed\": 2, \"skipped\": 8, \"manual\": 0, \"duration_ms\": 333 },\n \"checks\": [ { \"id\": \"binary.path\", \"status\": \"pass\", \"category\": \"installation\", \"severity\": \"info\" } /* … */ ]\n}\n```\n\nThe same run in a terminal prints a grouped, color-coded report with per-check remediation anchors into [docs/SETUP.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/docs/SETUP.md). Full flag reference and every check's remediation live in [docs/SETUP.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/docs/SETUP.md#setup-doctor); the `--json` bytes are a stable contract you can assert against in your own onboarding automation.\n\n## Architecture at a Glance\n\nMCP clients launch the Swift stdio server. Dispatchers validate tool parameters, `ChannelRouter` chooses the strongest available macOS channel, resources expose cached/live state, and high-risk writes return explicit confirmed/uncertain/failed envelopes. The core channels are MCU, Accessibility, AppleScript, CoreMIDI, CGEvent, Scripter, and MIDI Key Commands.\n\n## Documentation\n\n| Document | Audience | Purpose |\n|----------|----------|---------|\n| [Setup Guide](https://github.com/MongLong0214/logic-pro-mcp/blob/main/docs/SETUP.md) | End users | Install, MCP registration, Logic Pro integration, doctor anchors |\n| [API Reference](https://github.com/MongLong0214/logic-pro-mcp/blob/main/docs/API.md) | End users, MCP clients | All 10 tools, 18 resources, 12 templates, Honest Contract, verified apply-back |\n| [Troubleshooting](https://github.com/MongLong0214/logic-pro-mcp/blob/main/docs/TROUBLESHOOTING.md) | End users | Common failures and fixes |\n| [Security Policy](https://github.com/MongLong0214/logic-pro-mcp/blob/main/SECURITY.md) | Security reviewers | Threat model, reporting, hardening |\n| [Changelog](https://github.com/MongLong0214/logic-pro-mcp/blob/main/CHANGELOG.md) | Everyone | Per-release changes |\n| [Contributing](https://github.com/MongLong0214/logic-pro-mcp/blob/main/CONTRIBUTING.md) | Contributors | Dev setup, scoped PR workflow, PR verification |\n\nThe public docs tree is intentionally scoped: setup, API, troubleshooting, README media, plus public issue PRDs/tickets that explain active or shipped user-visible remediation. Historical release notes, internal PRDs, private ticket boards, spike notes, and local live-evidence work files are kept out of `docs/`; public release history belongs in [CHANGELOG.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/CHANGELOG.md), GitHub Releases, merged PRs, and issue history.\n\n## Status\n\n**Published stable**: `v3.15.0` is available as a GitHub Release and Homebrew install. It carries the accumulated v3.6.0 -> v3.11.0 set, restores Homebrew bounce/export by packaging `logic_variants.py` with an import-closure release gate (#427), ships the coordinate-free actuation campaign and consent-gated arm auto-setup (#413), fixes localized-editor/Smart-Controls modal misclassification (#381, #405), and turns the ADR-002/003/004/005 kernel behavior on by default with SecureFD/saga hardening (#417, #412). Published metadata remains `team_id:\"ADHOC\"` / `signing:\"adhoc\"` when Developer ID credentials are absent, with universal `x86_64` + `arm64` artifacts produced by GitHub Actions.\n\n**Previous stable**: `v3.10.0` remains available as the Creator Studio support release; `v3.9.2` remains available as the verified plugin parameter write fix release; v3.9.1 and earlier remain available for pinned installs.\n\n## Verification\n\n| Gate | Current evidence |\n|------|------------------|\n| Full deterministic suite | Current source tree: `swift test --no-parallel` -> `3917` passed, `0` failed |\n| Release build | Current source tree: `swift build -c release` passed |\n| Python E2E syntax | PR #24 verification: `python3 -m py_compile Scripts/live-e2e-test.py` passed |\n| Targeted live plugin proof | Logic Pro 12.2: `logic_plugins.insert_verified track=6 insert=6 plugin=Gain` returned State A with `observed_slot:6`, `write_source:\"ax_exact_slot_popup\"`, and independent `get_inventory` readback |\n| Track/transport readback proof | Logic Pro 12.2: `logic://tracks` returned `source:\"ax_live\"`, real names, `placeholder_count:0`, `unknown_type_count:0`; cycle toggle/resource roundtrip reflected live UI state |\n| Strict live Logic Pro 12.3 | Last full strict live E2E on the v3.8.0 line: `372` passed / `1` skipped / `0` failed (`373` total). The v3.9.0 live-only surfaces were spike-tested and honestly deferred (see CHANGELOG **Deferred**; evidence under `docs/spikes/`). v3.12.0 keeps the v3.9.2 same-scenario A/B live proof for Compressor `threshold` and the v3.11.0 targeted live QA set, and adds the v3.12.0 release-tree whole-suite live qualification run (registered-operation independent-readback E2E on a clean Logic 12.3 session, 2026-07-21), a live-verified AXPress menu-item toggle, and the live arm auto-setup A–J matrix from #413 |\n| README media | Actual Logic Pro 12.2 capture derivatives are published under `docs/media/` |\n| v3.12.0 release evidence | GitHub Release, Actions logs, [CHANGELOG.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/CHANGELOG.md), issues #381/#393/#399/#401/#405/#412/#413/#415/#417/#427, and PRs #407-#428 |\n\nLive E2E defaults to the release binary. Protocol/security assertions run on any host; Logic/CoreMIDI-dependent checks skip unless a real Logic Pro session is visible. Strict mode converts live-gated skips to failures, treats missing project state as a failed cycle roundtrip precondition, and launches the MCP server under a trusted shell/tmux parent so macOS TCC evaluates the same parent context used by live client flows.\n\n## API Contracts That Matter\n\n- **Honest Contract envelope** — every mutating op returns State A confirmed, State B uncertain with `reason`, or State C hard failure with `error`. See [docs/API.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/docs/API.md).\n- **HC v2 plugin apply-back** — `logic_plugins.get_inventory`, `set_param_verified`, and `insert_verified` add `state` + `hc_schema: 2`; State C always carries `verified:false`, `write_attempted`, retry safety, and target identity where relevant.\n- **Fail-closed mutation targets** — mixer faders, plugin params, marker delete/rename, track delete/duplicate, and MIDI imports require explicit target parameters.\n- **Exact-slot plugin insertion** — `logic_plugins.insert_verified` targets the physical insert index returned by `get_inventory`, verifies the popup is anchored to that slot, and confirms success only by post-write inventory diff.\n- **Target-faithful navigation** — `goto_marker` returns `element_not_found` on a cold cache instead of advancing to the next marker.\n- **1-based MIDI channel** — `send_note`, `send_cc`, and `record_sequence` `ch` values accept 1..16 to match Logic's UI.\n- **Bounded raw SysEx** — `send_sysex` rejects payloads over 1024 bytes before CoreMIDI routing.\n- **Audible-bounce guardrails** — `record_sequence` refuses unverified GM Device / External MIDI imports, `logic://project/audit` marks External MIDI tracks with MIDI regions as export blockers, and `logic_project.bounce` refuses those blockers before opening the Bounce dialog.\n- **Audit phase split** — audit logs distinguish rejected calls, confirmation prompts, and executed route invocations.\n- **Verified project saves** — `project.save_as` verifies the target `.logicx` package exists and that existing packages advance modification time.\n- **Live project metadata** — `logic://project/info` promotes live transport tempo/sample-rate when available and falls back per-field to saved project metadata.\n- **Side-effect-free reads** — resources expose state, metadata, and cached inventory without mutating Logic.\n\n## Release & Distribution\n\nStable production tags use the GitHub Actions release workflow. `RELEASE-METADATA.json` records the exact signing mode, Team ID, and architectures for each artifact. When Developer ID credentials are absent, releases publish ADHOC artifacts with SHA256 metadata and install validation rather than pretending to be notarized.\n\nPer-release detail lives in [CHANGELOG.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/CHANGELOG.md). Security and installer trust tiers are documented in [SECURITY.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/SECURITY.md).\n\n## Registry Metadata\n\nThe repository ships `server.json` for the official MCP Registry metadata path. It is pinned to the current stable release (`v3.15.0`) and carries discovery tags for Logic Pro, DAW automation, MIDI, Claude/Cursor MCP clients, and music-production agents. The record is metadata-only because the registry package schema does not yet model Homebrew formulas or GitHub release tarballs as first-class package types. The install authority remains the pinned GitHub Release/Homebrew path above.\n\n## Known Limitations\n\n- **Tempo typing**: `transport.set_tempo` uses bounded coarse and exact AX slider fallbacks when Logic's inline tempo input does not commit, and fails closed if exact readback still cannot be verified.\n- **MIDI region padding**: `record_sequence` regions start at bar 1 and extend to the target bar using inaudible padding; note timing inside the region is exact, but the region can look longer than the phrase.\n- **External MIDI bounce readiness**: MIDI regions on GM Device / External MIDI tracks are not accepted as audible-bounce evidence by project audit or `logic_project.bounce`. Move or recreate the material on Software Instrument tracks before claiming a verified Logic Bounce.\n- **MIDI Key Commands**: Logic 12.2 does not accept the legacy `.plist` Key Commands import; manual MIDI Learn remains required for keycmd-only operations.\n- **Markers**: marker creation uses Logic's native Navigate menu and verifies the Marker List when it is readable. A closed/unreadable Marker List is reported as unreadable or served from the last readable cache instead of being promoted to a verified empty list. `rename_marker` remains `not_implemented`.\n- **Plugin parameter readback**: `logic_plugins.set_param_verified` opens the target insert's plugin window when needed and live-verifies Compressor `threshold` through that window; arbitrary plugin parameters remain future work and fail closed with `unsupported_param_readback`.\n\n## Development\n\nSource builds require Xcode 16.4+ / Swift 6.2 for the current verified toolchain.\n\n```bash\nswift test --no-parallel\nswift build -c release\npython3 -m py_compile Scripts/live-e2e-test.py\n```\n\nFor live attestation on a configured Logic Pro host:\n\n```bash\nLOGIC_PRO_MCP_STRICT_LIVE=1 Scripts/live-e2e-test.sh\n```\n\n## License\n\nMIT. See [LICENSE](https://github.com/MongLong0214/logic-pro-mcp/blob/main/LICENSE).\n\n## Contributing\n\nBug reports, PRs, and feature discussions are welcome. See [CONTRIBUTING.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/CONTRIBUTING.md) and the [open issues](https://github.com/MongLong0214/logic-pro-mcp/issues?q=is%3Aissue%20is%3Aopen) for the dev workflow.\n\nSecurity vulnerabilities: please do **not** open a public issue. See [SECURITY.md](https://github.com/MongLong0214/logic-pro-mcp/blob/main/SECURITY.md) for the private disclosure process.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_106":107,"_108":109,"_110":111,"_112":113,"_114":115,"_116":117},"requiredSecrets",[],"tags",[94,95,96,97,98,99,100,101,102,103,104,105],"assets",[],"stats",{"_92":81,"_93":81},"ratingAvg","reviewCount","ai-agents","app-automation","automation","daw","desktop-automation","logic-pro","logic-pro-x","macos","midi","music-production","music-tech","swift","topics",[94,95,96,97,98,99,100,101,118,102,119,103,104,105],"license","MIT","language","Swift","registryName","io.github.MongLong0214/logic-pro-mcp","homepage","https://github.com/MongLong0214/logic-pro-mcp#readme","packages",[],"mcp","model-context-protocol","ENV",{"_122":123,"_124":125,"_126":127},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]