Skip to content

Reference & Data Model

MCP tool (agent_mcp_tool)

An MCP tool is a single function of an MCP server with a permission: Allow, Ask or Deny.

The server delivers its tools; Aligia stores name, description and permission per tool. Only the permission is editable by humans. (Data type: configuration)

Detail page of the MCP server, section „Tool-Berechtigungen“ (Tool permissions), grouped into „Lesen“ (Read), „Schreiben“ (Write) and „Andere“ (Other). On the agent detail page the tools of the assigned servers appear under „Tools“ with the server name. See Guides › MCP servers.

Field Technical Type Required Meaning Notes
Name name Text yes tool name according to the server System
Description description Text no description according to the server System
Permission permission_state Selection yes „Allow“, „Ask“, „Deny“ newly discovered tools: „Ask“

Not visible: input schema (input_schema), source (source).

Related to Kind Required On archive On delete
MCP server belongs to yes – tool deleted along
Value Label Effect
allow Allow tool is provided to Polaris (with „In Polaris verwenden“) and to assigned agents
ask Ask currently not released; tool is not provided. Default for new tools
deny Deny not released
  • Aligia derives the grouping into „Lesen“ / „Schreiben“ / „Andere“ from the first word of the tool name (get, list, … = read; create, update, delete, … = write). The server delivers no classification.
  • „Alle setzen“ (Set all) changes all tools of a group or of the whole server at once.
  • At runtime only „Allow“ counts; „Ask“ behaves like „Deny“.

MCP server · Agent