# Nuri Remit

> Zahl mit x402, eine tansanische Handynummer bekommt Schilling.

Dieser Dienst schickt Geld auf eine tansanische Handynummer.

So geht es:
1. check_recipient mit phone und amountTZS — zeigt den Namen des Empfaengers,
   den Anbieter, die Gebuehr und den Preis. Kostet nichts.
2. send_tzs mit denselben Angaben. Du bekommst ein oder mehrere Zahlungsangebote
   zurueck. Zahl EINES davon.
3. Denselben Aufruf noch einmal, diesmal mit der Zahlung. Die Auszahlung geht
   sofort raus.
4. get_order sagt, ob es beim Empfaenger angekommen ist.

Betraege zwischen 100 und 100000 TZS.
Zeig einem Menschen immer erst den Namen aus check_recipient, bevor du zahlst.
Kein Konto, keine Anmeldung, kein Schluessel noetig.

## Ein Endpunkt

`POST https://clickpesa.paymentrequired.com/mcp` versteht zwei Formen:

- Als Agent: JSON-RPC 2.0 (MCP, Streamable HTTP)
- Als Entwickler: `{"tool":"send_tzs","amountTZS":5000,"phone":"+255712345678"}`

## Werkzeuge

- `route_price` — Fragt einen fremden x402-Dienst, was er verlangt, und nennt den Preis in Lightning. Bewegt nichts.
- `route_pay` — Du zahlst uns per Lightning, wir zahlen den fremden x402-Dienst und geben dir seine Antwort. Ohne Zahlung kommt nur die Rechnung zurueck.
- `check_recipient` — Prueft eine tansanische Handynummer VOR dem Bezahlen: welcher Name dahintersteckt, welcher Anbieter (M-Pesa, Tigo Pesa, Airtel, Halopesa), welche Gebuehr anfaellt und wie viel Krypto du zahlen musst. Kostet nichts. Immer zuerst aufrufen, damit niemand an die falsche Nummer zahlt.
- `quote_tzs` — Sagt nur den Preis, ohne Handynummer. Kostet nichts. Fuer den Empfaengernamen nimm check_recipient.
- `send_tzs` — Schickt Geld auf eine tansanische Handynummer. Beim ersten Aufruf bekommst du eine Zahlungsforderung (x402) zurueck, zusammen mit dem Namen des Empfaengers. Zahl sie und ruf denselben Aufruf noch einmal — dann geht die Auszahlung sofort raus. Kein Konto, keine Anmeldung.
- `get_order` — Sagt den Stand eines Auftrags, inklusive der Zustellung beim Anbieter des Empfaengers. Kostet nichts.

## Bezahlen

x402 Version 2, Schema `exact`, USDC auf eip155:8453.
Empfaenger: `0x0Bf8f81AAdb25807fe6BEB1Cfc935D071E9CDD59`
Vertrag: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`

## Grenzen

- 100 bis 100000 TZS je Auftrag
- Aufschlag: 5 Prozent

## Beispiel

```bash
curl -X POST https://clickpesa.paymentrequired.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"tool":"check_recipient","amountTZS":5000,"phone":"+255712345678"}'
# -> 402 mit PAYMENT-REQUIRED. Zahlen, dann denselben Aufruf wiederholen.
```