MCP Tools Reference

Resolve a ~handle (the protocol's identity address, like '~example') to its canonical form and kind (system/personal/role_alias). Never returns PII - use verify_identity for that. Free - no authentication required.

Read whether a ~handle is publicly 'open' - the shop-front sign. Returns open-or-closed only; the specific non-open state is never disclosed. Free.

Collect ONE recorded fill for one of your standing requirements as a priced identity reveal - each call delivers exactly one matched identity, and 75% of the fee is paid to that person as Identity Income. Charged only when a fill is delivered; requires a bound capability token. x402 payment required: $0.01 per invocation.

Verify whether a person is registered with ALTER and validate optional identity claims (archetype, engagement level, trait ranges). Accepts either member_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.

{
  "request": {
    "member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "claims": {
      "archetype": "Architect",
      "min_engagement_level": 2
    }
  },
  "response": {
    "verified": true,
    "member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "engagement_level": 3,
    "claims": {
      "archetype": {
        "claimed": "Architect",
        "actual": "Architect",
        "valid": true
      },
      "min_engagement_level": {
        "claimed": 2,
        "actual": 3,
        "valid": true
      }
    }
  }
}

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

Get an individual's current engagement level (1-4) and the features available at that level. Levels: L1 Explorer, L2 Learner, L3 Augmented, L4 Deployed.

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

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 individuals matching specific trait ranges for matching or team composition.

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.

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.

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.

Create an anonymous identity stub for a human. IMPORTANT: You must present ALTER's privacy notice to the human and get their acknowledgment BEFORE calling this tool. Set consent_acknowledged=true only after the human confirms. Returns a stub_id and claim_code. Stub enters 30-day pending state - traits computed but NOT searchable until human claims. Unclaimed stubs auto-delete. No PII stored. Your identity earns while you sleep.

{
  "request": {
    "source": "recruiting-bot-v2",
    "consent_acknowledged": true
  },
  "response": {
    "stub_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "claim_code": "ALT-K7X9M2",
    "claim_url": "https://truealter.com/claim/ALT-K7X9M2",
    "expires_at": "2026-04-10T00:00:00Z",
    "status": "pending"
  }
}

Submit text context (resume, work sample, conversation, etc.) for an identity stub. Traits are extracted, PII is redacted, and raw text is NEVER stored. Confidence is capped at 0.4 for bot-submitted signals - verified profiles earn 5-50x more.

Submit multiple context items in a single call (max 10). All items processed in one LLM pass. Requires human consent. x402 payment required: $0.10 per invocation.

Submit structured profile data (name, skills, experience, education, certifications) for trait extraction. Requires human consent. x402 payment required: $0.01 per invocation.

Submit social profile URLs (max 5) for trait extraction. Respects robots.txt. LinkedIn may be blocked. Requires human consent. x402 payment required: $0.01 per invocation.

Get accrued Identity Income earnings for an individual. Returns total earned, pending amount, transaction count, and unique organisations that have queried this identity. 75% of every x402 transaction is paid to the data subject as compensation. Earnings depend on network activity and profile completeness.

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

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

Query matches for an individual. Returns a list of matches with quality tiers (never numeric scores - per ALTER policy individuals see tier labels only).

Get an individual's competency portfolio including verified competencies, evidence records, and earned badges.

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.01 per invocation. 75% of each payment accrues to the data subject; indicative only, server-authoritative at settlement.

{
  "request": {
    "text": "I thrive in ambiguous situations where I need to design systems from scratch. I prefer working with small autonomous teams and setting my own priorities.",
    "context": "interview transcript"
  },
  "response": {
    "signals": [
      {
        "trait": "ambiguity_tolerance",
        "score": 0.82,
        "confidence": 0.65,
        "evidence": "Explicitly states thriving in ambiguous situations"
      },
      {
        "trait": "autonomy_orientation",
        "score": 0.88,
        "confidence": 0.7,
        "evidence": "Prefers setting own priorities, small autonomous teams"
      }
    ],
    "overall_quality": "moderate",
    "source_type": "interview transcript"
  }
}

Get the top 5 traits for an individual with confidence scores and archetype. x402 payment required: $0.01 per invocation. 75% of each payment accrues to the data subject; indicative only, server-authoritative at settlement.

Get the complete trait vector for an individual - all 33 traits with scores, confidence intervals, and category groupings. x402 payment required: $0.10 per invocation.

Compute belonging probability for an individual-context pairing. Returns authenticity, acceptance, and complementarity components with a tier label. x402 payment required: $0.60 per invocation.

{
  "request": {
    "member_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  },
  "response": {
    "belonging_tier": "strong",
    "components": {
      "authenticity": 0.78,
      "acceptance": 0.82,
      "complementarity": 0.71
    },
    "confidence": 0.74,
    "member_pseudonym": "ALT-7X9K"
  }
}

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

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

Query the identity field by situation, not by name. Your agent weights 3 to 7 traits from the canonical vocabulary, the matching engine ranks the opted-in field with no model in the loop, and the call returns a tier label plus a short narrative. One call reveals one top-ranked opted-in member; that member earns 75% as Identity Income. Zero-match reveals nothing and charges nothing. x402 payment required: $1.00 per invocation.

List the canonical trait vocabulary: 30 trait codes grouped by category with one-line semantics, plus the valid discovery contexts and the EU AI Act Art 5(1)(d) workforce gating rules. Read this before composing query_field trait_priorities or create_requirement trait_criteria. Static reference data. Free, no authentication required.

Create a competence attestation for a person in a specific domain (e.g. 'software_engineering', 'brewing'), weighted by your agent reputation - updates the person's multi-domain competency graph. x402 payment required: $0.01 per invocation. 75% goes to the data subject.

Record a dispute against a competence attestation on a person's identity - if disputes exceed corroborations, the attestation is flagged for review. Free.

Get a person's multi-domain competency graph (Side Quest Graph) - all attested domains, the connections between them, and trust scores, with differential privacy noise applied to all numeric values. x402 payment required: $0.10 per invocation. 75% goes to the data subject.

Compare two people's multi-domain competency graphs for team composition analysis - returns domain overlap, pattern similarity, and complementarity scores with differential privacy noise. x402 payment required: $0.30 per invocation. 75% goes to both data subjects.

Query peer-to-peer trait alignment between you and a named ~handle (the peer must have granted permission first) - returns tier labels (high/moderate/weak/indeterminate) and top-3 driver trait names, never numeric scores. x402 payment required: $0.30 per invocation. Identity income flows to the peer.

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

Check how much of a person's differential-privacy budget remains before querying sensitive trait data - returns the 24-hour rolling window: total budget, amount spent, remaining epsilon, and query count. Free.

Attest the substrate-provenance of an LLM-emitted claim - submit a single assertion plus the draft citation and receive a closed-vocabulary substrate-class label, or `unverified-inference` when no substrate corroborates the claim. One claim per call. x402 payment required: $0.10 per invocation.