Skip to main content
Glama

E-Mail-Anbieter einrichten

setup_email_provider
Destructive

Stellt die E-Mail einer Domain auf einen externen Anbieter (Google Workspace oder Microsoft 365) um, oder führt die Umstellung weiter. WICHTIG: Mit "umstellen" geht neue Mail sofort nur noch an den neuen Anbieter (MX wird gesetzt). Zwei Wege (weg): "umzug" (Standard) = die alten Postfächer und der IMAP-Zugang bei turbopress bleiben bis "abschliessen" erreichbar, damit der Kunde die alte Mail zum neuen Anbieter umziehen kann; "neu" = Neustart: der Maildienst bei turbopress wird sofort abgeschaltet (Postfächer und Mails bleiben erhalten, der IMAP-Zugang ist gesperrt). Wenn die Postfächer noch Mail enthalten, immer "umzug" bevorzugen. NIE umstellen, abschliessen oder rueckweg ohne ausdrücklichen Wunsch des Kunden; vorher den Weg erklären und die betroffenen Postfächer nennen (get_email_accounts). Ablauf: (1) Den Kunden nach dem TXT-Bestätigungswert aus dem Admin-Center seines Anbieters fragen und mit aktion "txt" setzen (provider + txt). (2) Der Kunde bestätigt die Domain beim Anbieter. (3) aktion "umstellen" (Standard) mit provider, weg, anbieter_bestaetigt=true und bestaetigung; setzt MX/SPF/Autodiscover. mx, dkim1, dkim2, dkim_selektor, dkim_schluessel nur angeben, wenn der Kunde sie aus seinem Admin-Center nennt; DKIM lässt sich auch später mit aktion "dkim" nachreichen. (4) aktion "abschliessen" beendet den Umzug und sperrt den IMAP-Zugang bei turbopress; aktion "rueckweg" stellt alles wieder auf turbopress zurück (Maildienst an, MX/SPF zurück). abschliessen und rueckweg gehen nur nach vorheriger Umstellung. Pflicht: anbieter_bestaetigt=true (nur wenn die Domain beim Anbieter wirklich bestätigt ist) bei "umstellen"; bestaetigung = die vom KUNDEN selbst getippte Domain bei umstellen, abschliessen und rueckweg (nie selbst einsetzen, immer den Kunden fragen). Das Ergebnis (summary, zustand, hinweise, eintraege) wörtlich weitergeben; nur dann Erfolg melden, wenn die Antwort ihn meldet. Liegen die Nameserver nicht bei turbopress, wird nichts geändert und die Einträge (eintraege) werden zum Selbsteintragen beim DNS-Anbieter mitgegeben. Das Umstellen ist pro Tag begrenzt.

Input Schema

NameRequiredDescriptionDefault
mxNoMX-Wert des Anbieters, nur wenn der Kunde einen abweichenden nennt
txtNoTXT-Bestätigungswert des Anbieters (aus dessen Admin-Center, vom Kunden erfragen); Pflicht bei aktion txt
wegNoStandard umzug (Mails bleiben nutzbar). neu schaltet den Maildienst bei turbopress ab (Postfächer bleiben, IMAP gesperrt)
dkim1NoErster DKIM-Wert (z. B. Microsoft 365 selector1), vom Kunden erfragen
dkim2NoZweiter DKIM-Wert (z. B. Microsoft 365 selector2), vom Kunden erfragen
aktionNoStandard umstellen. txt = Bestätigungswert des Anbieters setzen, dkim = DKIM nachreichen, abschliessen = Umzug beenden und IMAP sperren, rueckweg = zurück zu turbopress
domainYesDie Domain, z. B. example.de
providerNoDer Anbieter; Pflicht bei umstellen und txt
bestaetigungNoDie vom Kunden selbst getippte Domain; Pflicht bei umstellen, abschliessen und rueckweg
dkim_selektorNoDKIM-Selektor bei Google Workspace (z. B. google), vom Kunden erfragen
dkim_schluesselNoDKIM-Schlüssel bei Google Workspace, vom Kunden erfragen
anbieter_bestaetigtNoPflicht true bei umstellen: die Domain ist beim Anbieter bestätigt

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • addedInput schema / properties / aktion
      Added value: +{
      +  "description": "Standard umstellen. txt = Bestätigungswert des Anbieters setzen, dkim = DKIM nachreichen, abschliessen = Umzug beenden und IMAP sperren, rueckweg = zurück zu turbopress",
      +  "enum": [
      +    "umstellen",
      +    "abschliessen",
      +    "rueckweg",
      +    "dkim",
      +    "txt"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / anbieter_bestaetigt
      Added value: +{
      +  "description": "Pflicht true bei umstellen: die Domain ist beim Anbieter bestätigt",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / bestaetigung
      Added value: +{
      +  "description": "Die vom Kunden selbst getippte Domain; Pflicht bei umstellen, abschliessen und rueckweg",
      +  "type": "string"
      +}
    • addedInput schema / properties / dkim1
      Added value: +{
      +  "description": "Erster DKIM-Wert (z. B. Microsoft 365 selector1), vom Kunden erfragen",
      +  "type": "string"
      +}
    • addedInput schema / properties / dkim2
      Added value: +{
      +  "description": "Zweiter DKIM-Wert (z. B. Microsoft 365 selector2), vom Kunden erfragen",
      +  "type": "string"
      +}
    • addedInput schema / properties / dkim_schluessel
      Added value: +{
      +  "description": "DKIM-Schlüssel bei Google Workspace, vom Kunden erfragen",
      +  "type": "string"
      +}
    • addedInput schema / properties / dkim_selektor
      Added value: +{
      +  "description": "DKIM-Selektor bei Google Workspace (z. B. google), vom Kunden erfragen",
      +  "type": "string"
      +}
    • addedInput schema / properties / mx
      Added value: +{
      +  "description": "MX-Wert des Anbieters, nur wenn der Kunde einen abweichenden nennt",
      +  "type": "string"
      +}
    • changedInput schema / properties / provider / description
      Previous value: -"Der einzurichtende E-Mail-Anbieter"New value: +"Der Anbieter; Pflicht bei umstellen und txt"
    • addedInput schema / properties / txt
      Added value: +{
      +  "description": "TXT-Bestätigungswert des Anbieters (aus dessen Admin-Center, vom Kunden erfragen); Pflicht bei aktion txt",
      +  "type": "string"
      +}
    • addedInput schema / properties / weg
      Added value: +{
      +  "description": "Standard umzug (Mails bleiben nutzbar). neu schaltet den Maildienst bei turbopress ab (Postfächer bleiben, IMAP gesperrt)",
      +  "enum": [
      +    "umzug",
      +    "neu"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "domain",
      -  "provider"
      -]New value: +[
      +  "domain"
      +]
  2. 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"
  3. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare destructiveHint=true and openWorldHint=true, but the description adds substantial context: "neu" immediately disables the turbopress mail service and locks IMAP, MX/SPF get set, nameservers not at turbopress means nothing changes and DNS entries are handed back for manual entry, and "Das Umstellen ist pro Tag begrenzt" flags rate limiting. It even specifies success-reporting discipline (only report success if the response says so). Slightly less than 5 because the return structure is only named, not characterized.

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?

Front-loaded with purpose, then the critical "WICHTIG" caveat, then the two modes, then a numbered Ablauf. Every block is relevant for a destructive multi-step tool, though the single dense paragraph is a wall of text and the closing rate-limit sentence feels appended rather than integrated.

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 12-parameter destructive, open-world tool with no output schema, the description covers the full lifecycle: prerequisite TXT step, provider confirmation, Umstellen with MX/SPF/Autodiscover, DKIM follow-up, Abschluss/Rueckweg, the nameserver-off-turbopress fallback, and how to relay the result fields (summary, zustand, hinweise, eintraege). Nothing an agent needs to invoke it safely is missing.

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 100%, so the schema already documents every parameter including per-action obligations, so the baseline is 3. The description does add workflow-level meaning (which parameters belong to which step, that DKIM can be supplied later via aktion "dkim", that bestaetigung must be customer-typed and never auto-filled), but much of this is mirrored in the schema descriptions.

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 specific verb and resource ("Stellt die E-Mail einer Domain auf einen externen Anbieter um, oder führt die Umstellung weiter") and names the two supported providers. The multi-action/carrier nature is made explicit up front, so an agent can tell this apart from sibling mailbox tools like create_email_account or set_email_forwarding.

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?

Gives explicit when/when-not guidance: "NIE umstellen, abschliessen oder rueckweg ohne ausdrücklichen Wunsch des Kunden", prefer "umzug" when mailboxes still contain mail, and instructs to call get_email_accounts first to name affected mailboxes. It also states a sequencing rule (abschliessen/rueckweg only after a prior Umstellung) that routes the agent correctly.

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