MCP-Tools Referenz

Vollständige Liste aller verfügbaren MCP-Tools, gruppiert nach Aufgabenbereich. Alle Schreib-Tools akzeptieren den Parameter dry_run: true für eine Vorschau ohne Datenbankänderung.

Voraussetzung: ein verbundener MCP-Server mit passendem API-Schlüssel — siehe KI-Agent per MCP verbinden.

---

Medien

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
upload_media	filename, data (Base64)	title, altText, mimeType	write
upload_media_from_url	url, filename	title, altText	write
list_media	—	limit (Standard 50, max. 200), offset, search	read
search_media	query	limit, offset	read
update_media_metadata	id	title, altText, description	write
get_pending_media	—	limit, offset	read
delete_media	id	—	write

Limits: Base64-Upload max. 5 MB (~6,7 MB Payload). Erlaubte Formate: JPEG, PNG, WebP, SVG, GIF.

---

Produkte

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_products	—	search, categoryId, stockStatus, limit (max. 200), offset	read
get_product	id	—	read
create_product	name, price	sku, description, shortDescription, categoryId, status, metaTitle, metaDescription, dry_run	write
update_product	id	beliebige Produktfelder, dry_run	write
bulk_update_products	ids, field, value	dry_run	write
delete_product	id	dry_run	write
assign_product_images	productId, mediaIds (Array)	—	write
reorder_product_images	productId, mediaIds (Array in neuer Reihenfolge)	—	write
set_product_attributes	productId, attributes (Array {attributeId, value})	dry_run	write
generate_product_description	productId	template, updateProduct, dry_run	read / write
get_available_placeholders	—	—	read
list_textblocks	—	—	read

Hinweise:

• Neue Produkte werden mit Status draft angelegt (nicht im Shop sichtbar).
• Slug-Kollisionen werden automatisch mit -2, -3 usw. aufgelöst.
• HTML in description/shortDescription wird vor dem Speichern bereinigt.
• delete_product ist permanent und löscht Bilder, Kategoriezuordnungen, Varianten und Attributwerte mit.

---

Textbausteine

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
create_textblock	slug, content	dry_run	write
update_textblock	id	slug, content, dry_run	write
delete_textblock	id	dry_run	write

Hinweis: Doppelte Slugs werden mit einem Fehler abgewiesen. Ein gelöschter Textbaustein, der noch in Templates referenziert wird, rendert den Platzhalter-Tag als Klartext.

---

Kategorien

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_categories	—	includeProductCount	read
get_category	id	—	read
create_category	name	parentId, description, metaTitle, metaDescription, dry_run	write
update_category	id	name, slug, parentId, position, description, shortText, longText, metaTitle, metaDescription, dry_run	write
reorder_categories	categories (Array {id, position})	dry_run	write
delete_category	id	dry_run	write

Hinweis: delete_category schlägt fehl, wenn noch Unterkategorien oder Produkte zugewiesen sind — diese müssen zuerst verschoben oder gelöscht werden.

---

SEO

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
get_seo_settings	—	—	read
update_seo_settings	—	metaTitleTemplate, metaDescriptionTemplate, sitemapEnabled, robotsTxt, homepageTitle, homepageDescription, autoGenerateMeta, dry_run	write
list_seo_rules	—	limit, offset	read
create_seo_rule	name, targetType	titleTemplate, descriptionTemplate, keywordsTemplate, priority, dry_run	write
update_seo_rule	id	name, titleTemplate, descriptionTemplate, keywordsTemplate, priority, dry_run	write
delete_seo_rule	id	dry_run	write
run_seo_audit	—	—	read / write

URL-Weiterleitungen

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_redirects	—	limit (Standard 50, max. 200), offset	read
create_redirect	source, destination	statusCode (Standard 301), permanent, enabled, dry_run	write
update_redirect	id	source, destination, statusCode, enabled, dry_run	write
delete_redirect	id	dry_run	write

---

Shop-Einstellungen

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
get_store_settings	—	—	read
update_store_settings	—	companyName, street, city, zip, country, email, phone, vatId, taxId, website, currency, locale, timezone, pricingMode, dry_run	write
list_payment_methods	—	—	read
update_payment_method	id	enabled, testMode, sortOrder, settings, dry_run	write

Hinweis: Zahlungsgeheimnisse (API-Keys, Tokens) werden in Antworten grundsätzlich maskiert und können nicht ausgelesen werden.

---

Versand

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_shipping_zones	—	—	read
create_shipping_zone	name	countries (Array), dry_run	write
update_shipping_zone	id	name, countries, dry_run	write
delete_shipping_zone	id	dry_run	write
create_shipping_method	zoneId, name, type	cost, freeShippingThreshold, weightMin, weightMax, deliveryTime, enabled, dry_run	write
update_shipping_method	id	name, type, cost, freeShippingThreshold, deliveryTime, enabled, dry_run	write
delete_shipping_method	id	dry_run	write

Hinweis: Eine Zone kann nicht gelöscht werden, solange ihr Versandmethoden zugeordnet sind — Methoden zuerst löschen.

---

Betrieb & API-Schlüssel

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_order_statuses	—	—	read
list_email_templates	—	language, category	read
update_email_template	id	subject, content, active, dry_run	write
list_api_keys	—	—	read
create_api_key	name, permission (read oder write)	—	write

Hinweis: Vollständige API-Schlüsselwerte werden nur einmalig bei der Erstellung zurückgegeben. list_api_keys zeigt nur die ersten 8 Zeichen zur Identifikation.

---

Übersetzungen

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
get_translation	entityType, entityId	—	read
upsert_translation	entityType, entityId, languageCode, data	status, dry_run	write
list_translations	—	entityType, languageCode, limit (max. 200), offset	read
delete_translation	id	dry_run	write
get_translation_coverage	—	—	read

Entitätstypen: product, category, page, blog_post

---

Kunden

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_customers	—	search, limit, offset	read
get_customer	id	—	read
create_customer	firstName, lastName, email	phone, company, isB2B, customerGroupId, dry_run	write
update_customer	id	beliebige Kundenfelder, dry_run	write
add_customer_address	customerId, type, firstName, lastName, street, postalCode, city, country	company, isDefault, dry_run	write
delete_customer	id	dry_run	write

Hinweis: E-Mail-Adressen müssen eindeutig sein. delete_customer ist permanent und kaskadiert auf Adressen, Notizen und Gruppenmitgliedschaften.

---

Import

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
analyze_woocommerce_import	csvData (Base64)	—	read
import_woocommerce	csvData (Base64)	fieldMappings, importMode, downloadImages, dry_run	write
get_import_status	jobId	—	read

Wichtige Einschränkung: import_woocommerce läuft synchron und blockiert bis zum Abschluss. Wenn der Server-Kontext kein Async Local Storage (ALS) unterstützt, gibt das Tool einen Hinweis zurück und empfiehlt stattdessen den Import-Assistenten im Admin-Bereich — siehe WooCommerce-Import.

---

Seiten

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_pages	—	status, limit, offset	read
get_page	id	—	read
create_page	title	status, template, metaTitle, metaDescription, content, dry_run	write
update_page	id	title, slug, content, status, template, metaTitle, metaDescription, dry_run	write
delete_page	id	force (löscht zugehörige Sektionen mit), dry_run	write

Hinweis: Seiten-IDs sind Zeichenketten (kein Integer), automatisch aus dem Titel generiert. Sektions-Inhalte werden separat über create_section, update_section usw. verwaltet.

---

Bestellungen

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_orders	—	status, search, dateFrom, dateTo, limit, offset	read
get_order	id	—	read
update_order_status	id, status	note	write
bulk_update_order_status	ids, status	note, dry_run	write

---

Lagerbestand

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
get_inventory	—	warehouseId	read
list_low_stock	—	threshold, limit	read
adjust_stock	productId, quantity, reason	warehouseId, dry_run	write

---

Blog

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
list_blog_posts	—	status, search, limit, offset	read
get_blog_post	id	—	read
create_blog_post	title, content	status, excerpt, metaTitle, metaDescription, categories, dry_run	write
update_blog_post	id	beliebige Blog-Felder, dry_run	write

---

KI-Optimierung

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
optimize_product_for_ai_shopping	productId	updateProduct, dry_run	read / write
get_image_alt_suggestions	productId	—	read
apply_image_alt_suggestions	productId	dry_run	write

---

Shop-Übersicht

Tool	Pflicht-Parameter	Optionale Parameter	Berechtigung
get_store_summary	—	—	read

---

Nächste Schritte

• KI-Agent per MCP verbinden — Einrichtung und erste Schritte
• Shop per KI einrichten — Workflow für die vollständige Ersteinrichtung
• Produkte per MCP verwalten — Produkte suchen, bearbeiten, Bulk-Updates