No Client Identity
Create one to connect to servers
Create Identity

Type Reference

The real protocol surface: the wire-model types from @kya-os/mcp and the published JSON Schema registry at schema.kya-os.org. Field definitions, TypeScript interfaces, examples, and canonical schema links.

Showing 7 of 7 wire-model types · 31 published schemas below

Per-Request Proof (v1)

The stateless holder-of-key proof every request carries - the core of the v1 wire model

Response Proof & Audit

The server's detached response proof and the consent step-up challenge it can bind

Identity & Delegation

The Entity Card that anchors identity, and the W3C VC delegation credential that conveys authority

Published Schema Registry

Every wire artifact has a canonical JSON Schema at schema.kya-os.org (31 schemas; list vendored from schema-index.json).

proof

The detached response proof

mcp-extension

The org.kya-os/decentralized-authority settings object

identity

The Entity Card

authorization

The consent step-up challenge

delegation

W3C VC delegation credentials and revocation status lists

well-known

Out-of-band discovery

audit

The verifiable audit trail: entries, checkpoints, receipts, RFC 9162 proofs, and replay bundles

handshake (legacy)

Pre-v1 session establishment - read-compat only; v1 has no handshake

Proof Explorer

See ProofMeta and DetachedProof in action

Live Client

See request and response proofs on the wire

Delegation Builder

Build DelegationConstraints interactively

Error Decoder

Debug StructuredError codes

Using @kya-os/mcp

Installation

npm install @kya-os/mcp

Importing Types

// Response proof + extension surface (main entry)
import {
  DetachedProof,
  ProofMeta,
  NeedsAuthorizationError,
  KyaOsExtensionSettings,
  KYA_OS_EXTENSION_ID,
} from "@kya-os/mcp";

// Per-request proof + Entity Card (card subpath)
import { CardProofMeta, buildCardProof, verifyCardProof } from "@kya-os/mcp/card";

// Delegation chains
import { validateDelegationChain } from "@kya-os/mcp/delegation";

Runtime Validation

// Wire artifacts validate against the published registry schemas
// (each card above links to its canonical URL), e.g.:
//   https://schema.kya-os.org/v1/protocol/proof/detached/v1.0.0
// The reference implementation ships matching Zod schemas:
import { CardProofMetaSchema } from "@kya-os/mcp/card";

const parsed = CardProofMetaSchema.safeParse(untrustedProof);
if (parsed.success) {
  // parsed.data is a typed CardProofMeta
}