Skip to main content
Glama

E-Mail-Alias entfernen

remove_email_alias
Destructive

Entfernt EINE Alias-Adresse von einem Postfach — der Weg zurück zu set_email_alias. Nachrichten an die Alias-Adresse kommen danach NICHT MEHR BEIM POSTFACH AN; sie werden in der Regel abgewiesen (der Absender bekommt eine Fehlermeldung) — ist für die Domain eine Sammeladresse eingerichtet (Catch-All, "Mail an nicht existierende Benutzer" auf weiterleiten), gehen sie stattdessen dorthin; sage dem Kunden das vorher und frage, ob die Adresse noch irgendwo steht (Website, Signatur, Visitenkarten, Formulare). Das Postfach selbst und alle Nachrichten darin bleiben unberührt — auch das gehört in die Antwort, sonst glaubt der Kunde, seine Mails seien mit weg. Postfach UND Alias werden serverseitig gegen die Postfächer genau dieses Abonnements geprüft, bevor irgendetwas entfernt wird; get_email_accounts zeigt die Aliase je Postfach, rate keinen. EINE BESONDERHEIT, die du nie übergehen darfst: Das Hosting-System meldet für diesen Befehl gemessen AUCH DANN Erfolg, wenn es den Alias gar nicht gab. Der Server verlässt sich deshalb nicht darauf, sondern sieht danach nach — steht der Alias noch da, meldet die Antwort einen FEHLER und keinen Erfolg. Melde diesen Fall nie als erledigt. War die Postfachliste nicht abrufbar, wird nichts entfernt; das heißt dann NICHT, dass es den Alias nicht gibt. Neu einrichten lässt sich ein Alias jederzeit mit set_email_alias.

Input Schema

NameRequiredDescriptionDefault
aliasYesDie zu entfernende Alias-Adresse — lokaler Teil ("kontakt") oder volle Adresse ("kontakt@example.de"), genau wie von get_email_accounts geliefert. Der Alias muss an GENAU DIESEM Postfach hängen.
emailYesDas Postfach, an dem der Alias hängt — lokaler Teil ("info") oder volle Adresse ("info@example.de"), genau wie von get_email_accounts geliefert
domainYesDie Domain, z. B. example.de

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Far exceeds the annotations (destructiveHint/openWorldHint). Discloses that alias mail is typically rejected, that a catch-all may swallow it instead, that the mailbox and its messages are unaffected, that both mailbox and alias are validated server-side, and that the hosting system reports false success for non-existent aliases — with an explicit instruction never to report that case as done.

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

Conciseness4/5

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

The core operation and its inverse are front-loaded in the first clause, and every sentence carries operational weight (the false-success warning is essential). It is nonetheless long and slightly repetitive — the closing 'Neu einrichten lässt sich ein Alias jederzeit mit set_email_alias' restates the opening and could be cut.

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?

Complete for a destructive mutation with no output schema. Consequence disclosure, prerequisite lookup, validation behavior, and the critical false-success edge case are all covered, leaving an agent nothing substantive it could get wrong.

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 coverage is 100%, so the schema already documents all three required parameters including accepted local-part vs. full-address formats. The description reinforces sourcing values from get_email_accounts and that the alias must belong to exactly this mailbox, but adds no new format or syntax beyond the schema — baseline 3.

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?

States a precise verb and resource ('Entfernt EINE Alias-Adresse von einem Postfach') and explicitly names set_email_alias as the inverse operation, so an agent can distinguish it from the sibling without opening either schema.

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

Usage Guidelines5/5

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

Provides explicit when-to-use context (must verify via get_email_accounts first, 'rate keinen'), names the alternative for re-creation, and specifies a pre-removal condition (ask the customer whether the address is still published). Nothing is left to inference.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources