Skip to main content

An MCP server for reading, explaining, and editing Line 6 Helix Stadium (.hsp) presets. Independent/unofficial; not affiliated with Line 6 or Yamaha Guitar Group.

Project description

helix-stadium-mcp

An MCP server that lets an AI assistant read, explain, and (soon) edit Line 6 Helix Stadium .hsp guitar presets from natural language.

Disclaimer: helix-stadium-mcp is an independent, unofficial tool. It is not affiliated with, authorized, maintained, sponsored, or endorsed by Line 6 or Yamaha Guitar Group. "Line 6," "Helix," and "Helix Stadium" are trademarks of their respective owners, used here only nominatively to describe compatibility.

What it does

  • Reads .hsp presets losslessly (byte-exact round-trip).
  • Explains a preset in plain English — the full signal chain of each path with friendly model names, on/off state, per-snapshot & footswitch tags, and parameters in real units (dB, Hz, ms, %).
  • Diffs snapshots — exactly what changes between two snapshots (e.g. Rhythm vs Lead), in real units.
  • Browses the model catalog (list / describe / search models).
  • Validates a preset's structure (and, with the catalog, its model ids and controller sources).

Editing, generation, and setlist tooling are on the roadmap.

Requirements

  • Helix Stadium installed (Windows confirmed; macOS support in progress). The server reads the model catalog from your own install at runtime — no Line 6 content is bundled or redistributed.
  • Python 3.10+.

Install & configure

uvx twelvetake-helix-stadium-mcp serve      # or: pipx run twelvetake-helix-stadium-mcp serve

Add to your MCP client (e.g. Claude Desktop mcpServers):

{
  "mcpServers": {
    "helix-stadium": {
      "command": "uvx",
      "args": ["twelvetake-helix-stadium-mcp", "serve"]
    }
  }
}

If the catalog isn't auto-detected, set HELIX_STADIUM_RES to your install's res/ folder (the one containing P35ModelCatalog.json). Check detection with helix-stadium-mcp doctor.

Tools (v1)

read_preset · explain_preset · diff_snapshots · list_models · describe_model · search_models · validate_preset · detect_install

License

MIT © TwelveTake Studios LLC. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

twelvetake_helix_stadium_mcp-0.1.0.tar.gz (21.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

twelvetake_helix_stadium_mcp-0.1.0-py3-none-any.whl (22.8 kB view details)

Uploaded Python 3

File details

Details for the file twelvetake_helix_stadium_mcp-0.1.0.tar.gz.

File metadata

File hashes

Hashes for twelvetake_helix_stadium_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 989a26ab1e5308fdbd3a1689a7c959ab65e32ced455ffb4d3e51cf791ca1d84f
MD5 782624c301bcf538d1730ab79eea91bb
BLAKE2b-256 4762048325df7517e2e500aba3a2cb0086e452dff84f4d210e9a15efffce129d

See more details on using hashes here.

Provenance

The following attestation bundles were made for twelvetake_helix_stadium_mcp-0.1.0.tar.gz:

Publisher: publish.yml on TwelveTake-Studios/helix-stadium-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file twelvetake_helix_stadium_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for twelvetake_helix_stadium_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e932dfa04787856c14f978173843ee66dcba3acd197c124427c944a14e47569d
MD5 8ed429e12a8bf13150f6cbb3b7861417
BLAKE2b-256 feb19fcfe5843fbef4153bb6efa631e219f24afcdec3bfe4fd8344a013cc929d

See more details on using hashes here.

Provenance

The following attestation bundles were made for twelvetake_helix_stadium_mcp-0.1.0-py3-none-any.whl:

Publisher: publish.yml on TwelveTake-Studios/helix-stadium-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page