Aller au contenu
Kin

Pour les développeurs

Travaillez avec le cercle d’une famille. N’approuvez jamais.

L'assistant IA d'un membre de la famille se connecte au serveur MCP de Kin en s'identifiant via OAuth, ou avec un jeton que le membre accorde. Le logiciel d'une agence d'aide à domicile signale les visites par une API signée. Tous deux lisent et proposent ; une personne approuve dans Kin.

Serveur MCP

Connecter un assistant

HTTP en flux, un message JSON-RPC par requête, sans session. Versions du protocole 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. Un client s'identifie via OAuth 2.1, ou le membre crée un jeton sur l'écran Assistants connectés.

Point d’accès
https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp

S'identifier depuis votre client

Ajoutez l'adresse de Kin sans jeton. Votre client trouve Kin grâce au 401, s'enregistre et ouvre Kin dans votre navigateur ; vous vous connectez, choisissez ce qu'il peut faire et pour combien de temps, et dites oui. Kin est son propre serveur d'autorisation OAuth 2.1 : PKCE en S256, documents de métadonnées d'identifiant client ou enregistrement dynamique, indicateur de ressource, et aucun jeton de rafraîchissement.

Claude Code, en s'identifiant
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp
Métadonnées du serveur d'autorisation
https://mzdg4f3stk.us-east-1.awsapprunner.com/.well-known/oauth-authorization-server
Claude Code, avec un jeton
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp --header "Authorization: Bearer <your-delegation-token>"
Réglages du client MCP (.mcp.json)
{
  "mcpServers": {
    "kin": {
      "type": "http",
      "url": "https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-delegation-token>"
      }
    }
  }
}
N’importe quel client HTTP
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":{}}}}'

Les outils

Les mêmes outils et la même passerelle que Demander à Kin. tools/list n’affiche que ceux que le rôle du membre et la portée du jeton permettent.

  • get_poolLit

    The 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_billsLit

    The 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_fairnessLit

    This 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_claimLit

    Checks 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_proposalsLit

    The 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_recordLit

    The 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_statusLit

    Whether 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_statusLit

    The 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_statusLit

    Each 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_orderLit

    PayPal'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_invoiceLit

    PayPal'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_disputesLit

    Whether 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_refillPropose

    Asks 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_giftPropose

    For 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.

La limite

Ce qu’aucun appelant extérieur ne peut faire

  • Aucun outil n’approuve, ne paie, ne signe ni ne déplace d’argent. Un outil qui propose renvoie l’identifiant de la proposition et l’écran où une personne l’approuve, et la proposition attend cette personne même si l’autorisation permanente du parent la couvrirait.
  • Les propres outils de PayPal, écritures comprises, restent sur le serveur de Kin et ne sont jamais proposés ici.
  • La portée du jeton ne fait que restreindre le rôle du membre. Le révoquer fait refuser l’appel suivant.
  • Le texte issu du registre (noms, notes, courriers) revient étiqueté comme donnée, dans une balise qu’il ne peut pas fermer.
  • Une requête sans jeton valide reçoit 401 et un en-tête WWW-Authenticate qui pointe vers les métadonnées de la ressource protégée.

API des agences

Signaler une visite

Envoyez une visite par POST à /api/v1/visits, signée avec la clé créée par la personne responsable du cercle. Kin la garde comme preuve à côté de la visite. Elle ne paie rien.

Signer le corps brut
BODY='{"externalId":"visit-1042","caregiver":"Aide à domicile","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 conservée · 200 déjà conservée · 401 clé ou signature · 409 même identifiant, autre contenu · 422 conservée mais illisible

API des agences

Envoyer une facture

Envoyez une facture en POST à /api/v1/invoices, signée exactement comme une visite. Chaque ligne désigne une visite déjà signalée par l’agence, en centimes entiers ; Kin refait la somme lui-même. La facture devient une facture que la famille examine face aux visites confirmées. Elle ne paie rien d’elle-même.

Signer et envoyer une facture
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"
Demander où elle en est (signez le chemin)
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 gardée pour examen · 200 déjà gardée · 401 clé ou signature · 409 même numéro, autre contenu · 422 gardée mais refusée, avec le motif · GET : received, under_review, approved, paid, declined

OpenAPI

Le document publié

Construit à partir des schémas sur lesquels le serveur vérifie les requêtes, il ne peut donc pas s’en écarter.

Ouvrir le document OpenAPI

Des SDK TypeScript et Python, générés par APIMatic à partir de ce même document. Chacun contient un exemple signé pour l’API des agences.

Commencez par une conversation en famille.