NSIDesarrolladores

Envíe una decisión. Compruebe un recibo. Desde cualquier sistema.

Dos endpoints públicos y un servidor MCP. Cualquier sistema que envíe JSON puede registrar una decisión. Cualquiera puede verificar un recibo sin confiar en nosotros.

Lo que la API nunca hace

Nunca aprueba una decisión. Cada registro llega pendiente y espera a una persona.
Nunca deja que un remitente fije su propia puntuación. North Star la calcula a partir de las calificaciones.
Nunca lee otra cuenta. Una clave de conexión escribe en una sola bandeja y puede revocarse en cualquier momento.
Nunca publica más de lo que el cliente autorizó. Un recibo lleva solo el nivel de publicación que eligió su dueño.

1. Obtenga una clave de conexión

Las claves se emiten dentro del portal de clientes, una por sistema, y empiezan con nsv_. Asigne una plantilla de decisión a una clave y rellenará el responsable, la fecha límite y las calificaciones de las decisiones que lleguen sin ellos.

Cómo funcionan las conexiones →

2. Envíe una decisión

Una solicitud, una decisión. Límite de 60 por hora por remitente y 8 KB por cuerpo.

POST https://northstarintel.ai/api/public/decisions
Authorization: Bearer nsv_<your-connection-key>
Content-Type: application/json

{
  "decision": "Contratar un segundo despachador antes de la temporada de tormentas",
  "owner": "Líder de despacho",
  "next_action": "Publicar el puesto y aprobar horas extra hasta cubrirlo",
  "due_at": "2026-11-14",
  "opportunity": 3,
  "risk": 3,
  "effort": 2,
  "system": "Scheduling and dispatch",
  "external_ref": "dispatch-2026-11-07"
}

HTTP 201 Created

{
  "id": "a1b2c3d4-...",
  "score": 88,
  "status": "pending",
  "closing_state": "Follow-up owned"
}

Campo	Regla	Significado
`decision`	Obligatorio. De 3 a 500 caracteres.	La decisión en una frase.
`owner`	Opcional, hasta 100 caracteres.	Una persona con nombre.
`next_action`	Opcional, hasta 300 caracteres.	La siguiente acción concreta.
`due_at`	Opcional, AAAA-MM-DD.	Una fecha con hora se recorta a la fecha.
`opportunity, risk, effort`	Opcional, cada uno de 1 a 3.	1 bajo, 2 medio, 3 alto. Riesgo significa riesgo de esperar.
`system`	Opcional, hasta 200 caracteres.	De dónde viene la decisión. Los nombres desconocidos se guardan como Otro.
`confident`	Opcional, true o false.	false escala a una persona en lugar de asumir el seguimiento.
`external_ref`	Opcional, hasta 200 caracteres.	Su propia referencia. Enviarla de nuevo devuelve el registro existente.

Respuestas

201Guardado. El registro queda pendiente hasta que una persona lo apruebe.
200Mismo external_ref que antes. Se devuelve el registro existente con duplicate: true.
401Clave ausente, mal formada o revocada.
413Cuerpo mayor de 8 KB.
422Campo inválido, o un valor fuera de los rangos que permite la plantilla de decisión de la clave. La respuesta enumera cada problema.
429Más de 60 solicitudes en una hora desde un mismo remitente.
500No se guardó. No se registró nada, así que reintente más tarde.

3. La puntuación

((2 × oportunidad) + riesgo de esperar − esfuerzo) ÷ 8 × 100, cada dato calificado de 1 a 3. El ejemplo anterior obtiene 88. Ordena una decisión frente a otras y no es un porcentaje de ingresos.

Cómo se calcula la puntuación →

4. Verifique un recibo

No se necesita clave. Límite de 120 consultas por hora. Un recibo que su dueño no autorizó a publicar devuelve 404.

GET https://northstarintel.ai/api/public/receipts?id=NSV-2026-7K3M9Q
GET https://northstarintel.ai/api/public/receipt-keys

{
  "id": "NSV-2026-7K3M9Q",
  "payload": "{\"decision\":...,\"id\":\"NSV-2026-7K3M9Q\",\"key_id\":\"k-2026-01\",\"standard\":\"North Star Verified\",...}",
  "payload_sha256": "9f2c...",
  "prev_sha256": "41ab...",
  "signature": "base64 Ed25519 signature",
  "key_id": "k-2026-01",
  "public_key": "base64 raw Ed25519 public key",
  "created_at": "2026-11-07T20:00:00Z"
}

Cuatro comprobaciones, todas de su lado

HuellaEl SHA-256 del texto del payload es igual a payload_sha256.
IdentidadEl payload, en JSON canónico con claves ordenadas, nombra este id, key_id y prev_sha256, y su standard es North Star Verified.
FirmaLa firma Ed25519 se verifica sobre el texto del payload con public_key.
Registropublic_key aparece en /api/public/receipt-keys, incluidas las claves retiradas.

Si pasan las cuatro, el recibo es válido. Si falla una, está roto, diga lo que diga nuestro servidor. Las mismas comprobaciones corren en el navegador en la página de verificación.

Verifique un recibo en el navegador →

5. El servidor MCP

Un servidor Model Context Protocol da a cualquier agente de IA cuatro herramientas: score_decision, submit_decision, verify_receipt y list_receipt_keys, además de la fórmula de puntuación y el Contrato de evidencia como recursos legibles. Funciona por stdio con Node 20 o superior.

{
  "mcpServers": {
    "north-star-intel": {
      "command": "node",
      "args": ["/path/to/north-star-mcp/dist/index.js"],
      "env": { "NORTH_STAR_API_KEY": "nsv_..." }
    }
  }
}

Escriba a admin@northstarintel.ai para obtener el paquete y las notas de configuración para Claude, Cursor y otros clientes MCP.

Preguntas

Una persona lee cada mensaje. Cuéntenos qué sistema está conectando y cómo se ve la decisión de su lado.

Contacto →

Secciones

El ciclo de decisiones

Señal, puntuación, responsabilidad, acción, verificación y aprendizaje.

Volver a El ciclo de decisiones

Buscar una página

Comenzar

Asigne un responsable a su próxima decisión operativa.

Cuéntenos qué decisión necesita priorizar. Confirmaremos el alcance, las pruebas disponibles y el siguiente paso antes de avanzar.

Solicitar revisión de decisiones Explorar una decisión de ejemplo