Aedifion MCP Server
The Aedifion MCP Server provides AI assistants with 95+ tools to interact with the aedifion cloud API for building IoT data management, analytics, and control across these key areas:
Data & Timeseries: Query, write, and delete IoT timeseries data with resampling, interpolation, aggregation, and multi-unit support; manage datapoint details, favorites, labels, and alternate keys.
Project Management: Full CRUD for projects, including managing datapoints, alerts, tags, components, setpoints, permissions, plot views, logbooks, and comments.
User & Company Administration: View/update user profiles, permissions, and roles; manage company details, roles, labels, and users.
Realm Administration: List all companies, projects, and users across the realm (with pagination).
Analytics & KPIs: Manage analytics function instances (create, run, enable/disable); retrieve KPI overviews, energy efficiency, technical monitoring, operational optimization, and compliance data.
Alerts: Create, update, enable/disable, and delete threshold-based alerts with email/Telegram notifications.
Building Controls: Manage controls app instances — create, configure, enable/disable, and check status.
AI Assistant: Create and manage AI conversation threads and send messages to the aedifion AI assistant.
Tasks: Create, assign, update, delete, and comment on project tasks for team collaboration.
Component Definitions: Browse reusable component types, pin definitions, and attribute definitions.
Weather: Retrieve current conditions and forecasts for a building's location.
System & Diagnostics: Ping the API, check version, list all endpoints, and retrieve label/unit system definitions.
Allows configuring alerts to send notifications to Telegram channels or users via chat ID.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Aedifion MCP Server get the temperature timeseries for the Berlin office project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-aedifion
An MCP (Model Context Protocol) server that provides tools for interacting with the aedifion cloud API. This server enables AI assistants to:
Query building IoT data and timeseries
Run and manage analytics functions and KPIs
Configure alerts and controls
Manage projects, components, and datapoints
Access weather data for building locations
API documentation: https://api.cloud.aedifion.eu/ui/
Installation
Using uv (recommended)
uv pip install git+https://github.com/bbruhn91/mcp-server-aedifion.gitUsing pip
pip install git+https://github.com/bbruhn91/mcp-server-aedifion.gitFrom source
git clone https://github.com/bbruhn91/mcp-server-aedifion.git
cd mcp-server-aedifion
uv pip install -e .Related MCP server: skyspark-mcp
Configuration
Environment variables
The server requires aedifion API credentials. Create a .env file in your working directory (see .env.example):
cp .env.example .env
# Edit .env with your credentialsVariable | Required | Default | Description |
| Yes* | — | Your aedifion account email |
| Yes* | — | Your aedifion account password |
| No | — | Pre-obtained bearer token (alternative to username/password) |
| No |
| API base URL |
* Required unless AEDIFION_TOKEN is set.
Claude Desktop
Add the server to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"aedifion": {
"command": "mcp-server-aedifion",
"env": {
"AEDIFION_USERNAME": "your-email@example.com",
"AEDIFION_PASSWORD": "your-password"
}
}
}
}Or if running from source with uv:
{
"mcpServers": {
"aedifion": {
"command": "uv",
"args": [
"--directory", "/path/to/mcp-server-aedifion",
"run", "mcp-server-aedifion"
],
"env": {
"AEDIFION_USERNAME": "your-email@example.com",
"AEDIFION_PASSWORD": "your-password"
}
}
}
}Claude Code
claude mcp add aedifion -- mcp-server-aedifionOr with environment variables inline:
claude mcp add aedifion \
--env AEDIFION_USERNAME=your-email \
--env AEDIFION_PASSWORD=your-password \
-- mcp-server-aedifionOther MCP hosts
Any MCP-compatible host can use this server via the stdio transport. Run the mcp-server-aedifion command with the required environment variables set.
Tools
The server exposes 95+ tools organized by category. Each tool maps to one or more aedifion REST API endpoints.
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.first_name(string, optional): New first name.last_name(string, optional): 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.page(int, optional): Page number for pagination.per_page(int, optional): Number of items per page.
ai_get_thread— Get all messages in an AI conversation thread.thread_id(string, required): The thread identifier.
ai_chat— Send a chat message to the aedifion AI assistant.thread_id(string, required): The thread identifier (use'new'for a new thread).message(string, required): The message to send.
ai_delete_thread— Delete an AI conversation thread.thread_id(string, required): The thread identifier.
get_company— Get the current user's company details including projects and users.update_company— Update company details.name(string, optional): New company name.description(string, optional): 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.name(string, required): Project name.description(string, optional): Project description.
create_user— Create a new user in the company.email(string, required): User email address.first_name(string, required): First name.last_name(string, required): Last name.password(string, required): Initial password.
get_company_user— Get details of a user within the company.user_id(int, required): The user's numeric ID.
delete_company_user— Delete a user from the company.user_id(int, required): The user's numeric ID.
get_realm_companies— Get all companies in the realm.page(int, optional): Page number.per_page(int, optional): Items per page.
get_realm_projects— Get all projects in the realm.page(int, optional): Page number.per_page(int, optional): Items per page.
get_realm_users— Get all users in the realm.page(int, optional): Page number.per_page(int, optional): Items per page.
get_project— Get a project's details.project_id(int, required): The project's numeric ID.
update_project— Update a project's details.project_id(int, required): The project's numeric ID.name(string, optional): New project name.description(string, optional): New project description.
delete_project— Delete a project. Requires confirmation via the project name.project_id(int, required): The project's numeric ID.project_name(string, required): The project name (for confirmation).
get_project_datapoints— Get all datapoints in a project.project_id(int, required): The project's numeric ID.page(int, optional): Page number.per_page(int, optional): Items per page.filter(string, optional): Filter string for datapoint names.
get_project_timeseries— Get time series data for one or more datapoints.project_id(int, required): The project's numeric ID.datapoint_ids(string, required): Comma-separated datapoint IDs.start(string, optional): Start time in ISO 8601 format.end(string, optional): End time in ISO 8601 format.max(int, optional): Maximum number of observations.samplerate(string, optional): Resample interval (e.g.'15min','1h','1d').interpolation(string, optional): Interpolation method (e.g.'linear','pad').aggregation(string, optional): Aggregation method (e.g.'mean','sum','max','min').short(bool, optional): Return short format (timestamps + values only).units_system(string, optional): Unit system (e.g.'SI').currency_system(string, optional): Currency system.
write_project_timeseries— Write timeseries data to datapoints.project_id(int, required): The project's numeric ID.timeseries_data(string, required): JSON string with timeseries data.
delete_project_timeseries— Delete timeseries data for a datapoint.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.start(string, optional): Start time in ISO 8601 format.end(string, optional): End time in ISO 8601 format.
get_project_alerts— Get all alerts configured in a project.project_id(int, required): The project's numeric ID.page(int, optional): Page number.per_page(int, optional): Items per page.
get_project_tags— Get all datapoint tags in a project.project_id(int, required): The project's numeric ID.key(string, optional): Filter by tag key.keys_only(bool, optional): Return only tag keys without values.
add_project_tag— Add or overwrite a tag on a datapoint.project_id(int, required): The project's numeric ID.tag_id(string, required): The tag identifier.key(string, required): Tag key.value(string, required): Tag value.
delete_project_tag— Delete a tag.project_id(int, required): The project's numeric ID.tag_id(string, required): The tag identifier.
get_project_components— Get all components configured in a project.project_id(int, required): The project's numeric ID.page(int, optional): Page number.per_page(int, optional): Items per page.
get_project_component— Get a specific component in a project.project_id(int, required): The project's numeric ID.cip_id(int, required): The component-in-project ID.
add_project_component— Add a component to a project.project_id(int, required): The project's numeric ID.component_id(int, required): The component definition ID.
delete_project_component— Remove a component from a project.project_id(int, required): The project's numeric ID.cip_id(int, required): The component-in-project ID.
get_component_pins— Get all pin mappings for a component in a project.project_id(int, required): The project's numeric ID.cip_id(int, required): The component-in-project ID.
map_component_pin— Map a component pin to a datapoint.project_id(int, required): The project's numeric ID.cip_id(int, required): The component-in-project ID.pin_id(int, required): The pin ID.datapoint_id(string, required): The datapoint identifier to map to.
unmap_component_pin— Unmap a pin from a component in a project.project_id(int, required): The project's numeric ID.cip_id(int, required): The component-in-project ID.pin_id(int, required): The pin ID.
get_component_attributes— Get all attributes of a component in a project.project_id(int, required): The project's numeric ID.cip_id(int, required): The component-in-project ID.
get_project_permissions— Get permissions configured for a project.project_id(int, required): The project's numeric ID.
get_project_labels— Get all labels assigned to a project.project_id(int, required): The project's numeric ID.
set_datapoint_renamings— Set alternate keys (renamings) for datapoints in a project.project_id(int, required): The project's numeric ID.renamings(string, required): JSON string with renaming mappings.
get_project_setpoints— Get all setpoints in a project.project_id(int, required): The project's numeric ID.
write_setpoint— Write a setpoint value to a datapoint.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.value(float, required): The setpoint value.priority(int, optional): BACnet priority (1-16).
delete_setpoint— Delete a setpoint.project_id(int, required): The project's numeric ID.setpoint_id(int, required): The setpoint ID.
get_setpoint_status— Get the status of a setpoint.project_id(int, required): The project's numeric ID.setpoint_id(int, required): The setpoint ID.
get_project_weather— Get current weather for a project's location.project_id(int, required): The project's numeric ID.units_system(string, optional): Unit system.
get_project_weather_forecast— Get weather forecast for a project's location.project_id(int, required): The project's numeric ID.units_system(string, optional): Unit system.
grant_ai_consent— Grant or revoke consent for the AI Assistant on a project.project_id(int, required): The project's numeric ID.consent(bool, required): True to grant, False to revoke.
get_plot_views— Get all saved plot views for a project.project_id(int, required): The project's numeric ID.
create_plot_view— Create a new plot view.project_id(int, required): The project's numeric ID.plot_config(string, required): JSON string with the plot configuration.
delete_plot_view— Delete a plot view.project_id(int, required): The project's numeric ID.plot_view_id(int, required): The plot view ID.
get_logbooks— Get all logbooks in a project.project_id(int, required): The project's numeric ID.
create_logbook— Create a new logbook in a project.project_id(int, required): The project's numeric ID.name(string, required): Logbook name.description(string, optional): Logbook description.
get_logbook— Get a specific logbook.project_id(int, required): The project's numeric ID.logbook_id(int, required): The logbook ID.
delete_logbook— Delete a logbook.project_id(int, required): The project's numeric ID.logbook_id(int, required): The logbook ID.
create_logbook_entry— Create a new entry in a logbook.project_id(int, required): The project's numeric ID.logbook_id(int, required): The logbook ID.title(string, required): Entry title.body_text(string, required): Entry body text.
delete_logbook_entry— Delete a logbook entry.project_id(int, required): The project's numeric ID.logbook_id(int, required): The logbook ID.entry_id(int, required): The entry ID.
get_project_comments— Get all comments for a project.project_id(int, required): The project's numeric ID.page(int, optional): Page number.per_page(int, optional): Items per page.
add_project_comment— Add a comment to a project.project_id(int, required): The project's numeric ID.text(string, required): Comment text.
delete_project_comment— Delete a project comment.project_id(int, required): The project's numeric ID.comment_id(int, required): The comment ID.
get_datapoint— Get details about a specific datapoint.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier (hash key or alternate key).
update_datapoint— Update datapoint details.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.description(string, optional): New description.unit(string, optional): New unit string.
delete_datapoint— Delete a datapoint.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.
get_datapoint_timeseries— Get timeseries data for a single datapoint.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.start(string, optional): Start time in ISO 8601 format.end(string, optional): End time in ISO 8601 format.max(int, optional): Maximum number of observations.samplerate(string, optional): Resample interval (e.g.'15min','1h').interpolation(string, optional): Interpolation method.aggregation(string, optional): Aggregation method.short(bool, optional): Return short format.units_system(string, optional): Unit system.
get_datapoint_usage— Get usage information for a datapoint (where it's referenced).project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.
get_favorite_datapoints— Get all personal favorite datapoints.project_id(int, required): The project's numeric ID.
set_favorite_datapoint— Mark a datapoint as a personal favorite.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.
remove_favorite_datapoint— Remove a datapoint from personal favorites.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.
get_datapoint_labels— Get all labels assigned to a datapoint.project_id(int, required): The project's numeric ID.datapoint_id(string, required): The datapoint identifier.
create_threshold_alert— Create a new threshold-based alert.project_id(int, required): The project's numeric ID.name(string, required): Alert name.datapoint_id(string, required): The datapoint to monitor.info_threshold(float, optional): Info-level threshold value.warn_threshold(float, optional): Warning-level threshold value.crit_threshold(float, optional): Critical-level threshold value.email(string, optional): Email address for notifications.telegram_chatid(string, optional): Telegram chat ID for notifications.period(int, optional): Evaluation period in seconds.
update_threshold_alert— Update a threshold alert's configuration.alert_id(int, required): The alert ID.alert_details(string, required): JSON string with fields to update.
enable_alert— Enable an alert.alert_id(int, required): The alert ID.
disable_alert— Disable an alert.alert_id(int, required): The alert ID.
delete_alert— Delete an alert.alert_id(int, required): The alert ID.
get_project_tasks— Get all tasks in a project.project_id(int, required): The project's numeric ID.page(int, optional): Page number.per_page(int, optional): Items per page.
create_task— Create a new task in a project.project_id(int, required): The project's numeric ID.title(string, required): Task title.description(string, optional): Task description.
get_task— Get details of a task.task_id(int, required): The task ID.
update_task— Update a task.task_id(int, required): The task ID.task_data(string, required): JSON string with fields to update.
delete_task— Delete a task.task_id(int, required): The task ID.
assign_task— Assign a task to a user.task_id(int, required): The task ID.user_id(int, required): The user ID to assign.
unassign_task— Unassign a task from a user.task_id(int, required): The task ID.user_id(int, required): The user ID to unassign.
add_task_comment— Add a comment to a task.task_id(int, required): The task ID.text(string, required): Comment text.
delete_task_comment— Delete a comment from a task.task_id(int, required): The task ID.comment_id(int, required): The comment ID.
get_components— Get all available component definitions.get_component_attribute_definitions— Get all attribute definitions for a component type.component_id(int, required): The component definition ID.
get_component_pin_definitions— Get all pins and their attributes for a component type.component_id(int, required): The component definition ID.
get_analytics_functions— Get all available analysis functions.get_analytics_function— Get details of a specific analysis function.function_id(string, required): The analysis function identifier.
get_analytics_instances— Get all analytics instances in a project.project_id(int, required): The project's numeric ID.page(int, optional): Page number.per_page(int, optional): Items per page.
create_analytics_instance— Create a new analytics instance.project_id(int, required): The project's numeric ID.instance_config(string, required): JSON string with the instance configuration.
get_analytics_instance— Get an analytics instance's details.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
update_analytics_instance— Update an analytics instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.instance_config(string, required): JSON string with fields to update.
delete_analytics_instance— Delete an analytics instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
enable_analytics_instance— Enable an analytics instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
disable_analytics_instance— Disable an analytics instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
trigger_analytics_instance— Manually trigger an analytics instance to run.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
get_analytics_instance_result— Get results for an analytics instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.start(string, optional): Start time in ISO 8601 format.end(string, optional): End time in ISO 8601 format.units_system(string, optional): Unit system.currency_system(string, optional): Currency system.
get_analytics_instance_status— Get the status of an analytics instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
get_analytics_kpi_aggregation— Get aggregated KPI results across a project.project_id(int, required): The project's numeric ID.
get_analytics_components_kpi— Get aggregated KPI results per component.project_id(int, required): The project's numeric ID.
get_analytics_kpi_overview— Get a high-level KPI overview for a project.project_id(int, required): The project's numeric ID.
get_analytics_status— Get the analytics status overview for a project.project_id(int, required): The project's numeric ID.
get_technical_monitoring— Get technical monitoring data for a project.project_id(int, required): The project's numeric ID.start(string, optional): Start time in ISO 8601 format.end(string, optional): End time in ISO 8601 format.units_system(string, optional): Unit system.
get_energy_efficiency— Get energy efficiency analysis data for a project.project_id(int, required): The project's numeric ID.start(string, optional): Start time in ISO 8601 format.end(string, optional): End time in ISO 8601 format.units_system(string, optional): Unit system.
get_operational_optimization— Get operational optimization data for a project.project_id(int, required): The project's numeric ID.start(string, optional): Start time in ISO 8601 format.end(string, optional): End time in ISO 8601 format.units_system(string, optional): Unit system.
get_compliance— Get compliance data for a project.project_id(int, required): The project's numeric ID.
get_component_results— Get analytics results for a specific component in a project.cip_id(int, required): The component-in-project ID.project_id(int, required): The project's numeric ID.units_system(string, optional): Unit system.currency_system(string, optional): Currency system.
get_controls_apps— Get all available controls apps.get_controls_app— Get details of a specific controls app.app_id(string, required): The controls app identifier.
get_controls_instances— Get all controls instances in a project.project_id(int, required): The project's numeric ID.page(int, optional): Page number.per_page(int, optional): Items per page.
create_controls_instance— Create a new controls instance.project_id(int, required): The project's numeric ID.instance_config(string, required): JSON string with the controls instance configuration.
get_controls_instance— Get a controls instance's details.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
update_controls_instance— Update a controls instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.instance_config(string, required): JSON string with fields to update.
delete_controls_instance— Delete a controls instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
enable_controls_instance— Enable a controls instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
disable_controls_instance— Disable a controls instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
get_controls_instance_status— Get the status of a controls instance.instance_id(int, required): The instance ID.project_id(int, required): The project's numeric ID.
Usage examples
Check API connectivity
"Ping the aedifion API to check if it's available."
Browse projects and data
"Show me all projects in my company."
"List all datapoints in project 42 that contain 'temperature' in their name."
Query timeseries data
"Get the temperature readings for datapoint 'bacnet500-4120-External-Air-Temperature' in project 42 from the last 24 hours, resampled to 15-minute intervals."
Analytics
"What analysis functions are available? Show me the KPI overview for project 42."
"Get the energy efficiency analysis for project 42 for the last month."
Alerts
"Create a threshold alert on the room temperature datapoint in project 42 that warns at 26C and goes critical at 30C."
Building controls
"List all active controls instances in project 42 and show their current status."
Weather
"What's the current weather at the building location for project 42?"
Authentication
The server supports two authentication methods:
Username/Password (recommended): Set
AEDIFION_USERNAMEandAEDIFION_PASSWORD. The server automatically obtains and refreshes bearer tokens viaPOST /v2/user/token.Pre-obtained token: Set
AEDIFION_TOKENwith a valid bearer token. Useful for short-lived sessions or when credentials shouldn't be stored.
Token refresh happens automatically when a 401 Unauthorized response is received.
Error handling
The server wraps all API errors into clean, structured error messages. Instead of raw HTTP exceptions or tracebacks, tools return human-readable error descriptions including:
The HTTP status code
The API error message
The endpoint that failed
This makes it easy for AI assistants to understand and communicate errors to users.
Development
Setup
git clone https://github.com/bbruhn91/mcp-server-aedifion.git
cd mcp-server-aedifion
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"Running locally
# With environment variables
AEDIFION_USERNAME=user@example.com AEDIFION_PASSWORD=pass mcp-server-aedifion
# Or with a .env file
cp .env.example .env
# Edit .env with your credentials
mcp-server-aedifionTesting
pytest -vLinting
ruff check src/ tests/
ruff format --check src/ tests/Testing with MCP Inspector
npx @modelcontextprotocol/inspector mcp-server-aedifionArchitecture
src/mcp_server_aedifion/
__init__.py # Package init
client.py # HTTP client with auth handling and structured errors
server.py # MCP server with tool definitions and error handling
tests/
test_client.py # Client unit tests (auth, requests, errors)
test_server.py # Server tests (tool registration, error handling)client.py— Async HTTP client built onhttpx. Handles Basic Auth -> bearer token exchange, automatic token refresh on 401, and raises structuredAedifionErrorexceptions with status codes and API error details.server.py— MCP server built withFastMCP. Registers 95+ tools covering all 12 API categories. Each tool is wrapped with error handling that converts exceptions into clean error messages.
Contributing
See CONTRIBUTING.md for development guidelines.
License
MIT — see LICENSE.
Available Tools
123 toolsadd_project_commentC
Add a comment to a project.
Args: project_id: The project's numeric ID. text: Comment text.
Inputs: project_id (required), text (required). Returns: result
add_project_componentB
Add a component to a project.
Args: project_id: The project's numeric ID. component_id: The component definition ID.
Inputs: project_id (required), component_id (required). Returns: result
add_project_tagC
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.
Inputs: project_id (required), tag_id (required), key (required), value (required). Returns: result
add_task_commentC
Add a comment to a task.
Args: task_id: The task ID. text: Comment text.
Inputs: task_id (required), text (required). Returns: result
ai_chatB
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.
Inputs: thread_id (required), message (required). Returns: result
ai_delete_threadB
Delete an AI conversation thread.
Args: thread_id: The thread identifier.
Inputs: thread_id (required). Returns: result
ai_get_threadC
Get all messages in an AI conversation thread.
Args: thread_id: The thread identifier.
Inputs: thread_id (required). Returns: result
ai_get_threadsC
List all AI conversation threads for the current user.
Args: page: Page number for pagination. per_page: Number of items per page.
Inputs: page, per_page. Returns: result
assign_taskC
Assign a task to a user.
Args: task_id: The task ID. user_id: The user ID to assign.
Inputs: task_id (required), user_id (required). Returns: result
create_analytics_instanceB
Create a new analytics instance.
Args: project_id: The project's numeric ID. instance_config: JSON string with the instance configuration.
Inputs: project_id (required), instance_config (required). Returns: result
create_controls_instanceC
Create a new controls instance.
Args: project_id: The project's numeric ID. instance_config: JSON string with the controls instance configuration.
Inputs: project_id (required), instance_config (required).
create_logbookB
Create a new logbook in a project.
Args: project_id: The project's numeric ID. name: Logbook name. description: Logbook description.
Inputs: project_id (required), name (required), description. Returns: result
create_logbook_entryC
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.
Inputs: project_id (required), logbook_id (required), title (required), body_text (required). Returns: result
create_plot_viewC
Create a new plot view.
Args: project_id: The project's numeric ID. plot_config: JSON string with the plot configuration.
Inputs: project_id (required), plot_config (required). Returns: result
create_projectC
Create a new project in the company.
Args: name: Project name. description: Project description.
Inputs: name (required), description. Returns: result
create_taskB
Create a new task in a project.
Args: project_id: The project's numeric ID. title: Task title. description: Task description.
Inputs: project_id (required), title (required), description. Returns: result
create_threshold_alertB
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.
Inputs: project_id (required), name (required), datapoint_id (required), info_threshold, +5 more. Returns: result
create_userB
Create a new user in the company.
Args: email: User email address. first_name: First name. last_name: Last name. password: Initial password.
Inputs: email (required), first_name (required), last_name (required), password (required). Returns: result
delete_alertC
Delete an alert.
Args: alert_id: The alert ID.
Inputs: alert_id (required). Returns: result
delete_analytics_instanceC
Delete an analytics instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required). Returns: result
delete_company_userC
Delete a user from the company.
Args: user_id: The user's numeric ID.
Inputs: user_id (required). Returns: result
delete_controls_instanceC
Delete a controls instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required).
delete_datapointC
Delete a datapoint.
Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier.
Inputs: project_id (required), datapoint_id (required). Returns: result
delete_logbookC
Delete a logbook.
Args: project_id: The project's numeric ID. logbook_id: The logbook ID.
Inputs: project_id (required), logbook_id (required). Returns: result
delete_logbook_entryC
Delete a logbook entry.
Args: project_id: The project's numeric ID. logbook_id: The logbook ID. entry_id: The entry ID.
Inputs: project_id (required), logbook_id (required), entry_id (required). Returns: result
delete_plot_viewC
Delete a plot view.
Args: project_id: The project's numeric ID. plot_view_id: The plot view ID.
Inputs: project_id (required), plot_view_id (required). Returns: result
delete_projectB
Delete a project. Requires confirmation via the project name.
Args: project_id: The project's numeric ID. project_name: The project name (for confirmation).
Inputs: project_id (required), project_name (required). Returns: result
delete_project_commentC
Delete a project comment.
Args: project_id: The project's numeric ID. comment_id: The comment ID.
Inputs: project_id (required), comment_id (required). Returns: result
delete_project_componentC
Remove a component from a project.
Args: project_id: The project's numeric ID. cip_id: The component-in-project ID.
Inputs: project_id (required), cip_id (required). Returns: result
delete_project_tagC
Delete a tag.
Args: project_id: The project's numeric ID. tag_id: The tag identifier.
Inputs: project_id (required), tag_id (required). Returns: result
delete_project_timeseriesB
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.
Inputs: project_id (required), datapoint_id (required), start, end. Returns: result
delete_setpointB
Delete a setpoint.
Args: project_id: The project's numeric ID. setpoint_id: The setpoint ID.
Inputs: project_id (required), setpoint_id (required). Returns: result
delete_taskC
Delete a task.
Args: task_id: The task ID.
Inputs: task_id (required). Returns: result
delete_task_commentC
Delete a comment from a task.
Args: task_id: The task ID. comment_id: The comment ID.
Inputs: task_id (required), comment_id (required). Returns: result
disable_alertC
Disable an alert.
Args: alert_id: The alert ID.
Inputs: alert_id (required). Returns: result
disable_analytics_instanceC
Disable an analytics instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required).
disable_controls_instanceC
Disable a controls instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required).
enable_alertC
Enable an alert.
Args: alert_id: The alert ID.
Inputs: alert_id (required). Returns: result
enable_analytics_instanceC
Enable an analytics instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required). Returns: result
enable_controls_instanceC
Enable a controls instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required).
get_analytics_components_kpiC
Get aggregated KPI results per component.
Args: project_id: The project's numeric ID.
Inputs: project_id (required).
get_analytics_functionC
Get details of a specific analysis function.
Args: function_id: The analysis function identifier.
Inputs: function_id (required). Returns: result
get_analytics_functionsB
Get all available analysis functions.
Inputs: no named parameters. Returns: result
get_analytics_instanceB
Get an analytics instance's details.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required). Returns: result
get_analytics_instance_resultC
Get results for an analytics instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID. start: Start time in ISO 8601 format. end: End time in ISO 8601 format. units_system: Unit system. currency_system: Currency system.
Inputs: instance_id (required), project_id (required), start, end, +2 more.
get_analytics_instancesC
Get all analytics instances in a project.
Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page.
Inputs: project_id (required), page, per_page. Returns: result
get_analytics_instance_statusC
Get the status of an analytics instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required).
get_analytics_kpi_aggregationC
Get aggregated KPI results across a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required).
get_analytics_kpi_overviewB
Get a high-level KPI overview for a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required).
get_analytics_statusC
Get the analytics status overview for a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required).
get_api_versionA
Get the aedifion API version.
Inputs: no named parameters. Returns: result
get_companyA
Get the current user's company details including projects and users.
Inputs: no named parameters. Returns: result
get_company_labelsB
Get all labels assigned to the company.
Inputs: no named parameters. Returns: result
get_company_permissionsB
Get all project permissions granted to the company.
Inputs: no named parameters. Returns: result
get_company_rolesB
Get all roles defined in the company.
Inputs: no named parameters. Returns: result
get_company_userB
Get details of a user within the company.
Args: user_id: The user's numeric ID.
Inputs: user_id (required). Returns: result
get_complianceB
Get compliance data for a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required).
get_component_attribute_definitionsC
Get all attribute definitions for a component type.
Args: component_id: The component definition ID.
Inputs: component_id (required). Returns: result
get_component_attributesB
Get all attributes of a component in a project.
Args: project_id: The project's numeric ID. cip_id: The component-in-project ID.
Inputs: project_id (required), cip_id (required). Returns: result
get_component_pin_definitionsC
Get all pins and their attributes for a component type.
Args: component_id: The component definition ID.
Inputs: component_id (required). Returns: result
get_component_pinsC
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.
Inputs: project_id (required), cip_id (required). Returns: result
get_component_resultsC
Get analytics results for a specific component in a project.
Args: cip_id: The component-in-project ID. project_id: The project's numeric ID. units_system: Unit system. currency_system: Currency system.
Inputs: cip_id (required), project_id (required), units_system, currency_system.
get_componentsB
Get all available component definitions.
Inputs: no named parameters. Returns: result
get_controls_appC
Get details of a specific controls app.
Args: app_id: The controls app identifier.
Inputs: app_id (required).
get_controls_appsB
Get all available controls apps.
Inputs: no named parameters.
get_controls_instanceC
Get a controls instance's details.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required).
get_controls_instancesB
Get all controls instances in a project.
Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page.
Inputs: project_id (required), page, per_page.
get_controls_instance_statusC
Get the status of a controls instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required).
get_datapointC
Get details about a specific datapoint.
Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier (hash key or alternate key).
Inputs: project_id (required), datapoint_id (required). Returns: result
get_datapoint_labelsB
Get all labels assigned to a datapoint.
Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier.
Inputs: project_id (required), datapoint_id (required). Returns: result
get_datapoint_timeseriesB
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.
Inputs: project_id (required), datapoint_id (required), start, end, +6 more. Returns: result
get_datapoint_usageC
Get usage information for a datapoint (where it's referenced).
Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier.
Inputs: project_id (required), datapoint_id (required). Returns: result
get_endpointsB
List all available API endpoints.
Inputs: no named parameters. Returns: result
get_energy_efficiencyB
Get energy efficiency analysis data for a project.
Args: project_id: The project's numeric ID. start: Start time in ISO 8601 format. end: End time in ISO 8601 format. units_system: Unit system.
Inputs: project_id (required), start, end, units_system.
get_favorite_datapointsC
Get all personal favorite datapoints.
Args: project_id: The project's numeric ID.
Inputs: project_id (required). Returns: result
get_label_definitionsB
Get all label definitions available in aedifion.
Inputs: no named parameters. Returns: result
get_label_systemsB
Get available label/unit systems (e.g. SI, imperial).
Inputs: no named parameters. Returns: result
get_logbookC
Get a specific logbook.
Args: project_id: The project's numeric ID. logbook_id: The logbook ID.
Inputs: project_id (required), logbook_id (required). Returns: result
get_logbooksC
Get all logbooks in a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required). Returns: result
get_operational_optimizationC
Get operational optimization data for a project.
Args: project_id: The project's numeric ID. start: Start time in ISO 8601 format. end: End time in ISO 8601 format. units_system: Unit system.
Inputs: project_id (required), start, end, units_system.
get_plot_viewsC
Get all saved plot views for a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required). Returns: result
get_projectC
Get a project's details.
Args: project_id: The project's numeric ID.
Inputs: project_id (required). Returns: result
get_project_alertsC
Get all alerts configured in a project.
Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page.
Inputs: project_id (required), page, per_page. Returns: result
get_project_commentsB
Get all comments for a project.
Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page.
Inputs: project_id (required), page, per_page. Returns: result
get_project_componentB
Get a specific component in a project.
Args: project_id: The project's numeric ID. cip_id: The component-in-project ID.
Inputs: project_id (required), cip_id (required). Returns: result
get_project_componentsB
Get all components configured in a project.
Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page.
Inputs: project_id (required), page, per_page. Returns: result
get_project_datapointsC
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.
Inputs: project_id (required), page, per_page, filter. Returns: result
get_project_labelsB
Get all labels assigned to a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required). Returns: result
get_project_permissionsB
Get permissions configured for a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required). Returns: result
get_project_setpointsC
Get all setpoints in a project.
Args: project_id: The project's numeric ID.
Inputs: project_id (required). Returns: result
get_project_tagsB
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.
Inputs: project_id (required), key, keys_only. Returns: result
get_project_tasksC
Get all tasks in a project.
Args: project_id: The project's numeric ID. page: Page number. per_page: Items per page.
Inputs: project_id (required), page, per_page. Returns: result
get_project_timeseriesB
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.
Inputs: project_id (required), datapoint_ids (required), start, end, +7 more. Returns: result
get_project_weatherC
Get current weather for a project's location.
Args: project_id: The project's numeric ID. units_system: Unit system (e.g. 'SI').
Inputs: project_id (required), units_system. Returns: result
get_project_weather_forecastC
Get weather forecast for a project's location.
Args: project_id: The project's numeric ID. units_system: Unit system (e.g. 'SI').
Inputs: project_id (required), units_system. Returns: result
get_realm_companiesC
Get all companies in the realm.
Args: page: Page number. per_page: Items per page.
Inputs: page, per_page. Returns: result
get_realm_projectsC
Get all projects in the realm.
Args: page: Page number. per_page: Items per page.
Inputs: page, per_page. Returns: result
get_realm_usersB
Get all users in the realm.
Args: page: Page number. per_page: Items per page.
Inputs: page, per_page. Returns: result
get_setpoint_statusC
Get the status of a setpoint.
Args: project_id: The project's numeric ID. setpoint_id: The setpoint ID.
Inputs: project_id (required), setpoint_id (required). Returns: result
get_taskC
Get details of a task.
Args: task_id: The task ID.
Inputs: task_id (required). Returns: result
get_technical_monitoringC
Get technical monitoring data for a project.
Args: project_id: The project's numeric ID. start: Start time in ISO 8601 format. end: End time in ISO 8601 format. units_system: Unit system.
Inputs: project_id (required), start, end, units_system.
get_userB
Get the currently logged-in user's details.
Inputs: no named parameters. Returns: result
get_user_permissionsB
Get the logged-in user's project permissions.
Inputs: no named parameters. Returns: result
get_user_rolesA
Get the logged-in user's roles.
Inputs: no named parameters. Returns: result
grant_ai_consentB
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.
Inputs: project_id (required), consent (required). Returns: result
map_component_pinC
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.
Inputs: project_id (required), cip_id (required), pin_id (required), datapoint_id (required). Returns: result
pingA
Ping the aedifion API server to check availability.
Inputs: no named parameters. Returns: result
remove_favorite_datapointC
Remove a datapoint from personal favorites.
Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier.
Inputs: project_id (required), datapoint_id (required). Returns: result
set_datapoint_renamingsB
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}).
Inputs: project_id (required), renamings (required). Returns: result
set_favorite_datapointC
Mark a datapoint as a personal favorite.
Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier.
Inputs: project_id (required), datapoint_id (required). Returns: result
trigger_analytics_instanceC
Manually trigger an analytics instance to run.
Args: instance_id: The instance ID. project_id: The project's numeric ID.
Inputs: instance_id (required), project_id (required).
unassign_taskC
Unassign a task from a user.
Args: task_id: The task ID. user_id: The user ID to unassign.
Inputs: task_id (required), user_id (required). Returns: result
unmap_component_pinC
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.
Inputs: project_id (required), cip_id (required), pin_id (required). Returns: result
update_analytics_instanceC
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.
Inputs: instance_id (required), project_id (required), instance_config (required). Returns: result
update_companyB
Update company details.
Args: name: New company name. description: New company description.
Inputs: name, description. Returns: result
update_controls_instanceC
Update a controls instance.
Args: instance_id: The instance ID. project_id: The project's numeric ID. instance_config: JSON string with fields to update.
Inputs: instance_id (required), project_id (required), instance_config (required).
update_datapointC
Update datapoint details.
Args: project_id: The project's numeric ID. datapoint_id: The datapoint identifier. description: New description. unit: New unit string.
Inputs: project_id (required), datapoint_id (required), description, unit. Returns: result
update_projectC
Update a project's details.
Args: project_id: The project's numeric ID. name: New project name. description: New project description.
Inputs: project_id (required), name, description. Returns: result
update_taskC
Update a task.
Args: task_id: The task ID. task_data: JSON string with fields to update (title, description, status, etc.).
Inputs: task_id (required), task_data (required). Returns: result
update_threshold_alertC
Update a threshold alert's configuration.
Args: alert_id: The alert ID. alert_details: JSON string with fields to update.
Inputs: alert_id (required), alert_details (required). Returns: result
update_userC
Update the logged-in user's details.
Args: first_name: New first name. last_name: New last name.
Inputs: first_name, last_name. Returns: result
write_project_timeseriesC
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).
Inputs: project_id (required), timeseries_data (required). Returns: result
write_setpointB
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).
Inputs: project_id (required), datapoint_id (required), value (required), priority. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 123 tools
Most tools are clearly distinct, targeting specific resources and actions like projects, datapoints, analytics, tasks, and AI. However, some overlap exists, such as multiple 'get_' tools for different aspects of analytics or controls, which could cause confusion if an agent doesn't carefully read descriptions. Overall, the naming and domain separation are strong enough to minimize misselection.
Tool names follow a highly consistent verb_noun pattern throughout, using snake_case uniformly. Verbs like 'create_', 'delete_', 'get_', 'update_', 'enable_', 'disable_' are applied predictably across resources, making the set easy to navigate and understand. There are no deviations in style or convention.
With 123 tools, the count is excessive for a single server, making it overwhelming and difficult for an agent to manage. While the domain (building management and analytics) is broad, this many tools suggests poor scoping, likely leading to cognitive overload and inefficiency in tool selection, even if the coverage is comprehensive.
The tool set provides comprehensive CRUD and lifecycle coverage across all major domains: projects, datapoints, analytics, controls, tasks, AI, users, and more. There are no obvious gaps; for example, each resource has create, read, update, and delete operations, and workflows are fully supported with enabling, disabling, triggering, and status checks.
Related MCP Connectors
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
Connect your AI agent to 300+ methods and 100+ live tools
Verified, pay-per-use API tools for AI agents through one authenticated connection.
Discover, inspect and run 63,000+ agent tools from one balance. Pay per call, no subscriptions.
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceConnects AI assistants to SkySpark and Haxall building automation systems by dynamically exposing SkySpark Axon functions as MCP tools. Enables natural language interaction with building data, equipment, and automation functions through real-time tool discovery.5MIT- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with SkyFoundry SkySpark building automation data via the Model Context Protocol. It allows users to evaluate Axon expressions, perform CRUD operations on records, and manage project functions through a comprehensive suite of 21 tools.MIT
- AlicenseAqualityDmaintenanceConnects AI assistants to Tacit building digital twins to query buildings, equipment, sensors, and zones using natural language. It provides tools for exploring Brick-compliant knowledge graphs, fetching historical sensor data, and accessing site documents.4MIT
- FlicenseNot gradedqualityDmaintenanceProvides seamless access to 32 Acceleronix PaaS OpenAPIs for device management, data storage, and more, with intelligent tool management and Bearer token authentication.-