NSIDesenvolvedores

Envie uma decisão. Confira um recibo. De qualquer sistema.

Dois endpoints públicos e um servidor MCP. Qualquer sistema que envie JSON pode registrar uma decisão. Qualquer pessoa pode verificar um recibo sem confiar em nós.

O que a API nunca faz

Nunca aprova uma decisão. Cada registro chega pendente e espera por uma pessoa.
Nunca deixa um remetente definir a própria pontuação. A North Star calcula a pontuação a partir das notas.
Nunca lê outra conta. Uma chave de conexão escreve em uma única caixa de entrada e pode ser revogada a qualquer momento.
Nunca publica mais do que o cliente autorizou. Um recibo carrega apenas o nível de publicação que seu dono escolheu.

1. Obtenha uma chave de conexão

As chaves são emitidas dentro do portal do cliente, uma por sistema, e começam com nsv_. Atribua um modelo de decisão a uma chave e ele preenche o responsável, o prazo e as notas das decisões que chegarem sem eles.

Como as conexões funcionam →

2. Envie uma decisão

Uma solicitação, uma decisão. Limite de 60 por hora por remetente e 8 KB por corpo.

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

{
  "decision": "Contratar um segundo despachante antes da temporada de tempestades",
  "owner": "Líder de despacho",
  "next_action": "Publicar a vaga e aprovar horas extras até ela ser preenchida",
  "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	Regra	Significado
`decision`	Obrigatório. De 3 a 500 caracteres.	A decisão em uma frase.
`owner`	Opcional, até 100 caracteres.	Uma pessoa nomeada.
`next_action`	Opcional, até 300 caracteres.	A próxima ação concreta.
`due_at`	Opcional, AAAA-MM-DD.	Uma data com hora é reduzida à data.
`opportunity, risk, effort`	Opcional, cada um de 1 a 3.	1 baixo, 2 médio, 3 alto. Risco significa risco de esperar.
`system`	Opcional, até 200 caracteres.	De onde a decisão veio. Nomes desconhecidos são guardados como Outro.
`confident`	Opcional, true ou false.	false encaminha a uma pessoa em vez de assumir o acompanhamento.
`external_ref`	Opcional, até 200 caracteres.	Sua própria referência. Enviá-la de novo devolve o registro existente.

Respostas

201Salvo. O registro fica pendente até uma pessoa aprová-lo.
200Mesmo external_ref de antes. O registro existente é devolvido com duplicate: true.
401Chave ausente, malformada ou revogada.
413Corpo maior que 8 KB.
422Campo inválido, ou um valor fora das faixas que o modelo de decisão da chave permite. A resposta lista cada problema.
429Mais de 60 solicitações em uma hora de um mesmo remetente.
500Não foi salvo. Nada foi registrado, então tente mais tarde.

3. A pontuação

((2 × oportunidade) + risco de esperar − esforço) ÷ 8 × 100, cada dado com nota de 1 a 3. O exemplo acima obtém 88. Ordena uma decisão em relação a outras e não é uma porcentagem da receita.

Como a pontuação é calculada →

4. Verifique um recibo

Nenhuma chave necessária. Limite de 120 consultas por hora. Um recibo que seu dono não autorizou a publicar devolve 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"
}

Quatro verificações, todas do seu lado

Impressão digitalO SHA-256 do texto do payload é igual a payload_sha256.
IdentidadeO payload, em JSON canônico com chaves ordenadas, nomeia este id, key_id e prev_sha256, e seu standard é North Star Verified.
AssinaturaA assinatura Ed25519 é verificada sobre o texto do payload com public_key.
Registropublic_key aparece em /api/public/receipt-keys, incluindo chaves aposentadas.

Se as quatro passam, o recibo é válido. Se uma falha, está quebrado, diga o que disser nosso servidor. As mesmas verificações rodam no navegador na página de verificação.

Verifique um recibo no navegador →

5. O servidor MCP

Um servidor Model Context Protocol dá a qualquer agente de IA quatro ferramentas: score_decision, submit_decision, verify_receipt e list_receipt_keys, além da fórmula de pontuação e do Contrato de evidências como recursos legíveis. Roda por stdio com Node 20 ou superior.

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

Escreva para admin@northstarintel.ai para obter o pacote e as notas de configuração para Claude, Cursor e outros clientes MCP.

Perguntas

Uma pessoa lê cada mensagem. Conte qual sistema você está conectando e como a decisão aparece do seu lado.

Contato →

Seções

O ciclo de decisões

Sinal, pontuação, responsabilidade, ação, verificação e aprendizado.

Voltar para O ciclo de decisões

Encontrar uma página

Começar

Defina um responsável pela sua próxima decisão operacional.

Conte qual decisão precisa priorizar. Confirmaremos o escopo, as evidências disponíveis e o próximo passo antes de prosseguir.

Solicitar análise de decisões Explorar uma decisão de exemplo