Saltar al contenido
Kin

Para desarrolladores

Trabaje con el círculo de una familia. Nunca apruebe.

El asistente de IA de un familiar se conecta al servidor MCP de Kin iniciando sesión con OAuth, o con un token que el familiar concede. El software de una agencia de cuidados a domicilio informa de las visitas mediante una API firmada. Ambos leen y proponen; una persona aprueba en Kin.

Servidor MCP

Conectar un asistente

HTTP en streaming, un mensaje JSON-RPC por solicitud, sin sesión. Versiones del protocolo 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. Un cliente inicia sesión con OAuth 2.1, o el familiar crea un token en la pantalla Asistentes conectados.

Punto de acceso
https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp

Inicia sesión desde tu cliente

Añade la dirección de Kin sin token. Tu cliente encuentra Kin a partir del 401, se registra y abre Kin en tu navegador; inicias sesión, eliges qué puede hacer y durante cuánto tiempo, y dices que sí. Kin es su propio servidor de autorización OAuth 2.1: PKCE con S256, documentos de metadatos de ID de cliente o registro dinámico, el indicador de recurso y ningún token de actualización.

Claude Code, iniciando sesión
claude mcp add --transport http kin https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp
Metadatos del servidor de autorización
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>"
Ajustes del cliente MCP (.mcp.json)
{
  "mcpServers": {
    "kin": {
      "type": "http",
      "url": "https://mzdg4f3stk.us-east-1.awsapprunner.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-delegation-token>"
      }
    }
  }
}
Cualquier cliente 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":{}}}}'

Las herramientas

Las mismas herramientas y la misma pasarela que Preguntar a Kin. tools/list muestra solo las que permiten el rol del miembro y el alcance del token.

  • get_poolLee

    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_billsLee

    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_fairnessLee

    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_claimLee

    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_proposalsLee

    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_recordLee

    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_statusLee

    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_statusLee

    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_statusLee

    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_orderLee

    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_invoiceLee

    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_disputesLee

    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.

El límite

Lo que ningún llamante externo puede hacer

  • Ninguna herramienta aprueba, paga, firma ni mueve dinero. Una herramienta que propone devuelve el ID de la propuesta y la pantalla donde una persona la aprueba, y la propuesta espera a esa persona aunque el permiso permanente del padre o la madre la cubriría.
  • Las herramientas propias de PayPal, incluidas las de escritura, se quedan en el servidor de Kin y nunca se ofrecen aquí.
  • El alcance del token solo reduce el rol del propio miembro. Revocarlo hace que se rechace la llamada siguiente.
  • El texto del registro (nombres, notas, cartas) vuelve etiquetado como dato, dentro de una etiqueta que no puede cerrar.
  • Una petición sin un token activo recibe 401 y una cabecera WWW-Authenticate que apunta a los metadatos del recurso protegido.

API de agencias

Informar de una visita

Envíe con POST una visita a /api/v1/visits, firmada con la clave que creó el organizador del círculo. Kin la guarda como prueba junto al turno. No paga nada.

Firme el cuerpo sin procesar
BODY='{"externalId":"visit-1042","caregiver":"Persona cuidadora","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 guardada · 200 ya guardada · 401 clave o firma · 409 mismo ID, otro cuerpo · 422 guardada pero ilegible

API de agencias

Enviar una factura

Envíe una factura con POST a /api/v1/invoices, firmada igual que una visita. Cada línea nombra una visita que la agencia ya informó, en céntimos enteros; Kin suma las líneas por su cuenta. La factura pasa a ser una factura que la familia revisa con las visitas que confirmó. Por sí sola no paga nada.

Firmar y enviar una factura
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"
Preguntar en qué punto está (firme la ruta)
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 guardada para revisión · 200 ya guardada · 401 clave o firma · 409 mismo número, otro contenido · 422 guardada pero rechazada, con el motivo · GET: received, under_review, approved, paid, declined

OpenAPI

El documento publicado

Se genera a partir de los esquemas con los que el servidor comprueba las peticiones, así que no puede desfasarse.

Abrir el documento OpenAPI

SDK para TypeScript y Python, generados por APIMatic a partir de este mismo documento. Cada uno incluye un ejemplo firmado para la API de agencias.

Empieza con una conversación con tu familia.