Skip to main content
Glama
ndwalters

inception-mcp

by ndwalters
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

inception-mcp

A small, read-only MCP server for the Inner Range Inception REST API. It lets an MCP client (Claude Code, Claude Desktop, etc.) see areas, doors, inputs, outputs and the review (event) log. It cannot arm, disarm, unlock, toggle outputs or change configuration.

Tools

Tool

What it does

inception_get_system_info

System name, serial, REST protocol version, and whether the firmware is supported (7.3.0.8528 or later)

inception_list_items

Areas / doors / inputs / outputs with decoded state (Disarmed, Locked, Active, ...). Filter by name_contains and has_state (e.g. inputs that are Active = open zones)

inception_get_events

Review log query: time range, categories, event type IDs, involved item IDs, pagination. Events come back with category and event-type name

inception_list_event_types

Offline search of the 500 event types in the API docs, to find IDs for message_ids (e.g. "disarmed" → 5201)

Related MCP server: KVMFleet MCP Server

Why it is read-only

  • The HTTP client only issues GET and only to these fixed paths: /api/protocol-version, /api/v1/system-info, /api/v1/control/{area|door|input|output}/summary and /api/v1/review. There is no generic "call any endpoint" tool and no request bodies.

  • No user, credential, PIN or configuration endpoints are exposed.

  • Give the Inception API user only the permissions it needs to see items. If the panel has no view-only permission level, remove Arm/Disarm/Control/Access rights entirely: controls would then fail with 403 even if this code had a bug.

Setup

1. Inception API user

  1. In Inception: Users → Manage Users, add a user (e.g. MCP Read-only).

  2. Set Web Page Profile to REST Web API User.

  3. Under Permissions, add the areas, doors, inputs and outputs you want visible (minimum rights).

  4. Under Credentials → User API Token, generate a token. Generating a new one invalidates the old one.

  5. Enable Review permission for the user if you want events (a 404 on /review usually means it is missing).

2a. Claude Desktop: one-click bundle (recommended)

  1. Download inception-mcp.mcpb from the latest release, then double-click it, or drag it into Claude Desktop (or Settings → Extensions → Advanced settings → Install Extension).

  2. Click Install, then fill in the form using:

    1. The controller URL (either local http://192.168.1.50 or through your SkyTunnel serial https://skytunnel.com.au/Inception/IN12345678).

    2. The previously created Inception User API Token.

  3. Enable the extension.

No Node.js install, no config-file editing: Claude Desktop runs the bundle with its built-in Node runtime, and the token is marked sensitive so it is stored in your OS credential store (Windows Credential Manager / macOS Keychain) rather than in a plain-text JSON file. To change the URL or token later: Settings → Extensions → Inner Range Inception → Configure.

2b. Claude Code (or any stdio MCP client)

Needs Node.js 20+.

npm install          # also builds dist/ via the prepare script
claude mcp add inception --scope user \
  -e INCEPTION_URL=<your Inception URL> \
  -e INCEPTION_API_TOKEN=<your User API Token> \
  -- node "$(pwd)/dist/index.js"

Stdio is the default transport, so nothing else is required. The client launches the server as a child process on demand; there is no port and nothing to keep running.

Building the bundle yourself

npm install
npm run pack:mcpb     # -> inception-mcp.mcpb (validated against the MCPB manifest schema)

manifest.json defines the install form (user_config) and maps it to environment variables. Bump version in package.json and re-pack to release an update; installing the new .mcpb replaces the old one.

Firmware / protocol version

Requires Inception firmware 7.3.0.8528 or later (REST API protocol version 18). This is fixed, not configurable: the server checks GET /api/protocol-version when it starts and exits with a clear message on older firmware. To check your controller:

curl http://<inception-ip>/api/protocol-version

If the panel is unreachable at startup the server still starts (with a warning) and tools return a clear error until it is back.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Parallels RAS MCP Server

    RMITBLOG
    A
    license
    A
    quality
    D
    maintenance
    A read-only MCP server that provides visibility into Parallels Remote Application Server infrastructure, policies, and sessions through the RAS REST API. It enables AI assistants to query site settings, published applications, and license status without performing any modifications.
    41
    2
    MIT
  • KVMFleet MCP Server by KVMFleet

    KVMFleet MCP Serverofficial

    KVMFleet
    A
    license
    A
    quality
    D
    maintenance
    Read-only MCP server that allows AI assistants to query and monitor KVM Fleet devices, audit logs, and console sessions through the official REST API.
    5
    8 npm
    1
    MIT

  • entraid-mcp

    sedattavukcu
    F
    license
    Not graded
    quality
    C
    maintenance
    Read-only MCP server for Microsoft Entra ID (Azure AD) that enables querying user sign-in logs, group memberships, and assigned Microsoft 365 licenses via Microsoft Graph API. Provides security and audit visibility without any write operations.
    -

  • trmm-mcp

    JohnGilligan2
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables read-only MCP access to Tactical RMM, allowing agents to query devices, clients, sites, audit logs, software, and pending actions without any mutating capabilities.
    MIT