aas-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHELLSMITH_BASYX_ENV_HOST | No | The BaSyx Environment host URL. Override via environment variable or .env file. | http://localhost:8081 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_shellsA | Retrieves all Shells from the AAS server. Corresponds to: GET /shells |
| get_shellB | Retrieves a specific Shell by its ID. Corresponds to: GET /shells/{shell_id} |
| create_shellB | Creates a new Shell on the AAS server. Corresponds to: POST /shells |
| update_shellA | Updates an existing Shell on the AAS server by its ID. Corresponds to: PUT /shells/{shell_id} |
| delete_shellA | Deletes a specific Shell by its ID. Corresponds to: DELETE /shells/{shell_id} |
| get_submodel_refsA | Retrieves all submodel references from a specific Shell. Corresponds to: GET /shells/{shell_id}/submodel-refs |
| create_submodel_refA | Creates a submodel reference for a specific Shell. Corresponds to: POST /shells/{shell_id}/submodel-refs |
| delete_submodel_refB | Deletes a specific submodel reference from a Shell. Corresponds to: DELETE /shells/{shell_id}/submodel-refs/{submodel_id} |
| get_submodelsA | Retrieves all Submodels from the AAS server. Corresponds to: GET /submodels |
| get_submodelA | Retrieves a specific Submodel by its ID. Corresponds to: GET /submodels/{submodel_id} |
| create_submodelB | Creates a new Submodel on the AAS server. Corresponds to: POST /submodels |
| update_submodelC | Updates an existing Submodel by its ID. Corresponds to: PUT /submodels/{submodel_id} |
| delete_submodelB | Deletes a specific Submodel by its ID. Corresponds to: DELETE /submodels/{submodel_id} |
| get_submodel_valueA | Retrieves the raw value of a specific Submodel. Corresponds to: GET /submodels/{submodel_id}/$value |
| update_submodel_valueB | Updates the value of a specific Submodel. Corresponds to: PATCH /submodels/{submodel_id}/$value |
| get_submodel_metadataA | Retrieves the metadata of a specific Submodel. Corresponds to: GET /submodels/{submodel_id}/$metadata |
| get_submodel_elementsA | Retrieves all Submodel elements from a specific Submodel. Corresponds to: GET /submodels/{submodel_id}/submodel-elements |
| create_submodel_elementA | Creates a Submodel element. If Corresponds to: POST /submodels/{submodel_id}/submodel-elements POST /submodels/{submodel_id}/submodel-elements/{idShortPath} |
| get_submodel_elementB | Retrieves a specific Submodel element by its idShort path. Corresponds to: GET /submodels/{submodel_id}/submodel-elements/{id_short_path} |
| update_submodel_elementA | Updates or creates a Submodel element by full replacement. Corresponds to: PUT /submodels/{submodel_id}/submodel-elements/{idShortPath} |
| delete_submodel_elementB | Deletes a specific Submodel element by its idShort path. Corresponds to: DELETE /submodels/{submodel_id}/submodel-elements/{idShortPath} |
| get_submodel_element_valueA | Retrieves the raw value of a specific Submodel element. Corresponds to: GET /submodels/{submodel_id}/submodel-elements/{idShortPath}/$value |
| update_submodel_element_valueA | Updates the value of a specific Submodel element. Corresponds to: PATCH /submodels/{submodel_id}/submodel-elements/{id_short_path}/$value |
| get_health_statusB | Check health status of the AAS environment. |
| is_healthyB | Check if the AAS environment is ready for requests. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 25 tools
Most tools are clearly distinct, but update_submodel_element can also create elements, overlapping with create_submodel_element. Additionally, get_health_status and is_healthy serve similar purposes, which could cause confusion.
All tools follow a consistent verb_noun pattern, with plural forms for list operations (e.g., get_shells, get_submodels) and singular forms for specific items. The naming is predictable and uniform across the entire set.
With 25 tools, the server sits at the high end of the acceptable range. The domain is broad, but the count feels heavy, especially with multiple variants for value, metadata, and elements.
The tool set covers CRUD for all main resources: shells, submodels, submodel elements, and submodel references. Minor gaps exist, such as lacking an update operation for submodel references and metadata access for elements, but core workflows are well supported.