05 · API

Deine Analytics über MCP befragen

Mit dem MCP-Server kann ein Assistent wie Claude eigene Fragen an deine Analytics stellen, mit demselben Nur-Lese-Schlüssel wie die REST-API.

01Zum Assistenten hinzufügen

Der Server liegt unter https://tallybyoutpost.com/mcp und nimmt denselben Schlüssel wie die REST-API (erstelle einen auf der Setup-Seite), als Authorization: Bearer …. Für Claude Code:

Claude Code

claude mcp add --transport http analytics "https://tallybyoutpost.com/mcp" \
  --header "Authorization: Bearer $TALLY_API_KEY"

Jeder Client, der MCP über Streamable HTTP spricht und einen Header senden kann, funktioniert genauso.

02Die Tools

Jedes Tool liest nur. Jedes nimmt die Parameter der REST-Route als Argumente (filters ist ein Objekt, {"country": "DE"}, und site kann wegfallen):

Tool	Was es beantwortet
`list_sites`	Die Website, die dieser API-Schlüssel liest: ihre ID, Name, Domain, Zeitzone und wie Besucher gezählt werden (Cookie, ohne Cookies oder Einwilligung).
`get_overview`	Besucher, Seitenaufrufe, Besuche, Median der aktiven Zeit und, wenn Zahlungen verbunden sind, Nettoumsatz, Verkäufe, Erstattungen, Konversionsrate und Umsatz pro Besucher, für einen Zeitraum und das Zeitfenster davor, mit der Veränderung dazwischen. Außerdem die Besucher, die gerade live sind.
`get_breakdown`	Die Top-Werte einer Dimension (Quelle, Kanal, Seite, Land, Gerät, Kampagne …) nach eindeutigen Besuchern oder nach Umsatz, jeweils mit ihrem Anteil an den Besuchern und dem Umsatz, den ihre Besucher brachten.
`compare_periods`	Ein Zeitraum im Vergleich mit dem Zeitfenster direkt davor (previous) oder denselben Tagen ein Jahr früher (year): jede Übersichtszahl für beide und die relative Veränderung. Veränderungen sind null, wo die Daten der Website nicht weit genug für einen Vergleich zurückreichen.
`list_sales`	Zahlungen, die neuesten zuerst, jede mit ihrem berechneten Betrag und in US-Dollar, ob sie mit einem Besucher verknüpft ist, wie (Methode und Sicherheit) und, wenn nicht, warum nicht. Filterbar auf nicht verknüpfte Zahlungen oder Erstattungen.
`get_receipt`	Der Beleg einer Zahlung: die Kette der Nachweise, die sie mit einem Besuch verknüpft (erster Besuch, Besuche vor dem Bezahlen, der zugerechnete Besuch, die Kennung, die übereinstimmte, und wo), jede ID des Anbieters und die Zahlung, auf die sie zurückgeht.
`get_coverage`	Wie viel des Umsatzes im Zeitraum einem Besucher zugerechnet ist, nach Methode, und die Korrekturliste für den Rest (mit Code zum Einfügen).
`list_visitors`	Besucher (auf einer Website ohne Cookies: Besuche) eines Zeitraums, die jüngsten zuerst, nach Umsatz oder nach Kaufwahrscheinlichkeit, mit Besuchen, Seiten, aktiver Zeit pro Besuch, Umsatz und ihrem letzten Besuch.
`get_visitor`	Der ganze Weg eines Besuchers: jeder Besuch mit Seiten, aktiver Zeit, Zielen und ausgehenden Klicks, seine Zahlungen, der erste Kontakt und der Kontakt, dem der Verkauf zugerechnet wird.
`get_realtime`	Wer in den letzten fünf Minuten auf der Website war (Seite, Ort, Quelle, Gerät), und die Verkäufe der letzten Stunde.
`get_goals`	Jedes im Zeitraum erreichte Ziel mit Abschlüssen, konvertierenden Besuchern, Konversionsrate und dem Umsatz der konvertierenden Besucher; gib `goal` an für die Eigenschaften eines Ziels. Listet die Funnels der Website.
`get_funnels`	Die Funnels der Website mit den Besuchern jedes Schritts, der Konversion vom vorigen und vom ersten Schritt und dem Absprung; oder ein Funnel mit `funnel`.
`get_customer_value`	Lifetime Value nach der Quelle, die jeden Kunden zuerst gebracht hat: Kunden, Umsatz, Durchschnitt pro Kunde, Verlängerungen und Wiederkaufrate, über alle erfassten Zahlungen.
`get_peak_hours`	Besuche, Verkäufe und Umsatz nach Wochentag und Stunde in der Zeitzone der Website, und die drei stärksten Stunden, wenn die Daten dafür reichen.
`get_engagement`	Wie Seiten gelesen werden: Aufrufe, Median der Lesezeit, durchschnittliche Scrolltiefe und der Anteil, der bis zum Ende gelesen wird, pro Seite und insgesamt, und die häufigen Einstiegs- und Ausstiegsseiten.
`get_purchase_paths`	Wie Käufer zum Kauf kamen: Zeit vom ersten Besuch bis zum Kauf, Besuche und Seiten vor dem Bezahlen, Flüsse vom ersten Kontakt zur zugerechneten Quelle und die Seiten, die Käufer vor dem Bezahlen sahen.

03Protokoll

Streamable HTTP mit JSON-RPC 2.0, in Revision 2026-07-28; Clients von 2025-11-25, 2025-06-18, 2025-03-26 öffnen mit initialize und werden ebenfalls bedient.
Methoden: server/discover, initialize, tools/list, tools/call und ping.
Das structuredContent eines Ergebnisses ist das JSON der REST-Route; content enthält eine einzeilige Zusammenfassung, dann dasselbe JSON als Text.
Ein Schlüssel, den der Tarif des Kontos nicht abdeckt, bekommt 402, das Rate-Limit 429 mit Retry-After, wie bei REST.

Ein Aufruf mit curl

curl -s "https://tallybyoutpost.com/mcp" \
  -H "Authorization: Bearer $TALLY_API_KEY" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: tools/call" -H "Mcp-Name: get_overview" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
       "params": {"name": "get_overview", "arguments": {"period": "30d"},
         "_meta": {"io.modelcontextprotocol/protocolVersion": "2026-07-28",
                   "io.modelcontextprotocol/clientInfo": {"name": "curl", "version": "8"},
                   "io.modelcontextprotocol/clientCapabilities": {}}}}'

04Prüfen, ob es geklappt hat

Fehlt etwas, oder sieht es bei dir anders aus? Schreib an support@tallybyoutpost.com und nenne die Seite.