Switch the active space. Updates the X-Space header sent with all API requests. Use this before accessing data in a different space.

List all inSCADA spaces. Spaces are the top level of the hierarchy.

List projects under a space. Returns project ID, name, description, and location.

List all SCADA variables (tags/points) in a project. Returns ALL variables — use search_variables instead when you need to filter by name or description.

Search SCADA variables by name, description, type, connection, device, or frame. Uses server-side filtering — much faster and lighter than listing all variables. Use this when user asks to find or filter variables.

List scripts in a project. Returns script ID, name, description, schedule type. Code content is not included.

Get full script code and details. Returns code, schedule config, owner, and history.

Update script code. Read with get_script first. Call inscada_guide for full script rules and ins.* API reference.

CRITICAL RULES (always apply):

• Nashorn ECMAScript 5 ONLY. DO NOT USE: let, const, =>, template literals, destructuring, async/await, class.

• STRUCTURE: function main() { /* code */ } main();

• Historical date: dttm is ISO string, NOT epoch. new Date(isoString) returns NaN in Nashorn. Use: ("" + items[i].dttm).substring(11, 19)

• Logged data is reverse-ordered (newest first) → use reverse loop for charts.

List connections in a project. With include_status=true, also returns connection status (Connected/Disconnected).

Search for text within all script code. Returns matching scripts with line numbers.

List animations in a project. Lightweight — SVG content not included.

Get animation details, elements, and linked scripts.

Read the LIVE (real-time, current) value of a single SCADA variable. MUST use this tool when user asks for current/live/real-time value. Returns value, timestamp, and variable info. project_id is optional (auto-detected if omitted).

Read LIVE (real-time, current) values of multiple SCADA variables in one call. MUST use this for batch live value queries. Returns {varName: {value, date}} map. project_id is optional (auto-detected if omitted).

Write a value to a SCADA variable. WARNING: Sends commands to real equipment.

List active (fired) alarms. Returns alarm name, status, trigger time, description.

Check connection status (Connected/Disconnected) for given connection IDs.

Check project runtime status: scripts, connections, alarm groups, data transfers, reports.

Execute a script on the inSCADA server. Returns the script's return value.

Check script execution status (Not Scheduled, Running, etc.).

Fetch historical logged data for variables (time series). Returns [{value, dttm, name, projectId}].

Get variable statistics (min, max, avg, sum, count, first, last) over a time range. Supports hourly or daily grouping.

Generate a time-series line chart. Fetches historical data from REST API automatically.

Generate a bar chart for variable comparison (statistics). Supports mean, max, min, sum, count aggregation.

Display a live gauge indicator. With auto_refresh=true (default), updates every 2 seconds from REST API. Use this for real-time gauge display instead of inscada_get_live_value.

Plot multiple data series on the same chart. Useful for comparing different variables.

Generate historical + forecast chart. Historical as solid line, forecast as dashed line. Analyze data first, then generate forecast_values.

List custom menus (3-level hierarchy). Returns menu ID, name, icon, position.

Get custom menu details and HTML content by ID.

Find and get custom menu details by name (exact match).

Create a custom menu page. USE TEMPLATES (gauge/line_chart/gauge_and_chart/multi_chart) when possible — no content needed with templates.

Update an existing custom menu. Read with get_custom_menu first. Can use templates to regenerate content.

Delete a custom menu by ID.

Export data to Excel (.xlsx) file. Supports multiple sheets. Returns a download link.

Discover inSCADA REST API endpoints. Search/filter among 625 endpoints by keyword, category, or HTTP method.

Get parameter and body schema for an API endpoint. Use before calling inscada_api to know required parameters.

Send generic HTTP request to inSCADA REST API. Access any /api/ endpoint. Non-GET requests require user confirmation. Use dedicated tools (inscada_get_live_value, list_variables, etc.) when available — only use this for endpoints without a dedicated tool. Call inscada_guide for animation creation rules, element types, and SVG requirements.

Key rules:

• Frame variables: 2-step. (1) POST /api/variables/filter/pages body:{projectId,frameId} → var list, (2) inscada_get_live_values → values.

• SVG REQUIRED: must include style="width:100%;height:100%;" viewBox="0 0 1920 1080" width="1920" height="1080".

• Animation props must never be null (at least "{}"). SVG ids = domId.

IMPORTANT: Call this tool FIRST before using any other inSCADA tool in a new conversation. Returns comprehensive usage guide including: Nashorn script rules (ECMAScript 5), ins.* API reference (30+ methods), animation element types (27 types), chart rules, custom menu rules, live value endpoints, tool priorities, and best practices. Without this guide you will make errors.

Returns detailed animation element rules: expression return types, dynamic props via return objects, SVG structure requirements, and element-specific examples. Call this BEFORE creating or modifying animations. The main inscada_guide gives a summary — this tool gives the full animation reference.