Für Entwickler
Arbeiten Sie mit dem Kreis einer Familie. Genehmigen Sie nie.
Der eigene KI-Assistent eines Familienmitglieds verbindet sich mit dem MCP-Server von Kin, indem er sich über OAuth anmeldet oder ein Token nutzt, das das Mitglied gewährt. Die Software eines Pflegedienstes meldet Besuche über eine signierte API. Beide lesen und schlagen vor; ein Mensch in Kin genehmigt.
MCP-Server
Einen Assistenten verbinden
Streamable HTTP, eine JSON-RPC-Nachricht pro Anfrage, keine Sitzung. Protokollversionen 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. Ein Client meldet sich über OAuth 2.1 an, oder das Mitglied erstellt ein Token auf dem Bildschirm Verbundene Assistenten.
https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp
Aus Ihrem Client anmelden
Fügen Sie die Adresse von Kin ohne Token hinzu. Ihr Client findet Kin über die 401-Antwort, registriert sich und öffnet Kin in Ihrem Browser; Sie melden sich an, wählen, was er darf und wie lange, und sagen Ja. Kin ist sein eigener OAuth-2.1-Autorisierungsserver: PKCE mit S256, Client-ID-Metadatendokumente oder dynamische Registrierung, der Ressourcenindikator und kein Refresh-Token.
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp
https://mzdg4f3stk.us-east-1.awsapprunner.com/.well-known/oauth-authorization-server
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp --header "Authorization: Bearer <your-delegation-token>"
{
"mcpServers": {
"kin": {
"type": "http",
"url": "https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp",
"headers": {
"Authorization": "Bearer <your-delegation-token>"
}
}
}
}curl -s https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp \
-H "Authorization: Bearer <your-delegation-token>" \
-H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: tools/list" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'Die Werkzeuge
Dieselben Werkzeuge und dasselbe Gateway wie bei Kin fragen. tools/list zeigt nur die, die die Rolle des Mitglieds und der Umfang des Tokens erlauben.
get_poolLiestThe circle's pool: its confirmed balance now, this month's money paid in, paid out and PayPal fees, and what this month's spending went on by category (bills, receipts members paid from their own pocket, and purchases). Use it for any question about how much money there is, or how much was spent on something this month.
list_billsLiestThe circle's bills: those the family expects next, those waiting for approval, and those paid, with payee, amount and day. A caregiver sees only their own. It does not hold receipts or purchases: for what was spent on something, use get_pool.
get_fairnessLiestThis month's fairness, as Kin's money core calculates it: each sharing member's agreed share, what they gave, and who owes whom to settle. Use it for any question about shares, fairness or who owes whom.
check_claimLiestChecks a demand for money against the record, with Kin's fixed rules: is the payee known, is there an open bill of that amount, was it already paid. It only reads; nobody is alerted. Use it when someone asks whether a demand, call or letter is real.
list_proposalsLiestThe payments waiting for a yes, and who still has to say yes to each, as the approval engine decided. Kin cannot answer for anyone.
get_recordLiestThe newest entries of the circle's ledger: what happened, to whom, how much and on which day, and whether it was simulated.
get_paypal_payout_statusLiestWhether someone has been paid: the payouts the record holds for a payee or caregiver, and, for a real payout, its status read from PayPal now. Simulated payouts in a demo say so.
get_paypal_topup_statusLiestThe members' top-ups into the pool: amount, day and, for a real top-up, the status of its capture read from PayPal now. Simulated top-ups in a demo say so.
get_subscription_statusLiestEach member's monthly share through PayPal subscriptions: its amount, its state and its next charge, read from PayPal for a real one. Simulated shares in a demo say so.
get_paypal_orderLiestPayPal's own record of a top-up, read from PayPal now through the PayPal Agent Toolkit: the PayPal order behind the newest real top-up, its status, amount, times and capture. A simulated top-up has no PayPal record, and the result says so. Use it when someone asks what PayPal itself says about a top-up.
get_paypal_invoiceLiestPayPal's own record of an invoice Kin sent a member, read from PayPal now through the PayPal Agent Toolkit: its number, status, amount and what was paid on it. A simulated invoice has no PayPal record, and the result says so. Use it when someone asks whether an invoice was paid or where it stands at PayPal.
list_paypal_disputesLiestWhether anyone has disputed one of the circle's newest real top-ups with PayPal, read from PayPal now through the PayPal Agent Toolkit: each dispute's status, reason and amount. Use it when someone asks about a dispute, a chargeback or a payment someone says they did not make.
propose_refillSchlägt vorAsks Kin to propose a refill the family's rules already allow, at the rule's own price. It buys nothing: the refill then waits for the yeses the family agreement names, unless the parent's standing permission covers it. Use it only when the person asks for a reorder or refill.
propose_giftSchlägt vorFor the parent only: asks Kin to send a small payment from her own Purse, such as a gift, a tip or a donation, to someone she names. It pays nothing: Kin reads the payment back and it waits for her own yes, and Kin's rules hold it for a day, with the family told, when the person is not in her address book, the amount is above her limit or the request looks pressured. Use it only when she asks to send, give or pay someone money from her Purse.
Die Grenze
Was kein externer Aufrufer kann
- Kein Werkzeug genehmigt, bezahlt, unterschreibt oder bewegt Geld. Ein Werkzeug, das vorschlägt, gibt die ID des Vorschlags zurück und den Bildschirm, auf dem ein Mensch ihn genehmigt, und der Vorschlag wartet auf diesen Menschen, auch wenn die dauerhafte Erlaubnis des Elternteils ihn abdecken würde.
- PayPals eigene Werkzeuge, auch die zum Schreiben, bleiben auf Kins Server und werden hier nie angeboten.
- Der Umfang des Tokens schränkt die Rolle des Mitglieds nur ein. Wird er widerrufen, wird schon der nächste Aufruf abgelehnt.
- Text aus dem Kassenbuch (Namen, Notizen, Briefe) kommt als Daten gekennzeichnet zurück, in einem Tag, den er nicht schließen kann.
- Eine Anfrage ohne gültigen Token erhält 401 und einen WWW-Authenticate-Header, der auf die Metadaten der geschützten Ressource zeigt.
Agentur-API
Einen Besuch melden
Senden Sie einen Besuch per POST an /api/v1/visits, signiert mit dem Schlüssel, den die Kreisleitung erstellt hat. Kin bewahrt ihn als Nachweis neben dem Einsatz auf. Er bezahlt nichts.
BODY='{"externalId":"visit-1042","caregiver":"Pflegekraft","kind":"aide","startsAt":"2026-11-09T09:00:00-05:00","endsAt":"2026-11-09T13:00:00-05:00","checkedInAt":"2026-11-09T09:02:00-05:00","checkedOutAt":"2026-11-09T13:00:00-05:00"}'
T=$(date +%s)
SIG=$(printf '%s.%s' "$T" "$BODY" | openssl dgst -sha256 -hmac 'kin_ags_…' | sed 's/^.* //')
curl -s https://mzdg4f3stk.us-east-1.awsapprunner.com/api/v1/visits \
-H "Content-Type: application/json" \
-H "Kin-Agency-Key: agk_…" \
-H "Kin-Signature: t=$T,v1=$SIG" \
-d "$BODY"201 aufbewahrt · 200 schon aufbewahrt · 401 Schlüssel oder Signatur · 409 gleiche ID, anderer Inhalt · 422 aufbewahrt, aber unlesbar
Agentur-API
Eine Rechnung schicken
Schicken Sie eine Rechnung per POST an /api/v1/invoices, genau wie einen Besuch signiert. Jede Position nennt einen Besuch, den die Agentur schon gemeldet hat, in ganzen Cent; Kin rechnet die Summe selbst nach. Die Rechnung wird zu einer Rechnung, die die Familie an den bestätigten Besuchen prüft. Sie bezahlt von sich aus nichts.
BODY='{"invoiceNumber":"INV-1042","periodStart":"2026-11-01","periodEnd":"2026-11-30","lines":[{"visitId":"visit-1042","minutes":240,"amountCents":11200,"currency":"USD"}],"totalCents":11200,"currency":"USD","dueOn":"2026-12-15","paypalEmail":"billing@agency.example"}'
T=$(date +%s)
SIG=$(printf '%s.%s' "$T" "$BODY" | openssl dgst -sha256 -hmac 'kin_ags_…' | sed 's/^.* //')
curl -s https://mzdg4f3stk.us-east-1.awsapprunner.com/api/v1/invoices \
-H "Content-Type: application/json" \
-H "Kin-Agency-Key: agk_…" \
-H "Kin-Signature: t=$T,v1=$SIG" \
-d "$BODY"P=/api/v1/invoices/INV-1042 T=$(date +%s) SIG=$(printf '%s.%s' "$T" "$P" | openssl dgst -sha256 -hmac 'kin_ags_…' | sed 's/^.* //') curl -s https://mzdg4f3stk.us-east-1.awsapprunner.com$P \ -H "Kin-Agency-Key: agk_…" \ -H "Kin-Signature: t=$T,v1=$SIG"
201 zur Prüfung aufbewahrt · 200 schon aufbewahrt · 401 Schlüssel oder Signatur · 409 gleiche Nummer, anderer Inhalt · 422 aufbewahrt, aber abgelehnt, mit Grund · GET: received, under_review, approved, paid, declined
OpenAPI
Das veröffentlichte Dokument
Aus den Schemas gebaut, gegen die der Server Anfragen prüft, sodass es nicht davon abweichen kann.
SDKs für TypeScript und Python, von APIMatic aus genau diesem Dokument erzeugt. Jedes enthält ein signiertes Beispiel für die Agentur-API.