HISE MCP Server

An MCP server providing AI assistants with access to HISE documentation, the Scripting API, code examples, forum search, and curated style/workflow guides.

The server is documentation-only. Live HISE control (launch, recompile, scriptnode editing, UI editing, screenshots, REPL, profiling, plugin builds) lives in the standalone hise-cli tool — see https://github.com/christophhart/hise-cli.

Quick Start

Connect to the hosted server — no installation required.

URL: https://docs.hise.dev/mcp

Requirements: Free HISE Store account for authorization token

Available features:

• Search across all HISE documentation, examples, and the forum

• Query UI properties, Scripting API, module parameters, LAF functions

• Browse code examples and tutorial videos

• Access development workflow and style guides

MCP Client Configuration

Opencode

Config location:

• macOS/Linux: ~/.config/opencode/opencode.json

• Windows: %USERPROFILE%\.config\opencode\opencode.json

{
  "mcp": {
    "hise": {
      "type": "remote",
      "url": "https://docs.hise.dev/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer abc1234..."
      }
    }
  }
}

Claude Code (CLI)

claude mcp add --transport sse hise -- https://docs.hise.dev/mcp

Use --scope project to store the config in .mcp.json (shared via version control) or --scope user to make it available across all projects.

Claude Desktop

Config location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hise": {
      "url": "https://docs.hise.dev/mcp",
      "headers": {
        "Authorization": "Bearer abc1234..."
      }
    }
  }
}

Available Tools

REST API

The same read-only tools are also exposed as stateless REST endpoints for CLI clients that do not need the MCP session handshake.

• OpenAPI spec: GET /api/openapi.yaml

• Tool discovery: GET /api/tools

• Tool execution: POST /api/tools/:name

Example:

curl http://localhost:3000/api/tools

curl -X POST http://localhost:3000/api/tools/query_scripting_api \
  -H 'Content-Type: application/json' \
  -d '{"apiCall":"Synth.addNoteOn","examples":true}'

The execution endpoint accepts the same JSON arguments as the MCP tool and returns a JSON envelope with tool, ok, isError, and content. REST callers receive real HTTP status codes such as 400 for missing arguments, 404 for unknown tools or missing lookup targets, 429 for rate limiting, and 503 while indexes are unavailable.

Running Locally (for Development)

The server can also be hosted locally — useful when developing the server itself or running it on your own infrastructure.

git clone https://github.com/christoph-hart/hise_mcp_server
cd hise_mcp_server
npm install
npm run build
npm start

Listens on http://localhost:3000/mcp by default, with REST endpoints under http://localhost:3000/api. Override the port via PORT=4406 npm start.

Troubleshooting

Remote server returns 401 Unauthorized

• Verify your HISE Store token is valid

• Check the Authorization header format: Bearer <token>

Tools not appearing in your AI assistant

• Restart your MCP client after configuration changes

• Verify the config file path and JSON syntax

Need live HISE control?

The MCP server itself does not drive HISE. Install hise-cli and use commands like hise-cli -hise launch, hise-cli -script "...", hise-cli -ui set <id>.<prop> <value>, hise-cli -wizard run recompile. See https://github.com/christophhart/hise-cli.

Development

After pulling updates:

git pull
npm run build

Auto-rebuild during development:

npm run dev

See AGENTS.md for technical implementation details.

License

MIT