Referenz

Toolsets und Nur-Lesen-Modus

Laden Sie mit Toolsets nur die Emailit-MCP-Tools, die Sie brauchen, oder blenden Sie mit dem Nur-Lesen-Modus alle schreibenden Tools aus, per URL-Option oder Header.

Aktualisiert am 2. Okt. 2026

Manche Clients laden nur eine begrenzte Anzahl von Tools, und kürzere Tool-Listen machen Assistenten schneller und genauer. Übergeben Sie Optionen in der Server-URL oder als Header, um festzulegen, was der Server bereitstellt.

Option	Query-Parameter	Header	Werte
Toolsets	`toolsets`	`X-MCP-Toolsets`	Durch Kommas getrennte Toolset-Namen oder `all`
Nur-Lesen-Modus	`read_only`	`X-MCP-Readonly`	`true`, `1`, `yes` oder `on`

Wenn beides gesetzt ist, haben Header Vorrang vor Query-Parametern.

Beispiele

Text

https://api.emailit.com/mcp?toolsets=emails,domains,events
https://api.emailit.com/mcp?read_only=true
https://api.emailit.com/mcp?toolsets=emails,domains&read_only=true

Die letzte URL gibt dem Assistenten nur Lesezugriff auf E-Mails und Domains: Er kann Zustellungen und DNS-Einträge nachschlagen, aber nichts senden oder ändern.

Toolsets

Toolset	Umfasst
`emails`	E-Mails senden, auflisten, lesen, verschieben, stornieren, erneut senden und weiterleiten
`domains`	Versanddomains und DNS-Verifizierung
`dmarc`	Aggregierte und forensische DMARC-Berichte und Statistiken
`templates`	Vorlagen, Versionen und Veröffentlichung
`api_keys`	API-Schlüssel
`audiences`	Kontaktlisten und ihre Abonnenten
`contacts`	Kontakte, Massenaktionen und Export
`suppressions`	Die Sperrliste
`webhooks`	Webhooks, Tests, Secrets und Wiederholungen
`campaigns`	Kampagnen
`automations`	Automatisierungen, Durchläufe und Statistiken
`forms`	Anmeldeformulare
`verification`	E-Mail-Verifizierung und Verifizierungslisten
`events`	Der Event-Stream des Workspaces

Das Toolset workspace (get-current-workspace, list-workspaces, switch-workspace, create-workspace) ist immer enthalten. Unbekannte Toolset-Namen werden ignoriert; ist keiner der Namen gültig, werden alle Toolsets geladen.

Nur-Lesen-Modus

Der Nur-Lesen-Modus behält Tools der Art Lesen und blendet alles aus, was erstellt, aktualisiert, löscht, sendet oder eine externe URL aufruft. switch-workspace bleibt verfügbar, weil es nur den Standard-Workspace der Verbindung ändert. Die Art jedes Tools finden Sie in der Tool-Referenz.

Der Nur-Lesen-Modus ist eine gute Voreinstellung für Analyse-Assistenten und zum Ausprobieren eines neuen Clients.