Tunnel Enroll

Bind a device public key to a machine_id (ADR-0009). The private key never leaves the device (Secure Enclave on Mac); this only ever receives the PUBLIC key + a proof of the right to enroll it. Additive alongside the bearer token during the migration window.

proof.kind:

  • "tofu" : first enroll for a machine (no live key yet). First-wins; a second tofu is refused. TOFU is safe because enrollment happens at install, before the machine_id is exposed to any AI.
  • "bearer" : migration — the machine's existing bearer token proves ownership; binds the key and supersedes the token as the auth path.
  • "sig" : rotation — signed by the CURRENT live key over enroll_message(mid, new_pub); only the old key's holder can swap it, and the old key dies.
post/tunnel/enroll

Request

  • Base URL: https://api.local-mcp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.local-mcp.com/tunnel/enroll
  • Auth: none declared

Request body

machine_idstring
public_keystring
algstring
proofobject

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.