Vai al contenuto
Kin

Per sviluppatori

Lavori con il cerchio di una famiglia. Non approvi mai.

L'assistente IA di un familiare si collega al server MCP di Kin accedendo tramite OAuth, o con un token che il familiare concede. Il software di un'agenzia di assistenza domiciliare segnala le visite tramite un'API firmata. Entrambi leggono e propongono; una persona approva in Kin.

Server MCP

Collegare un assistente

HTTP in streaming, un messaggio JSON-RPC per richiesta, nessuna sessione. Versioni del protocollo 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. Un client accede tramite OAuth 2.1, oppure il familiare crea un token nella schermata Assistenti collegati.

Endpoint
https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp

Accedi dal tuo client

Aggiungi l'indirizzo di Kin senza token. Il tuo client trova Kin dal 401, si registra e apre Kin nel tuo browser; accedi, scegli cosa può fare e per quanto tempo, e rispondi sì. Kin è il proprio server di autorizzazione OAuth 2.1: PKCE con S256, documenti di metadati dell'ID client o registrazione dinamica, l'indicatore di risorsa e nessun token di aggiornamento.

Claude Code, con accesso
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp
Metadati del server di autorizzazione
https://mzdg4f3stk.us-east-1.awsapprunner.com/.well-known/oauth-authorization-server
Claude Code, con un token
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp --header "Authorization: Bearer <your-delegation-token>"
Impostazioni del client MCP (.mcp.json)
{
  "mcpServers": {
    "kin": {
      "type": "http",
      "url": "https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-delegation-token>"
      }
    }
  }
}
Qualsiasi 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":{}}}}'

Gli strumenti

Gli stessi strumenti e lo stesso gateway di Chiedi a Kin. tools/list mostra solo quelli che il ruolo del membro e l’ambito del token consentono.

  • get_poolLegge

    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_billsLegge

    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_fairnessLegge

    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_claimLegge

    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_proposalsLegge

    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_recordLegge

    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_statusLegge

    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_statusLegge

    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_statusLegge

    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_orderLegge

    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_invoiceLegge

    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_disputesLegge

    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_refillPropone

    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_giftPropone

    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.

Il limite

Cosa nessun chiamante esterno può fare

  • Nessuno strumento approva, paga, firma o sposta denaro. Uno strumento che propone restituisce l’ID della proposta e la schermata in cui una persona la approva, e la proposta attende quella persona anche se il permesso permanente del genitore la coprirebbe.
  • Gli strumenti propri di PayPal, quelli di scrittura compresi, restano sul server di Kin e non vengono mai offerti qui.
  • L’ambito del token restringe soltanto il ruolo del membro. Revocarlo fa rifiutare la chiamata successiva.
  • Il testo del registro (nomi, note, lettere) torna etichettato come dato, dentro un tag che non può chiudere.
  • Una richiesta senza un token attivo riceve 401 e un’intestazione WWW-Authenticate che punta ai metadati della risorsa protetta.

API per le agenzie

Segnalare una visita

Invii con POST una visita a /api/v1/visits, firmata con la chiave creata dall’organizzatore del cerchio. Kin la conserva come prova accanto al turno. Non paga nulla.

Firmi il corpo grezzo
BODY='{"externalId":"visit-1042","caregiver":"Assistente familiare","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 conservata · 200 già conservata · 401 chiave o firma · 409 stesso ID, altro corpo · 422 conservata ma illeggibile

API per le agenzie

Inviare una fattura

Invii una fattura con POST a /api/v1/invoices, firmata esattamente come una visita. Ogni riga indica una visita già segnalata dall’agenzia, in centesimi interi; Kin rifà la somma da sé. La fattura diventa una fattura che la famiglia controlla rispetto alle visite confermate. Da sola non paga nulla.

Firmare e inviare una fattura
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"
Chiedere a che punto è (firmi il percorso)
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 conservata per il controllo · 200 già conservata · 401 chiave o firma · 409 stesso numero, altro contenuto · 422 conservata ma rifiutata, con il motivo · GET: received, under_review, approved, paid, declined

OpenAPI

Il documento pubblicato

Generato dagli schemi con cui il server controlla le richieste, quindi non può andare fuori sincrono.

Apri il documento OpenAPI

SDK per TypeScript e Python, generati da APIMatic da questo stesso documento. Ognuno contiene un esempio firmato per l’API delle agenzie.

Comincia da una conversazione con la tua famiglia.