Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AEDIFION_TOKEN | No | Pre-obtained bearer token (alternative to username/password) | |
| AEDIFION_BASE_URL | No | API base URL | https://api.cloud.aedifion.eu |
| AEDIFION_PASSWORD | No | Your aedifion account password | |
| AEDIFION_USERNAME | No | Your aedifion account email |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ping | Ping the aedifion API server to check availability. |
| get_api_version | Get the aedifion API version. |
| get_endpoints | List all available API endpoints. |
| get_label_definitions | Get all label definitions available in aedifion. |
| get_label_systems | Get available label/unit systems (e.g. SI, imperial). |
| get_user | Get the currently logged-in user's details. |
| update_user | Update the logged-in user's details. Args: first_name: New first name. last_name: New last name. |
| get_user_permissions | Get the logged-in user's project permissions. |
| get_user_roles | Get the logged-in user's roles. |
| ai_get_threads | List all AI conversation threads for the current user. Args: page: Page number for pagination. per_page: Number of items per page. |
| ai_get_thread | Get all messages in an AI conversation thread. Args: thread_id: The thread identifier. |
| ai_chat | Send a chat message to the aedifion AI assistant. Args: thread_id: The thread identifier (use 'new' for a new thread). message: The message to send. |
| ai_delete_thread | Delete an AI conversation thread. Args: thread_id: The thread identifier. |
| get_company | Get the current user's company details including projects and users. |
| update_company | Update company details. Args: name: New company name. description: New company description. |
| get_company_roles | Get all roles defined in the company. |
| get_company_permissions | Get all project permissions granted to the company. |
| get_company_labels | Get all labels assigned to the company. |
| create_project | Create a new project in the company. Args: name: Project name. description: Project description. |
| create_user | Create a new user in the company. Args: email: User email address. first_name: First name. last_name: Last name. password: Initial password. |
| get_company_user | Get details of a user within the company. Args: user_id: The user's numeric ID. |
| delete_company_user | Delete a user from the company. Args: user_id: The user's numeric ID. |
| get_realm_companies | Get all companies in the realm. Args: page: Page number. per_page: Items per page. |
| get_realm_projects | Get all projects in the realm. Args: page: Page number. per_page: Items per page. |
| get_realm_users | Get all users in the realm. Args: page: Page number. per_page: Items per page. |
| get_project | Get a project's details. Args: project_id: The project's numeric ID. |
| update_project | Update a project's details. Args: project_id: The project's numeric ID. name: New project name. description: New project description. |
| delete_project | Delete a project. Requires confirmation via the project name. Args: project_id: The project's numeric ID. project_name: The project name (for confirmation). |
| get_project_datapoints | Get all datapoints in a project. Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page. filter: Filter string for datapoint names. |
| get_project_timeseries | Get time series data for one or more datapoints in a project. Args: project_id: The project's numeric ID. datapoint_ids: Comma-separated datapoint IDs (hash keys or alternate keys). start: Start time in ISO 8601 format (e.g. '2024-01-01T00:00:00Z'). end: End time in ISO 8601 format. max: Maximum number of observations to return. samplerate: Resample interval (e.g. '15min', '1h', '1d'). interpolation: Interpolation method when resampling (e.g. 'linear', 'pad'). aggregation: Aggregation method when resampling (e.g. 'mean', 'sum', 'max', 'min'). short: If true, return short format (timestamps + values only). units_system: Unit system (e.g. 'SI', 'imperial'). currency_system: Currency system. |
| write_project_timeseries | Write timeseries data to datapoints in a project. Args: project_id: The project's numeric ID. timeseries_data: JSON string with timeseries data (list of objects with dataPointID, value, time). |
| delete_project_timeseries | Delete timeseries data for a datapoint. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. start: Start time in ISO 8601 format. end: End time in ISO 8601 format. |
| get_project_alerts | Get all alerts configured in a project. Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page. |
| get_project_tags | Get all datapoint tags in a project. Args: project_id: The project's numeric ID. key: Filter by tag key. keys_only: If true, return only tag keys without values. |
| add_project_tag | Add or overwrite a tag on a datapoint. Args: project_id: The project's numeric ID. tag_id: The tag identifier. key: Tag key. value: Tag value. |
| delete_project_tag | Delete a tag. Args: project_id: The project's numeric ID. tag_id: The tag identifier. |
| get_project_components | Get all components configured in a project. Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page. |
| get_project_component | Get a specific component in a project. Args: project_id: The project's numeric ID. cip_id: The component-in-project ID. |
| add_project_component | Add a component to a project. Args: project_id: The project's numeric ID. component_id: The component definition ID. |
| delete_project_component | Remove a component from a project. Args: project_id: The project's numeric ID. cip_id: The component-in-project ID. |
| get_component_pins | Get all pin mappings for a component in a project. Args: project_id: The project's numeric ID. cip_id: The component-in-project ID. |
| map_component_pin | Map a component pin to a datapoint. Args: project_id: The project's numeric ID. cip_id: The component-in-project ID. pin_id: The pin ID. datapoint_id: The datapoint identifier to map to. |
| unmap_component_pin | Unmap a pin from a component in a project. Args: project_id: The project's numeric ID. cip_id: The component-in-project ID. pin_id: The pin ID. |
| get_component_attributes | Get all attributes of a component in a project. Args: project_id: The project's numeric ID. cip_id: The component-in-project ID. |
| get_project_permissions | Get permissions configured for a project. Args: project_id: The project's numeric ID. |
| get_project_labels | Get all labels assigned to a project. Args: project_id: The project's numeric ID. |
| set_datapoint_renamings | Set alternate keys (renamings) for datapoints in a project. Args: project_id: The project's numeric ID. renamings: JSON string with renaming mappings (list of {dataPointID, alternateKey}). |
| get_project_setpoints | Get all setpoints in a project. Args: project_id: The project's numeric ID. |
| write_setpoint | Write a setpoint value to a datapoint. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. value: The setpoint value. priority: BACnet priority (1-16). |
| delete_setpoint | Delete a setpoint. Args: project_id: The project's numeric ID. setpoint_id: The setpoint ID. |
| get_setpoint_status | Get the status of a setpoint. Args: project_id: The project's numeric ID. setpoint_id: The setpoint ID. |
| get_project_weather | Get current weather for a project's location. Args: project_id: The project's numeric ID. units_system: Unit system (e.g. 'SI'). |
| get_project_weather_forecast | Get weather forecast for a project's location. Args: project_id: The project's numeric ID. units_system: Unit system (e.g. 'SI'). |
| grant_ai_consent | Grant or revoke consent for the AI Assistant on a project. Args: project_id: The project's numeric ID. consent: True to grant, False to revoke. |
| get_plot_views | Get all saved plot views for a project. Args: project_id: The project's numeric ID. |
| create_plot_view | Create a new plot view. Args: project_id: The project's numeric ID. plot_config: JSON string with the plot configuration. |
| delete_plot_view | Delete a plot view. Args: project_id: The project's numeric ID. plot_view_id: The plot view ID. |
| get_logbooks | Get all logbooks in a project. Args: project_id: The project's numeric ID. |
| create_logbook | Create a new logbook in a project. Args: project_id: The project's numeric ID. name: Logbook name. description: Logbook description. |
| get_logbook | Get a specific logbook. Args: project_id: The project's numeric ID. logbook_id: The logbook ID. |
| delete_logbook | Delete a logbook. Args: project_id: The project's numeric ID. logbook_id: The logbook ID. |
| create_logbook_entry | Create a new entry in a logbook. Args: project_id: The project's numeric ID. logbook_id: The logbook ID. title: Entry title. body_text: Entry body text. |
| delete_logbook_entry | Delete a logbook entry. Args: project_id: The project's numeric ID. logbook_id: The logbook ID. entry_id: The entry ID. |
| get_project_comments | Get all comments for a project. Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page. |
| add_project_comment | Add a comment to a project. Args: project_id: The project's numeric ID. text: Comment text. |
| delete_project_comment | Delete a project comment. Args: project_id: The project's numeric ID. comment_id: The comment ID. |
| get_datapoint | Get details about a specific datapoint. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier (hash key or alternate key). |
| update_datapoint | Update datapoint details. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. description: New description. unit: New unit string. |
| delete_datapoint | Delete a datapoint. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. |
| get_datapoint_timeseries | Get timeseries data for a single datapoint. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. start: Start time in ISO 8601 format. end: End time in ISO 8601 format. max: Maximum number of observations. samplerate: Resample interval (e.g. '15min', '1h'). interpolation: Interpolation method (e.g. 'linear', 'pad'). aggregation: Aggregation method (e.g. 'mean', 'sum'). short: Return short format. units_system: Unit system. |
| get_datapoint_usage | Get usage information for a datapoint (where it's referenced). Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. |
| get_favorite_datapoints | Get all personal favorite datapoints. Args: project_id: The project's numeric ID. |
| set_favorite_datapoint | Mark a datapoint as a personal favorite. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. |
| remove_favorite_datapoint | Remove a datapoint from personal favorites. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. |
| get_datapoint_labels | Get all labels assigned to a datapoint. Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. |
| create_threshold_alert | Create a new threshold-based alert. Args: project_id: The project's numeric ID. name: Alert name. datapoint_id: The datapoint to monitor. info_threshold: Info-level threshold value. warn_threshold: Warning-level threshold value. crit_threshold: Critical-level threshold value. email: Email address for notifications. telegram_chatid: Telegram chat ID for notifications. period: Evaluation period in seconds. |
| update_threshold_alert | Update a threshold alert's configuration. Args: alert_id: The alert ID. alert_details: JSON string with fields to update. |
| enable_alert | Enable an alert. Args: alert_id: The alert ID. |
| disable_alert | Disable an alert. Args: alert_id: The alert ID. |
| delete_alert | Delete an alert. Args: alert_id: The alert ID. |
| get_project_tasks | Get all tasks in a project. Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page. |
| create_task | Create a new task in a project. Args: project_id: The project's numeric ID. title: Task title. description: Task description. |
| get_task | Get details of a task. Args: task_id: The task ID. |
| update_task | Update a task. Args: task_id: The task ID. task_data: JSON string with fields to update (title, description, status, etc.). |
| delete_task | Delete a task. Args: task_id: The task ID. |
| assign_task | Assign a task to a user. Args: task_id: The task ID. user_id: The user ID to assign. |
| unassign_task | Unassign a task from a user. Args: task_id: The task ID. user_id: The user ID to unassign. |
| add_task_comment | Add a comment to a task. Args: task_id: The task ID. text: Comment text. |
| delete_task_comment | Delete a comment from a task. Args: task_id: The task ID. comment_id: The comment ID. |
| get_components | Get all available component definitions. |
| get_component_attribute_definitions | Get all attribute definitions for a component type. Args: component_id: The component definition ID. |
| get_component_pin_definitions | Get all pins and their attributes for a component type. Args: component_id: The component definition ID. |
| get_analytics_functions | Get all available analysis functions. |
| get_analytics_function | Get details of a specific analysis function. Args: function_id: The analysis function identifier. |
| get_analytics_instances | Get all analytics instances in a project. Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page. |
| create_analytics_instance | Create a new analytics instance. Args: project_id: The project's numeric ID. instance_config: JSON string with the instance configuration. |
| get_analytics_instance | Get an analytics instance's details. Args: instance_id: The instance ID. project_id: The project's numeric ID. |
| update_analytics_instance | Update an analytics instance. Args: instance_id: The instance ID. project_id: The project's numeric ID. instance_config: JSON string with fields to update. |
| delete_analytics_instance | Delete an analytics instance. Args: instance_id: The instance ID. project_id: The project's numeric ID. |
| enable_analytics_instance | Enable an analytics instance. Args: instance_id: The instance ID. project_id: The project's numeric ID. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |