# list_control_surfaces

List all active ControlSurface instances (Push, APC, Launchkey, etc.).

Agent View of the PolicyLayer registry record for `list_control_surfaces`. HTML page: https://policylayer.com/tools/io-github-dreamrec-livepilot/list-control-surfaces

## Facts

- Tool: `list_control_surfaces`
- Server: Livepilot (`livepilot`) — https://policylayer.com/tools/io-github-dreamrec-livepilot.md
- Install: `npx -y livepilot`
- Homepage: https://github.com/dreamrec/LivePilot
- Risk category: Read (Low risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 0
- Recommended policy verdict: Allowed

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_control_surfaces",
    "arguments": {}
  }
}
```

## Why list_control_surfaces is rated Low

This tool performs read-only enumeration of active control surfaces (Push, APC, Launchkey hardware controllers) in Ableton Live. It retrieves and reports state information with no side effects, no data modification, and no capability to execute commands or delete data. This is a straightforward informational query with minimal security risk.

From the tool's own definition: "Tool name includes 'list' and description states 'List all active ControlSurface instances' — a query operation that retrieves information about connected hardware controllers without modification."

## Use case

AI agents call list_control_surfaces to retrieve information from Livepilot without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Livepilot:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "list_control_surfaces": {}
  }
}
```

## Other tools on Livepilot (473)

- `clear_clip_automation` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/clear-clip-automation.md
- `clear_simpler_slices` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/clear-simpler-slices.md
- `corpus_remove_source` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/corpus-remove-source.md
- `delete_clip` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/delete-clip.md
- `delete_device` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/delete-device.md
- `delete_rack_variation` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/delete-rack-variation.md
- `delete_scene` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/delete-scene.md
- `delete_track` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/delete-track.md
- `discard_experiment` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/discard-experiment.md
- `discard_preview_set` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/discard-preview-set.md
- `discard_wonder_session` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/discard-wonder-session.md
- `flatten_track` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/flatten-track.md
- `force_arrangement` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/force-arrangement.md
- `memory_delete` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/memory-delete.md
- `remove_arrangement_notes` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/remove-arrangement-notes.md
- `remove_arrangement_notes_by_id` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/remove-arrangement-notes-by-id.md
- `remove_notes` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/remove-notes.md
- `remove_notes_by_id` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/remove-notes-by-id.md
- `remove_rack_macro` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/remove-rack-macro.md
- `remove_simpler_slice` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/remove-simpler-slice.md
- `remove_warp_marker` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/remove-warp-marker.md
- `splice_remove_from_collection` — Destructive — https://policylayer.com/tools/io-github-dreamrec-livepilot/splice-remove-from-collection.md
- `apply_automation_recipe` — Execute — https://policylayer.com/tools/io-github-dreamrec-livepilot/apply-automation-recipe.md
- `back_to_arranger` — Execute — https://policylayer.com/tools/io-github-dreamrec-livepilot/back-to-arranger.md
- `build_project_brain` — Execute — https://policylayer.com/tools/io-github-dreamrec-livepilot/build-project-brain.md
- `build_reference_profile` — Execute — https://policylayer.com/tools/io-github-dreamrec-livepilot/build-reference-profile.md
- `build_song_brain` — Execute — https://policylayer.com/tools/io-github-dreamrec-livepilot/build-song-brain.md
- `capture_stop` — Execute — https://policylayer.com/tools/io-github-dreamrec-livepilot/capture-stop.md
- `compile_goal_vector` — Execute — https://policylayer.com/tools/io-github-dreamrec-livepilot/compile-goal-vector.md
- `continue_playback` — Execute — https://policylayer.com/tools/io-github-dreamrec-livepilot/continue-playback.md
- …and 443 more: https://policylayer.com/tools/io-github-dreamrec-livepilot.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=io-github-dreamrec-livepilot · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/io-github-dreamrec-livepilot