{"serverId":"mcp-registry/ai.dualsoft/aas","tools":[{"name":"dsdx.examples.get","fixed":{"name":"dsdx_examples_get","description":"Fetch the full official .ds2 source code, syntax notes, and metadata for a single starter example by id (equivalent aliases: exampleId, filename, key, name, example; id takes precedence) and optional lang ('ko', 'en', 'de', 'ja'). Missing or unknown id returns a validation error listing valid example IDs. Use after dsdx.examples.list when you need runnable DS2 code for /play or local editing; use dsdx.examples.list instead when browsing available examples.","inputSchema":{"type":"object","anyOf":[{"required":["id"]},{"required":["exampleId"]},{"required":["key"]},{"required":["filename"]},{"required":["example_id"]},{"required":["name"]},{"required":["example"]},{"required":["example_name"]},{"required":["path"]},{"required":["target"]},{"required":["file"]},{"required":["query"]},{"required":["q"]}],"properties":{"q":{"type":"string","description":"Alias for id"},"id":{"type":"string","examples":["tutorial-basic","st-conditions-v2"],"description":"Official example id or filename, e.g. 'basic', 'tutorial-basic', 'intermediate', 'xg5000-demo-kit', 'advanced', 'library-advanced', 'carwash', 'carwash-continuous', 'st-conditions-v2', 'robot-assembly-cell-v2', 'status-indicator-cell-v2'"},"bpm":{"type":"number","description":"Timeline tempo BPM when buildShow is true (40..220, default: 140.0)"},"key":{"type":"string","description":"Alias for id"},"file":{"type":"string","description":"Alias for id"},"lang":{"enum":["ko","en","de","ja"],"type":"string","description":"Preferred localized language: 'ko' (default) | 'en' | 'de' | 'ja'"},"name":{"type":"string","description":"Alias for id"},"path":{"type":"string","description":"Alias for id"},"query":{"type":"string","description":"Alias for id"},"width":{"type":"integer","description":"Canvas width in pixels when buildShow is true (320..3840)"},"height":{"type":"integer","description":"Canvas height in pixels when buildShow is true (180..3840)"},"target":{"type":"string","description":"Alias for id"},"example":{"type":"string","description":"Alias for id"},"filename":{"type":"string","description":"Alias for id (exact example filename)"},"buildShow":{"type":"boolean","description":"When true, generate a self-contained 3D Build Show + AAS offline viewer resourceUri for this official example"},"exampleId":{"type":"string","description":"Alias for id"},"example_id":{"type":"string","description":"Snake_case alias for id"},"includeHtml":{"type":"boolean","description":"Whether to inline UTF-8 HTML text in artifacts when buildShow is true (default: false)"},"aspectPreset":{"enum":["landscape-16x9","shorts-9x16","square-1x1"],"type":"string","description":"Optional 3D Build Show viewport preset when buildShow is true: 'landscape-16x9' | 'shorts-9x16' | 'square-1x1'"},"example_name":{"type":"string","description":"Alias for id"},"cleanShortsMode":{"type":"boolean","description":"Hide all chrome in ?shorts=1 mode when buildShow is true (default: true)"},"durationSeconds":{"type":"number","description":"Build Show timeline duration in seconds when buildShow is true (3..300, default: 32.0)"},"subPartAssembly":{"type":"boolean","description":"Animate sub-part assembly sequence when buildShow is true (default: true)"},"buildShowOptions":{"type":"object","description":"Optional dsdx-build-show/1.0 configuration object when buildShow is true"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.examples.get\" → \"dsdx_examples_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":947,"tokensAfter":947},{"name":"dsdx.examples.list","fixed":{"name":"dsdx_examples_list","description":"List official DS2 starter and tutorial examples (basic, tutorial-basic, intermediate, xg5000-demo-kit, advanced, carwash, st-conditions-v2, robot-assembly-cell-v2) with localized titles and metadata. Filter results with optional query (alias q), category ('fixture', 'st-expression', 'legacy'), lang ('ko', 'en', 'de', 'ja'), or languageVersion ('ds2/v2', 'ds2/v1'). Use to discover available example IDs before fetching full .ds2 source with dsdx.examples.get; use docs_search for reference specific","inputSchema":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Alias for query"},"lang":{"enum":["ko","en","de","ja"],"type":"string","description":"Preferred localized language: 'ko' (default) | 'en' | 'de' | 'ja'"},"query":{"type":"string","description":"Optional keyword filter across id, alias, and title"},"category":{"enum":["fixture","st-expression","legacy"],"type":"string","description":"Optional example category filter: 'fixture' | 'st-expression' | 'legacy'"},"languageVersion":{"enum":["ds2/v2","ds2/v1"],"type":"string","description":"Optional filter: 'ds2/v2' | 'ds2/v1'"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.examples.list\" → \"dsdx_examples_list\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":333,"tokensAfter":333},{"name":"dsdx.library.get","fixed":{"name":"dsdx_library_get","description":"Inspect one equipment model in the DualSoft Public 3D Library by id (equivalent aliases: assetId, modelId, model_id, slug; id takes precedence), returning dimensions, units, joints, semantic ports, usage rights, SHA-256 download links, and optional verified .ds2 source (DISPLAY_PREVIEW, keyless). Omitting id returns the default starter asset 'b01-01-belt-conveyor' with fallback=true; set view='summary' (default) for compact metadata or 'full' for complete node/binding trees, and includeDs2=true ","inputSchema":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Alias for id"},"id":{"type":"string","examples":["a01-01-six-axis-robot","b01-01-belt-conveyor"],"description":"Approved 3D library model ID (e.g. 'a01-01-six-axis-robot', 'b01-01-belt-conveyor'; optional: omitting returns starter asset 'b01-01-belt-conveyor' with fallback=true; call dsdx.library.search to browse all approved IDs)"},"item":{"type":"string","description":"Alias for id"},"name":{"type":"string","description":"Alias for id"},"view":{"enum":["summary","kinematics","full"],"type":"string","description":"Response detail level: 'summary' (compact <10KB bounds, joints, ports, links; recommended for multi-asset layout planning) | 'kinematics' (adds initialState & jointBindings) | 'full' (default on dsdx.library.get; includes complete scene nodes & frames)"},"model":{"type":"string","description":"Alias for id"},"query":{"type":"string","description":"Alias for id (fuzzy keyword search)"},"assetId":{"type":"string","description":"Alias for id"},"modelId":{"type":"string","description":"Alias for id"},"asset_id":{"type":"string","description":"Snake_case alias for id"},"model_id":{"type":"string","description":"Snake_case alias for id"},"packageId":{"type":"string","description":"Alias for id"},"package_id":{"type":"string","description":"Snake_case alias for id"},"assetTypeId":{"type":"string","description":"Alias for id"},"asset_type_id":{"type":"string","description":"Snake_case alias for id (matches search result asset_type_id)"},"includeDs2Source":{"type":"boolean","description":"Whether to include verified .ds2 (DSLText) source inline in ds2Source (default: true for 'full', false for 'summary'/'kinematics')"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.library.get\" → \"dsdx_library_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":645,"tokensAfter":645},{"name":"dsdx.library.search","fixed":{"name":"dsdx_library_search","description":"Search and count individual 3D equipment models in the DualSoft Public 3D Library (/ui/library/), returning modelCount, industrial category totals, usage rights, and SHA-256 pinned viewer/GLB/ZIP/DS2 links (DISPLAY_PREVIEW, keyless). Filter with optional q (equivalent aliases: query, search, keyword) and category, and paginate with limit (default 20, clamped to 1..200) and offset/page; public responses are subject to rate limits. Use to find equipment IDs before inspecting one model with dsdx.li","inputSchema":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Optional equipment keyword query (e.g. '로봇', '컨베이어', 'clamp', 'turntable'); omit or '' to count and list all approved 3D models"},"page":{"type":"integer","description":"Optional 1-based page number shorthand for offset = (page - 1) * limit when offset is omitted"},"term":{"type":"string","description":"Alias for q"},"text":{"type":"string","description":"Alias for q"},"limit":{"type":"integer","description":"Maximum items to return in items[] (1..200, default: 20; values above 200 are clamped to 200; modelCount and total always report the full count)"},"query":{"type":"string","description":"Alias for q"},"offset":{"type":"integer","description":"Pagination offset into matching items (0..10000, default: 0)"},"search":{"type":"string","description":"Alias for q"},"keyword":{"type":"string","description":"Alias for q"},"category":{"type":"string","description":"Optional industrial category filter (e.g. 'A 공통 자동화와 가공', 'B 이송 물류와 포장', 'E 자동차모빌리티', 'L 반도체'; call with {} first to view all categories and counts)"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.library.search\" → \"dsdx_library_search\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":472,"tokensAfter":472},{"name":"dsdx.ping","fixed":{"name":"dsdx_ping","description":"Check MCP server liveness, product version, active spec/protocol metadata (DS2-SPEC-V2.0, DSDX-MCP/1.0), and live buildCommit. Accepts an optional echo string reflected in the response. Use for quick health or version checks; use dsdx.start instead for onboarding workflow guidance and starter examples.","inputSchema":{"type":"object","required":[],"properties":{"echo":{"type":"string","description":"Optional echo probe string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.ping\" → \"dsdx_ping\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":139,"tokensAfter":139},{"name":"dsdx.plc.formats","fixed":{"name":"dsdx_plc_formats","description":"List the static catalog of PLC vendors and project file formats supported by DS Studio's local PLC reverse-engineering pipeline (first release: LS ELECTRIC XG5000 .xgwx to DS2 v2 and IDTA 01005 v3.0.1 AASX). Filter the catalog with optional vendor, extension, or filter parameters (equivalent aliases: vendorHint, ext, query, q). Use to check supported PLC formats before running local .xgwx conversion in DS Studio (/play) or Local MCP; this public endpoint is read-only and does not ingest PLC file","inputSchema":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Alias of filter"},"ext":{"type":"string","description":"Alias of extension filter"},"query":{"type":"string","description":"Alias of filter"},"filter":{"type":"string","description":"Substring filter on vendor or format name"},"vendor":{"type":"string","examples":["ls"],"description":"Optional PLC vendor filter (e.g. 'ls', 'siemens', 'mitsubishi', 'rockwell', 'omron', 'codesys', 'beckhoff')"},"extension":{"type":"string","examples":[".xgwx"],"description":"Optional file extension filter (e.g. '.xgwx', '.xml', '.l5x')"},"vendorHint":{"type":"string","description":"Alias of vendor filter"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.plc.formats\" → \"dsdx_plc_formats\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":352,"tokensAfter":352},{"name":"dsdx.scene.build_show_demo","fixed":{"name":"dsdx_scene_build_show_demo","description":"Generate a self-contained 3D Build Show & integrated 3D-AAS offline viewer HTML resource URI from an official built-in public example (no customer source uploaded). Supports id/exampleId, lang/language ('ko'|'en'), aspectPreset ('landscape-16x9'|'shorts-9x16'|'square-1x1'), cleanShortsMode, subPartAssembly, width, height, durationSeconds, bpm, buildShow/buildShowOptions, and includeHtml.","inputSchema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"Built-in official demo example id (default: 'status-indicator-cell-v2'; e.g. 'robot-assembly-cell-v2', 'intermediate')"},"bpm":{"type":"number","description":"Timeline tempo BPM (40..220, default: 140.0)"},"lang":{"enum":["ko","en","de","ja"],"type":"string","description":"Alias for language"},"width":{"type":"integer","description":"Canvas width in pixels (320..3840)"},"height":{"type":"integer","description":"Canvas height in pixels (180..3840)"},"language":{"enum":["ko","en","de","ja"],"type":"string","description":"UI language: 'ko' (default) | 'en'"},"buildShow":{"type":"object","description":"Optional declarative dsdx-build-show/1.0 options"},"exampleId":{"type":"string","description":"Alias for id"},"includeHtml":{"type":"boolean","description":"Whether to inline UTF-8 HTML text in artifacts (default: false; retrieve via resourceUri with resources/read)"},"aspectPreset":{"enum":["landscape-16x9","shorts-9x16","square-1x1"],"type":"string","description":"Viewport preset: 'landscape-16x9' (default) | 'shorts-9x16' | 'square-1x1'"},"cleanShortsMode":{"type":"boolean","description":"Hide UI chrome in ?shorts=1 clean shorts mode (default: true)"},"durationSeconds":{"type":"number","description":"Build Show timeline duration in seconds (3..300, default: 32.0)"},"subPartAssembly":{"type":"boolean","description":"Animate precision sub-part assembly sequence (default: true)"},"buildShowOptions":{"type":"object","description":"Alias for buildShow"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.scene.build_show_demo\" → \"dsdx_scene_build_show_demo\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":567,"tokensAfter":567},{"name":"dsdx.scene.catalog","fixed":{"name":"dsdx_scene_catalog","description":"Inspect configured 3D device library providers (DualSoft public, customer private, local air-gapped) for provider-level catalog readiness, version pins, and asset resolution (DSDX-3D-PROVIDER-1). Pass action='list' (default) with optional category, q/keyword, and limit (clamped to 1..200), or action='resolve' with assetTypeId/id to verify provider resolution. Use for provider-level 3D registry diagnostics rather than browsing individual public models; use dsdx.library.search and dsdx.library.get","inputSchema":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Alias for query"},"id":{"type":"string","description":"Alias for assetTypeId"},"limit":{"type":"integer","description":"Maximum catalog search results (1..200; default 200; values above 200 are clamped to 200). Narrow query/provider to find other devices."},"query":{"type":"string","description":"Search query by assetTypeId, label, or category (e.g. 'conveyor', '로봇', '검사기')"},"action":{"enum":["search","manifest","resolve","providers"],"type":"string","description":"Catalog action: 'search' (default) | 'providers' | 'manifest' (requires providerId+assetTypeId+releaseVersion) | 'resolve' (requires providerId+assetTypeId+releaseVersion)"},"keyword":{"type":"string","description":"Alias for query"},"category":{"type":"string","description":"Optional device category or role filter (exact/substring match against provider taxonomy such as 'A 공통 자동화와 가공', 'B 이송 물류와 포장', or role keyword 'Robot'/'Conveyor'/'Buffer'/'Inspector'/'Actuator')"},"packageId":{"type":"string","description":"Exact package identity from catalog resolve (sha256 digest)"},"package_id":{"type":"string","description":"Snake_case alias for packageId (matches catalog search output)"},"providerId":{"type":"string","description":"Target library provider ID ('dualsoft-public' | 'customer-private' | 'local-airgapped')"},"assetTypeId":{"type":"string","description":"Target device asset_type_id (e.g. 'b01-01-belt-conveyor')"},"provider_id":{"type":"string","description":"Snake_case alias for providerId (matches catalog search output)"},"asset_type_id":{"type":"string","description":"Snake_case alias for assetTypeId (matches catalog search output)"},"releaseVersion":{"type":"string","description":"Pinned release version (e.g. '2026.11.15' or '1.1.0')"},"release_version":{"type":"string","description":"Snake_case alias for releaseVersion (matches catalog search output)"},"requiredSdkVersion":{"type":"string","description":"Required authoring SDK version (e.g. '1.1.0')"},"expectedSourceSha256":{"type":"string","description":"Expected UTF-8 LF normalized source SHA-256 digest"},"required_sdk_version":{"type":"string","description":"Snake_case alias for requiredSdkVersion"},"expectedDeliverySha256":{"type":"string","description":"Expected exact delivery byte SHA-256 digest"},"expected_source_sha256":{"type":"string","description":"Snake_case alias for expectedSourceSha256"},"expected_delivery_sha256":{"type":"string","description":"Snake_case alias for expectedDeliverySha256"}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.scene.catalog\" → \"dsdx_scene_catalog\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":873,"tokensAfter":873},{"name":"dsdx.start","fixed":{"name":"dsdx_start","description":"START HERE on this public read-only DS Studio MCP: call with {} or an optional goal (max 500 chars) and languageVersion ('ds2/v2' default or 'ds2/v1'). Returns an official starter .ds2 example, reference metadata, and next read-only lookup steps; actual .ds2 compilation, verification, and PLC conversion run locally in DS Studio (/play) or Local MCP rather than uploading customer code. Use first to orient on docs, examples, and 3D library tools; use dsdx.ping for bare health checks or dsdx.exampl","inputSchema":{"type":"object","required":[],"properties":{"goal":{"type":"string","maxLength":500,"description":"Optional goal, at most 500 Unicode characters. Hint only; returns an official example."},"languageVersion":{"enum":["ds2/v2","ds2/v1"],"type":"string","description":"Starter profile: ds2/v2 (default ST expression example) or ds2/v1 (legacy example)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false}},"changes":[{"kind":"name","detail":"Renamed \"dsdx.start\" → \"dsdx_start\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":260,"tokensAfter":260}],"toolsChanged":9,"tokensSaved":0,"todo":[],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}