Für Entwickler und KI-Agenten

API und MCP-Server: KI-Marketing aus deinen eigenen Tools steuern

ultimate-marketing.io hat eine REST-API und einen MCP-Server. Damit startest du Marketing-Läufe aus deinen eigenen Tools, holst Ergebnisse und Kampagnenzahlen in dein Dashboard und lässt KI-Assistenten mit deiner KI-Marketingabteilung arbeiten. Veröffentlicht wird weiterhin nichts ohne Freigabe.

7 Tage kostenlos testen OpenAPI-Beschreibung

Enthalten ab Pro und im Testzugang · Schlüssel unter Einstellungen → API & MCP

Was du damit machen kannst

Läufe aus KI-Assistenten starten

Sag deinem Agenten „Schreib einen LinkedIn-Post über unsere neue Leistung“ – er startet den Lauf, die Agenten von ultimate-marketing.io erstellen den Beitrag, du gibst ihn frei.

Freigaben im Blick

Frag ab, welche Läufe auf deine Entscheidung warten, und lies Entwurf und Prüfbericht, ohne die App zu öffnen.

Zahlen ins eigene Dashboard

Kampagnen auf Meta, Google, LinkedIn und ChatGPT mit Status, Tagesbudget, Ausgaben, Klicks und Leads per API abrufen.

Automationen bauen

Mit Zapier, Make, n8n oder eigenem Code: etwa jeden Montag einen Blogartikel starten oder neue Freigaben in Slack melden.

In zwei Minuten verbunden

Melde dich an und lege unter Einstellungen → API & MCP einen Schlüssel an. Er beginnt mit umk_ und wird nur einmal angezeigt.
Wähle die Rechte: Lesen ist immer dabei, Starten erlaubt neue Läufe, Freigeben erlaubt Entscheidungen am Tor – das bleibt aus, wenn ein Mensch freigeben soll.
Trage den MCP-Server in deinem Client ein oder rufe die REST-API mit dem Schlüssel im Authorization-Header auf.

MCP-Server für Clients, die einen Authorization-Header setzen können, etwa Claude Code, Cursor oder eigene Agenten mit dem MCP-SDK:

{
  "mcpServers": {
    "ultimate-marketing": {
      "type": "http",
      "url": "https://ultimate-marketing.io/api/mcp",
      "headers": {
        "Authorization": "Bearer umk_\u2026"
      }
    }
  }
}

In Claude Code genügt ein Befehl:

claude mcp add --transport http ultimate-marketing https://ultimate-marketing.io/api/mcp --header "Authorization: Bearer umk_…"

REST-API, zum Beispiel einen Post starten:

curl -X POST https://ultimate-marketing.io/api/v1/laeufe \
  -H "Authorization: Bearer umk_…" \
  -H "Content-Type: application/json" \
  -d '{"prozess": "post", "thema": "Neue Leistung vorstellen"}'

MCP-Werkzeuge

Werkzeug	Was es tut	Recht
get_account	Tarif, Testzugang, KI-Guthaben und ob die Agenten gerade wegen Budget-Stopp pausieren	Lesen
list_offers	Angebote bzw. Marken des Arbeitsbereichs	Lesen
list_processes	Marketing-Prozesse (z. B. Post, Blog, Kampagne) und ob sie im Tarif enthalten sind	Lesen
list_runs	Letzte Läufe, filterbar nach Status – etwa „freigabe“ für alles, was auf dich wartet	Lesen
get_run	Ein Lauf mit Entwurf, Ergebnissen der Agenten und Verlauf	Lesen
list_campaigns	Kampagnen auf Meta, Google, LinkedIn und ChatGPT mit Kennzahlen	Lesen
start_run	Prozess starten; das Ergebnis kommt zur Freigabe	Starten
decide_run	Am Tor freigeben, zurückschicken oder ablehnen	Freigeben

REST-Endpunkte

Methode	Pfad	Wofür
GET	/api/v1/konto	Konto, Tarif, Guthaben, Budget-Stopp
GET	/api/v1/angebote	Angebote
GET	/api/v1/prozesse	Prozesse und ob sie im Tarif enthalten sind
GET	/api/v1/laeufe?status=freigabe	Läufe, optional nach Status
GET	/api/v1/laeufe/{id}	Ein Lauf mit Entwurf und Verlauf
POST	/api/v1/laeufe	Lauf starten (Recht „Starten“)
POST	/api/v1/laeufe/{id}/entscheidung	Freigeben, zurückschicken, ablehnen (Recht „Freigeben“)
GET	/api/v1/kampagnen	Kampagnen mit Kennzahlen

Basis-URL: https://ultimate-marketing.io/api/v1 · openapi.json

Sicherheit und Kontrolle

Schlüssel werden nur als Hash gespeichert und lassen sich jederzeit einzeln widerrufen.
Jeder Schlüssel hat eigene Rechte; das Recht „Freigeben“ ist standardmäßig aus.
Höchstens 60 Anfragen pro Minute und Schlüssel.
Tarifgrenzen und der Budget-Stopp gelten genauso wie in der App: ohne Guthaben starten keine Läufe.
Jeder Lauf ist im Verlauf mit dem Namen des Schlüssels vermerkt.
Anwendung und Datenbank laufen in Frankfurt.

Häufige Fragen

Was ist ein MCP-Server?

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Assistenten und Agenten Werkzeuge anderer Dienste nutzen. Mit dem MCP-Server von ultimate-marketing.io kann ein Agent Marketing-Läufe starten, Ergebnisse lesen und Kampagnen abfragen.

Welche Clients funktionieren?

Alle MCP-Clients, die den Server per HTTP ansprechen und einen Authorization-Header mit deinem Schlüssel setzen können, zum Beispiel Claude Code, Cursor oder eigene Agenten mit dem MCP-SDK. Die REST-API funktioniert mit jedem Werkzeug, das HTTP-Anfragen senden kann.

Kann ein KI-Agent ohne mich veröffentlichen?

Nein, solange der Schlüssel nicht das Recht „Freigeben“ hat. Dann bereiten die Agenten alles vor und du entscheidest in der Freigabe-Ampel. Gibst du einem Schlüssel das Recht „Freigeben“, entscheidest du dich bewusst dafür, Freigaben zu automatisieren.

Was kostet die API?

API und MCP-Server sind ab dem Tarif Pro enthalten und im 7-tägigen Testzugang nutzbar. Läufe verbrauchen KI-Guthaben wie in der App.

7 Tage kostenlos testen