Skip to main content
Glama
Sign In
Archicad MCP Connector

Archicad MCP Connector

by davidharutyunyan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Delete property groups

delete_property_groups
Destructive

Delete user-defined property groups in one undoable step. Non-empty groups are refused unless you also delete their definitions and element values; built-in groups stay protected.

Instructions

Deletes user-defined property groups in one undo step (undoable with undo). A group that still contains definitions is refused unless deleteDefinitions is true — then its definitions and all their element values are deleted too. Built-in groups cannot be deleted.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "groups": "<groups>"
    },
    "name": "delete_property_groups"
  }
}

Input Schema

NameRequiredDescriptionDefault
groupsYes
undoNameNoName of the undo step shown in Archicad
deleteDefinitionsNoAlso delete the definitions inside (default false = refuse non-empty groups)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the destructiveHint annotation, the description discloses the full consequence chain: deletion happens in one undo step, non-empty groups are refused unless deleteDefinitions is true, and then definitions plus all their element values are destroyed. It also states that built-in groups cannot be deleted. This is unusually rich context for a destructive operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tightly written sentences, front-loaded with the core action and then the critical caveats. Every sentence earns its place and no filler is present.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive mutation tool with annotations covering safety hints and no output schema, the description supplies the essential behavioral details: undoability, refusal conditions, cascading deletions, and built-in protection. An agent has enough information to invoke it correctly without further context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 67%; the schema documents the deleteDefinitions and undoName parameters and gives an item-level description for groups. The description adds meaning for deleteDefinitions by explaining that element values are also deleted, but it does not elaborate on the groups parameter format or undoName. Baseline 3 is appropriate given the partial coverage and added nuance for one parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Deletes user-defined property groups'. It also distinguishes user-defined from built-in groups and states the undo scope, so the agent knows exactly what operation is being performed without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It implies the tool is for user-defined groups and gives a key prerequisite for non-empty groups (deleteDefinitions must be true), plus the exclusion that built-in groups cannot be deleted. However, it does not explicitly name alternative tools such as delete_property_definitions or modify_property_groups, nor does it state when to choose this tool over them.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools