Skip to main content
Glama
Aedifion MCP Server

Aedifion MCP Server

by tookta91

mcp-server-aedifion

CI License: MIT Python 3.10+

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.git

Using pip

pip install git+https://github.com/bbruhn91/mcp-server-aedifion.git

From 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 credentials

Variable

Required

Default

Description

AEDIFION_USERNAME

Yes*

—

Your aedifion account email

AEDIFION_PASSWORD

Yes*

—

Your aedifion account password

AEDIFION_TOKEN

No

—

Pre-obtained bearer token (alternative to username/password)

AEDIFION_BASE_URL

No

https://api.cloud.aedifion.eu

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-aedifion

Or with environment variables inline:

claude mcp add aedifion \
  --env AEDIFION_USERNAME=your-email \
  --env AEDIFION_PASSWORD=your-password \
  -- mcp-server-aedifion

Other 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:

  1. Username/Password (recommended): Set AEDIFION_USERNAME and AEDIFION_PASSWORD. The server automatically obtains and refreshes bearer tokens via POST /v2/user/token.

  2. Pre-obtained token: Set AEDIFION_TOKEN with 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-aedifion

Testing

pytest -v

Linting

ruff check src/ tests/
ruff format --check src/ tests/

Testing with MCP Inspector

npx @modelcontextprotocol/inspector mcp-server-aedifion

Architecture

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 on httpx. Handles Basic Auth -> bearer token exchange, automatic token refresh on 401, and raises structured AedifionError exceptions with status codes and API error details.

  • server.py — MCP server built with FastMCP. 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 tools
add_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

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

    B3.1/5.0

    Scored across 123 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects 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.
      5
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
    • A
      license
      A
      quality
      D
      maintenance
      Connects 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.
      4
      MIT