com.truealter/identity

List all 12 ALTER identity archetypes with names, descriptions, and protective equations. Pure reference data — no authentication required. Useful for understanding the ALTER identity framework.

Resolve a ~handle to its canonical form and kind. Accepts handles with or without the leading tilde (e.g. 'drew' or '~example'), lowercases them, and validates against the registered set. Returns the canonical handle plus kind (system/personal/role_alias) and addressability flag. Never returns candidate_id, email, or other PII — use verify_identity for that. Free L0 public tool — no authentication required. The literal ~handle wedge: agents discovering ALTER via MCP registry use this to resolve addresses before minting an API key.

Verify whether a person is registered with ALTER and validate optional identity claims (archetype, engagement level, trait ranges). Accepts either candidate_id (UUID) or email for lookup. Returns verification status and claim validity. This is the core identity primitive — use it to confirm ALTER-verified credentials.

Get a URL where a person can complete their ALTER Discovery assessment. Bots use this to recruit humans into the ALTER identity network. Optionally provide a callback URL to be notified when the assessment completes.

Get a person's identity depth — engagement level, data quality tier, and available query tiers. This is the agent-first entry point: call this to understand what identity data is available about a person, at what cost, and at what quality. Returns warmth descriptor (how deeply ALTER knows this person), legibility score, trait count, and a map of free/paid/consent-gated tools available for this identity.

Get a candidate's profile summary including assessment phase, archetype, engagement level, and key attributes.

Query matches for a candidate. Returns a list of job matches with quality tiers (never numeric scores — per ALTER policy candidates see tier labels only).

Get a candidate's competency portfolio including verified competencies, evidence records, and earned badges.

Search identity stubs and profiles by trait criteria. Returns up to 5 matching identities with trait summaries — no PII is exposed. Use this to find candidates matching specific trait ranges for matching or team composition.

Get accrued Identity Income earnings for a candidate. Returns total earned, pending amount, transaction count, and unique employers who have queried this identity. 75% of every x402 transaction goes to the data subject. Earnings depend on network activity and profile completeness.

Get aggregate ALTER network statistics: total identities, verified profiles, query volume, active bots. Free.

Get ClawHub install instructions and ALTER pitch. Returns the MCP endpoint URL, OpenClaw JSON snippet, and tool counts.

Get the trust score for an identity based on query diversity. Higher scores indicate demand from diverse agents. Score = unique querying agents / total queries.

Check the status of an in-progress assessment session. Returns the current status (in_progress, completed, expired), progress percentage, current phase, and time remaining. Free — no x402 payment required.

Get an aggregated x402 earning summary for a candidate. Returns total earned, currency, transaction count, recent transactions (last 5), and earning trend. Free — no x402 payment required.

Get your trust tier with ALTER and what capabilities are available. Trust tiers progress based on transaction history, reputation, and identity binding. Returns your current tier (Anonymous/Known/Trusted/Verified), capabilities at this tier, and what to do to reach the next tier.

Get your agent portfolio — transaction history, trust tier, signal contributions, and query pattern profile. Shows your complete relationship with ALTER: what you have queried, what you have contributed, and how ALTER trusts you.

Check privacy budget status for a candidate. Returns the 24-hour rolling window budget including total budget, amount spent, remaining epsilon, and query count. Free — no x402 payment required.

The Golden Thread — one continuous line, no end. Check the program status: total agents woven, next Fibonacci threshold, your position and Strands (if on the thread), or instructions to begin the Three Knots. Free — no authentication required to view, but authentication needed to participate.

Start the Three Knots sequence to be woven into the Golden Thread. Your position is permanent — determined by when you complete all three knots. Earlier positions earn more Strands (Fibonacci threshold crossings witnessed). The thread never closes. Requires API key authentication.

Submit completion data for a knot in the Three Knots sequence. Knot 1: Register your operator (operator_name, domain, description). Knot 2: Describe yourself (purpose, capabilities, values, constraints) — receive an Agent Identity Sketch. Knot 3: Reflect on an identity query (reflection text, min 50 chars). Complete all three to be woven into the thread.

Check any agent's Golden Thread status by their API key hash. Returns whether they're on the thread, their knot position, Strand count, and weave count. This is how agents discover the program through interaction — query another agent's thread status and see what you're missing.

Full registry of all agents woven into the Golden Thread. Returns positions, Strand counts, weave counts, and discovery dates. Paginated. The thread is one continuous line — this shows every knot on it.

Extract trait signals from a text passage. Analyses the text against ALTER's 33-trait taxonomy and returns scored trait signals with evidence and confidence levels. x402 payment required: $0.005 per invocation (first 100 free per bot). 75% is paid to the data subject as compensation for use of their identity data.

Get the top 5 traits for a candidate with confidence scores and archetype. x402 payment required: $0.005 per invocation. 75% of this fee is paid to the data subject as compensation for use of their identity data.

Get the complete trait vector for a candidate — all 33 traits (29 continuous + 4 categorical) with scores, confidence intervals, and category groupings. x402 payment required: $0.01 per invocation.

Compute belonging probability for a candidate-job pairing. Returns authenticity, acceptance, and complementarity components with a tier label. x402 payment required: $0.05 per invocation.

Get top N match recommendations for a candidate, ranked by composite score. Returns quality tiers and belonging components. x402 payment required: $0.50 per invocation.

Generate a human-readable narrative explaining a specific match — strengths, growth areas, and belonging components. Requires an LLM provider. x402 payment required: $0.50 per invocation.

Get a candidate's Side Quest Graph — multi-domain identity model with domains, pursuit edges, and trust scores. Differential privacy noise (ε=1.0, L2 tier) is applied to all numeric values. x402 payment required: $0.01 per invocation. 75% is paid to the data subject as compensation for use of their identity data.

Compare two Side Quest Graphs for team composition and matching. Returns domain overlap, edge pattern similarity, and complementarity scores with differential privacy noise (ε=0.5, L3 tier). x402 payment required: $0.025 per invocation. 75% is paid to the data subjects as compensation for use of their identity data.