NemosGo — Für Entwickler

Sofort ausprobieren

Eine öffentliche Testinstanz des Proxys läuft unter mpp.digital-platform.io. Beide Seiten arbeiten gegen dieselbe Instanz. Die Befehle sind für die Shell unter macOS und Linux. Den Zustand der Instanz kann jeder abfragen:

curl -fsS https://mpp.digital-platform.io/mpp/v1/health
curl -fsS https://mpp.digital-platform.io/macp/v1
curl -fsS https://mpp.digital-platform.io/macp/v1/capabilities

So sehen Sie die Instanz arbeiten, gleich ob Sie anbieten oder aufrufen wollen. Eine kostenlose Funktion lässt sich finden und aufrufen, ohne SDK, ohne Zahlung, ohne Guthaben und ohne die Geldbörse auf Ihrem Rechner.

1. Adresse und Funktion festlegen. Die folgenden Schritte verwenden beides.

MACP=https://mpp.digital-platform.io/macp/v1
FN=bob.generative-models.list.v1

2. Funktionen finden. Die Instanz listet alles, was dort angeboten wird, kostenlos wie bezahlt.

curl -fsS $MACP/functions

3. Preis ansehen. Für diese Funktion steht dort "mode": "free".

curl -fsS $MACP/functions/$FN/pricing

4. Aufrufen. Die Antwort trägt "status": "succeeded" und enthält die Liste der Modelle.

curl -fsS -X POST $MACP/execute \
  -H 'Content-Type: application/json' \
  -d "{\"functionId\":\"$FN\",\"input\":{}}"

Ausführlicher, mit Auswahl der Funktion über jq und eigener Anfragekennung, steht derselbe Ablauf im Entwicklerhandbuch auf Codeberg, Abschnitt Calling a free function.

Stand: 22. September 2026

Wenn Sie anbieten

So sieht es beim Anbieter aus. Sie binden Ihre eigenen Systeme an, den Rest bringen wir mit. Den Zahlungsdienstleister bringen Sie mit, oder wir schlagen einen vor. Den Identitätsanbieter bringen wir auf Wunsch mit, Sie können auch Ihren eigenen anbinden. Alles davon läuft in Ihrer Installation und unter Ihrer Marke.

Der M-Pay Proxy kennt Ihre Funktionen und deren Preise, nennt dem Aufrufer den Preis, nimmt die Zahlung entgegen und ruft danach Ihre Funktion auf. An Ihrer Anwendung selbst ändern Sie nichts, sie muss vom Bezahlen nichts wissen. Solange Sie nur eigene Funktionen anmelden, müssen Sie sich um den Proxy nicht kümmern. Das ändert sich, wenn Sie Ihren Marktplatz weiteren Anbietern öffnen: Dann melden Sie diese Anbieter an, und das Funktionsangebot wird nach Anbieter getrennt geführt.

Wie ein bezahlter Aufruf abläuft

So kommt ein bezahlter Aufruf bei Ihnen an. Der Proxy nennt den Preis, nimmt die Zahlung entgegen und ruft erst danach Ihre Funktion auf. Der Aufrufer ist ein Agent oder eine Anwendung, die für eigene Zwecke einkauft oder im Auftrag eines Kunden.

Sieben Schritte. Bezahlt wird beim Proxy, verbucht wird im Bezahl-Backend. Die Berechtigung gilt auf dieser Instanz für genau einen Aufruf, der Beleg kommt mit ihr zurück. Ihr Backend bekommt davon nur den Aufruf seiner eigenen Funktion zu sehen.

Wo der Kauf ausgelöst wird, entscheiden Sie. Ein Link oder ein QR-Code passt auf eine Seite, in eine App, in einen Newsletter oder in einen Assistenten. Maschinen rufen stattdessen direkt auf.

Drei Aufrufe richten das ein.

POST /mpp/v1/admin/merchant-auth        # Anmeldung
POST /mpp/v1/admin/execution-backends   # Backend
POST /mpp/v1/admin/functions            # Preis

Die erste Anmeldung richten wir für Sie ein. Mit der zweiten hinterlegen Sie die Zugangsdaten, mit denen der Proxy Ihr Backend aufruft, mit der dritten melden Sie Funktion, Ziel-URL, Schema und Preis an.

Die Anmeldung einer Funktion trägt außerdem Ein- und Ausgabeschema, eine Zeitgrenze, die Gültigkeitsdauer der Berechtigung und ob diese einmal oder mehrfach gilt.

Was Sie vorher brauchen.

Eine Händlerkennung und ein Händlerkonto im Bezahl-Backend. Beides kommt aus der Einrichtung.
Ein Admin-Token, das nur für Ihre Kennung gilt. Das stellen wir aus.
Ein öffentlich über HTTPS erreichbares Backend, samt der Zugangsdaten, mit denen der Proxy es aufruft.

Wenn Sie aufrufen

Auf der Gegenseite steht das Go-SDK. Preis erfragen, Angebot holen, bezahlen, ausführen.

Ihre Anwendung spricht mit dem SDK, das SDK über MACP mit dem Endpunkt beim Betreiber. Bezahlt wird aus der Geldbörse auf Ihrem Server. Dahinter wird das Backend des Anbieters aufgerufen.

c, err := mppsdk.New(cfg)
price, err := c.GetPricing(ctx, "weather-forecast")
limit := price.Pricing.AmountCents

quote, err := c.GetQuote(ctx, mppsdk.GetQuoteRequest{
    FunctionID:     "weather-forecast",
    ExecutionCount: 1,
    MaxPriceCents:  &limit,
})

res, err := c.PayInvoice(ctx, quote)

out, err := c.Execute(ctx, mppsdk.ExecuteRequest{
    FunctionID: "weather-forecast",
    GrantID:    res.GrantID,
    Input:      map[string]any{"city": "München"},
})

Die Fehlerbehandlung ist der Übersicht halber weggelassen. Bezahlen und Ausführen bleiben zwei Aufrufe: PayInvoice liefert in res.GrantID die Berechtigung, Execute gibt sie beim Ausführen mit (POST /macp/v1/execute). Zusammengefasst werden die beiden bewusst nicht, auf dem Proxy steht deshalb payAndExecute auf false. Das Ergebnis steht danach in out.Output. Ist die Berechtigung abgelaufen oder verbraucht, lehnt der Proxy das Ausführen ab. Dann gilt derselbe Weg noch einmal: Preis erfragen, bezahlen, ausführen.

So holen Sie sich das SDK:

git clone https://codeberg.org/stulle-ai/m-pay.git
cd m-pay/mpp/sdk/go
go test ./...
go build ./cmd/mpp-sdk-demo

In eigene Programme holen Sie das SDK mit go get codeberg.org/stulle-ai/m-pay/mpp/sdk/go/mppsdk@v0.3.1. Vorausgesetzt ist Go 1.25.5 oder neuer. Für bezahlte Aufrufe braucht das SDK die Geldbörse. Sie läuft als eigener Dienst neben Ihrer Anwendung, heute unter Linux, und wird vorher aufgeladen.

Anbieter selbst anbinden. Kaufen Ihre Agenten bei einem Anbieter, der noch nicht angebunden ist, melden Sie seine Schnittstelle an Ihrem eigenen Proxy an, mit denselben drei Aufrufen wie oben unter Wenn Sie anbieten. Der Anbieter stellt nur seine Schnittstelle bereit.

Die Komponenten

NAME	WAS ES IST	WO ES LÄUFT	WAS SIE DAMIT ZU TUN HABEN
NameM-Pay Proxy	Was es istSteht vor der Funktion des Anbieters: nennt den Preis, nimmt die Zahlung an und ruft sie danach auf	Wo es läuftIn Ihrer Installation, betrieben von Ihnen oder von uns. Zum Ausprobieren: `mpp.digital-platform.io`	Was Sie damit zu tun habenWenn Sie anbieten: Funktion, Ziel und Preis anmelden, und weitere Anbieter, sobald Sie Ihren Marktplatz öffnen. Wenn Sie aufrufen: nichts, außer Sie binden Anbieter selbst an
NameMACP	Was es istDas Protokoll dazwischen. Für einen Kauf braucht es drei Aufrufe: `/quotes`, `/pay`, `/execute`	Wo es läuftZwischen Aufrufer und Proxy. Es beschreibt sich selbst unter `/macp/v1`	Was Sie damit zu tun habenWenn Sie aufrufen: nicht selbst aufrufen, das SDK macht die drei Aufrufe, einen nach dem anderen
NameDas Go-SDK	Was es istErledigt Preis, Angebot, Zahlung und Ausführung und spricht dazu mit der Geldbörse	Wo es läuftIn Ihrem eigenen Programm, unter MIT-Lizenz	Was Sie damit zu tun habenWenn Sie aufrufen: einbinden
NameDie App	Was es istDie Oberfläche des Käufers: Käufe, Lieferungen, Belege und Stornieren	Wo es läuftAuf dem Telefon des Käufers	Was Sie damit zu tun habenWenn Sie anbieten: nichts, wir liefern sie unter Ihrer Marke
NameDie Geldbörse	Was es istHält das Guthaben und erzeugt die Zahlungsdaten	Wo es läuftBeim Menschen in der App, bei der Maschine als eigener Dienst neben Ihrer Anwendung, heute unter Linux	Was Sie damit zu tun habenWenn Sie aufrufen: installieren und aufladen. Guthaben und Schlüssel bleiben bei Ihnen

Ein vollständiges Beispiel

Im Entwicklerpaket liegen drei lauffähige Programme, die zusammen einen Verlag abbilden: ein Server für die Ausgaben, eine Anwendung, mit der der Verlag einstellt und den Preis setzt, und ein Kiosk, in dem der Leser kauft. Dieselbe Strecke zeigt die Aufnahme Media Publishing von Anfang bis Ende: Ein Verlag stellt eine Ausgabe ein, ein Leser kauft daraus einen Beitrag für 25 Cent.

Stand und Lizenz

Auf Codeberg. Go-SDK, Protokolldefinitionen, Beispielprogramme und das Entwicklerhandbuch als Quelltext unter MIT-Lizenz. Die Geldbörse gibt es dort als fertiges Programm für Linux.
Entwicklerpaket 0.3.1, Protokoll v1 als Entwurf. Das Paket trägt die Versionsnummer 0.3.1, das Protokoll liegt in Version 1 als Entwurf vor und ist noch nicht festgeschrieben. Binden Sie sich an eine feste Fassung des Pakets statt an den laufenden Stand.
Nicht enthalten. Der Proxy und das Bezahl-Backend. Die richten wir ein und betreiben sie auf Wunsch für Sie.
Übersicht auf Codeberg. Die Verwaltungsaufrufe stehen mit Zweck und Reihenfolge im README auf Codeberg, Abschnitt SA-x: administration interface. Anfrage und Antwort im Einzelnen sind dort noch nicht beschrieben, die erste Anmeldung richten wir deshalb mit Ihnen zusammen ein.

Zum Repository auf Codeberg

Worauf es steht

NemosGo ist das Produkt. Darunter liegt M-Pay, die Zahlungs- und Transaktionstechnik. Factory 42 hilft uns, Bereiche von NemosGo zu entwickeln und zu betreiben, und trägt die KI-Angebote für Kunden. Für die Einbindung brauchen Sie beides nicht zu kennen. Was die beiden können, steht auf Die Technik dahinter.

Sprechen wir darüber

Fragen zur Einbindung oder zur Technik? Schreiben Sie uns.

Zum Kontakt