@truealter/sdk

~Alter Identity SDK - query the continuous identity field from any JavaScript/TypeScript environment.

Install: npm install @truealter/sdk

A thin client over the ~Alter MCP server (Streamable HTTP, JSON-RPC 2.0, MCP spec 2025-11-25) with x402 micropayment support, ES256 provenance verification, and config generators for Claude Code, Cursor, and generic MCP clients.

• Branded host: https://mcp.truealter.com (serves .well-known/mcp.json for discovery)
• JSON-RPC wire endpoint: https://mcp.truealter.com/api/v1/mcp - this is what Streamable HTTP POSTs target (the SDK default)
• Wire protocol: Streamable HTTP, JSON-RPC 2.0, MCP 2025-11-25 (server negotiates 2025-06-18 + 2025-03-26 for backwards-compatible clients)
• Tools: 37 publicly advertised, 28 free (L0) + 9 premium (L1-L5), kept in sync with ~Alter's live MCP server at every publish.
• Runtime: Node 18+, Deno, Bun, Cloudflare Workers, modern browsers
• Crypto: @noble/ed25519 + @noble/hashes (no other dependencies)
• Bundle: ESM + CJS dual output

Quickstart

npm install @truealter/sdk

Then import the client in your code (see the API section below). The day-to-day command line lives in @truealter/cli:

alter init
alter verify ~alter

Bridge vs SDK

This package ships a stdio bridge entrypoint (bin/mcp-bridge.ts, built to dist/bin/mcp-bridge.js) that the alter CLI launches by file path via its mcp-bridge subcommand. It is a dev/demo surface for dropping ~Alter into MCP hosts that speak the stdio transport (Claude Code, Cursor, Continue, Windsurf). It is useful for handshake, tools/list, and L0 tool calls, but it does not carry ES256 per-invocation signing: authenticated MCP tools will fail at the server edge when reached through the bridge. For production use, import @truealter/sdk directly and construct an MCPClient / AlterClient with the optional signing parameter; that path is the primary one and carries the provenance envelope end-to-end. Bridge signing is planned for a future release.

CLI

This package exposes no command-line binary of its own: it is a library you import. The bridge entrypoint above is not a published bin; it is resolved by file path from the alter CLI, which is distributed separately as @truealter/cli. Run alter --help for the inline reference.

Why ~Alter is not IAM

Identity Access Management answers who is logged in. ~Alter answers who they actually are - a continuous field of recognition that any IAM stack can sit on top of.

Theoretical Foundation

~Alter is the working instantiation of an eight-paper academic corpus on identity field theory. The SDK below is what happens when the theory ships as protocol. Each paper is open access on figshare under CC-BY 4.0.

... View full README on GitHub