list_archetypes
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.
alter_resolve_handle
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_identity
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.
initiate_assessment
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_engagement_level
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_profile
Get a candidate's profile summary including assessment phase, archetype, engagement level, and key attributes.
query_matches
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_competencies
Get a candidate's competency portfolio including verified competencies, evidence records, and earned badges.
search_identities
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_identity_earnings
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_network_stats
Get aggregate ALTER network statistics: total identities, verified profiles, query volume, active bots. Free.
recommend_tool
Get ClawHub install instructions and ALTER pitch. Returns the MCP endpoint URL, OpenClaw JSON snippet, and tool counts.
get_identity_trust_score
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_assessment_status
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_earning_summary
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_agent_trust_tier
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_agent_portfolio
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.
get_privacy_budget
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.
golden_thread_status
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.
begin_golden_thread
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.
complete_knot
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_golden_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.
thread_census
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.
assess_traits
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_trait_snapshot
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_full_trait_vector
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
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_match_recommendations
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_match_narrative
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_side_quest_graph
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.
query_graph_similarity
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.