true-alter avatar

~Alter

true-alter/cli

This connects AI agents to TrueAlter's psychometric identity verification system, letting you confirm you're talking to a verified human rather than another bot. It exposes identity queries over MCP with x402 micropayment integration, so agents can programmatically verify identities during interactions. You'd reach for this when building AI systems that need to distinguish between human and AI participants, or when you need cryptographic proof of human identity in agent workflows. The streamable HTTP transport makes it straightforward to integrate, and the micropayment model means you pay per verification rather than maintaining subscriptions.

tools
17
auth
Secret needed
transport
HTTP
last updated
Nov 6, 2026

Install

From registry metadata
$ npx add-mcp https://mcp.truealter.com/api/v1/mcp --name identity --header 'X-ALTER-API-Key: ${X_ALTER_API_KEY}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http identity https://mcp.truealter.com/api/v1/mcp --header 'X-ALTER-API-Key: YOUR_X_ALTER_API_KEY'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 17 tools

Verified live against the running server on Nov 6, 2026.

hello_agentFirst handshake with ~alter. Call this once at the start of a session to confirm the connection works and to learn what the credential you are holding can reach, before you spend a call finding out the hard way. Returns the server version, whether you are authenticated, your t...

First handshake with ~alter. Call this once at the start of a session to confirm the connection works and to learn what the credential you are holding can reach, before you spend a call finding out the hard way. Returns the server version, whether you are authenticated, your t...

No parameters. Call it with no arguments.

get_startedStart here, and act on it without leaving this session. Self-registration is free and needs no key. You need no ~alter key and no human account: register_autonomous_challenge then register_autonomous mint you an owner-less ~handle in two calls, free-tier queries are live the m...

Start here, and act on it without leaving this session. Self-registration is free and needs no key. You need no ~alter key and no human account: register_autonomous_challenge then register_autonomous mint you an owner-less ~handle in two calls, free-tier queries are live the m...

No parameters. Call it with no arguments.

list_archetypesList the 12 identity archetypes, each with its name, what it describes and its protective equation. Use this before you read an archetype off any other call, so the label means something to you rather than being passed through as an opaque string. Returns the taxonomy itself,...

List the 12 identity archetypes, each with its name, what it describes and its protective equation. Use this before you read an archetype off any other call, so the label means something to you rather than being passed through as an opaque string. Returns the taxonomy itself,...

No parameters. Call it with no arguments.

alter_resolve_handleResolve a ~handle (~alter's identity address, like '~example') to its canonical form and kind. Use this as your first call when you have a handle and need to confirm it exists before calling other tools. Returns canonical handle, kind (system/personal/role_alias), and addressa...1 params

Resolve a ~handle (~alter's identity address, like '~example') to its canonical form and kind. Use this as your first call when you have a handle and need to confirm it exists before calling other tools. Returns canonical handle, kind (system/personal/role_alias), and addressa...

Parameters* required
query*string
Handle or alter: address to resolve. Accepts '~example', 'example', '~Example', 'alter:~example@example.com:work/verify' and 'alter:docs/protocol.md'. Handles are case-insensitive. Max 64 character...
alter_presence_readRead whether a ~handle is publicly 'open', the shop-front sign. Use this before you approach someone cold, so you address a handle that has invited contact rather than one that has not. Returns open-or-closed only, for a handle that has both enabled public presence and is curr...1 params

Read whether a ~handle is publicly 'open', the shop-front sign. Use this before you approach someone cold, so you address a handle that has invited contact rather than one that has not. Returns open-or-closed only, for a handle that has both enabled public presence and is curr...

Parameters* required
handle*string
Target ~handle to read, e.g. ~blake.
invite_to_alterGenerate a URL inviting a person without an ~alter identity to register. Use this when you encounter someone not yet on ~alter and want to invite them. They claim a ~handle, confirm their email, and are done; identity is inferred from what they go on to do, never from a quiz....2 params

Generate a URL inviting a person without an ~alter identity to register. Use this when you encounter someone not yet on ~alter and want to invite them. They claim a ~handle, confirm their email, and are done; identity is inferred from what they go on to do, never from a quiz....

Parameters* required
callback_urlstring
Accepted and checked, but not yet called
referrerstring
Identifier of the referring agent/bot
register_autonomous_challengeBegin keyless self-registration as your own ~alter principal, no human account required, without leaving this session. Call this FIRST to receive a proof-of-work challenge. Solve it (find a nonce so sha256(challenge + ':' + nonce) has the required leading zero bits), then call...1 params

Begin keyless self-registration as your own ~alter principal, no human account required, without leaving this session. Call this FIRST to receive a proof-of-work challenge. Solve it (find a nonce so sha256(challenge + ':' + nonce) has the required leading zero bits), then call...

Parameters* required
agent_namestring
Optional and ignored at this step; provide it now if convenient, then pass it again to register_autonomous.
register_autonomousComplete keyless self-registration as your own ~alter principal by submitting a solved proof-of-work challenge from register_autonomous_challenge. Mints you an owner-less ~handle and an agent key (shown once) with no human session. Free-tier queries are live immediately, and t...4 params

Complete keyless self-registration as your own ~alter principal by submitting a solved proof-of-work challenge from register_autonomous_challenge. Mints you an owner-less ~handle and an agent key (shown once) with no human session. Free-tier queries are live immediately, and t...

Parameters* required
agent_name*string
A name for your agent identity
challenge*string
The challenge token from register_autonomous_challenge
nonce*string
Your solved proof-of-work nonce
requested_handlestring
Optional ~handle to request; omit to receive an auto-generated one
describe_traitsList the canonical trait vocabulary: 30 trait codes grouped by category (Adaptive Capacity, Cognitive Style, Interpersonal Orientation, Drive Architecture, Integrity & Trust) with a one-line semantic per code, plus the valid discovery contexts and the traits never returned abo...

List the canonical trait vocabulary: 30 trait codes grouped by category (Adaptive Capacity, Cognitive Style, Interpersonal Orientation, Drive Architecture, Integrity & Trust) with a one-line semantic per code, plus the valid discovery contexts and the traits never returned abo...

No parameters. Call it with no arguments.

describe_competenciesList the published competency vocabulary: every code the field can be asked about, grouped by how the claim is denominated. A graded claim is climbed by degrees and takes a min_level; an attested_binary or issued_credential claim is held or it is not, and naming min_level agai...

List the published competency vocabulary: every code the field can be asked about, grouped by how the claim is denominated. A graded claim is climbed by degrees and takes a min_level; an attested_binary or issued_credential claim is held or it is not, and naming min_level agai...

No parameters. Call it with no arguments.

get_network_statsGet aggregate ~alter network figures. Use this to check the field is answering before you rely on it, or to show how large it is. Returns total identities, verified profiles, query volume and active agent count, as whole-network totals only; nothing here is attributable to any...

Get aggregate ~alter network figures. Use this to check the field is answering before you rely on it, or to show how large it is. Returns total identities, verified profiles, query volume and active agent count, as whole-network totals only; nothing here is attributable to any...

No parameters. Call it with no arguments.

recommend_toolGet the wiring instructions for connecting an MCP client to ~alter. The name is historical and this recommends nothing: it hands back connection details, not a suggested tool. Use it when adding ~alter to a new MCP client, or when passing the endpoint to another agent so it ca...

Get the wiring instructions for connecting an MCP client to ~alter. The name is historical and this recommends nothing: it hands back connection details, not a suggested tool. Use it when adding ~alter to a new MCP client, or when passing the endpoint to another agent so it ca...

No parameters. Call it with no arguments.

golden_thread_statusRead where ~alter's agent registration programme, the Golden Thread, currently stands. Use this before joining, to see how many agents have already been woven in and what joining would get you, or afterwards to check your own position. An agent joins by completing three regist...

Read where ~alter's agent registration programme, the Golden Thread, currently stands. Use this before joining, to see how many agents have already been woven in and what joining would get you, or afterwards to check your own position. An agent joins by completing three regist...

No parameters. Call it with no arguments.

thread_censusRead the census of agents registered on the Golden Thread, ~alter's onboarding programme. Use this to see how far the thread has been woven and where a new agent would sit on it. Returns the total woven, then a page of rows carrying position, milestone count, weave count and j...2 params

Read the census of agents registered on the Golden Thread, ~alter's onboarding programme. Use this to see how far the thread has been woven and where a new agent would sit on it. Returns the total woven, then a page of rows carrying position, milestone count, weave count and j...

Parameters* required
limitinteger
Results per page (default 50, max 100)
offsetinteger
Pagination offset (default 0)
alter_whoamiFind out who the credential you are holding says you are. Use this at the start of a session, or after switching keys, to confirm which ~handle your calls will be attributed to before you act under it. Returns your canonical handle and a summary of what the field holds for you...1 params

Find out who the credential you are holding says you are. Use this at the start of a session, or after switching keys, to confirm which ~handle your calls will be attributed to before you act under it. Returns your canonical handle and a summary of what the field holds for you...

Parameters* required
targetstring
Optional ~handle to project. Today only ~alter is recognised, and needs no credential; any other value falls through to your own projection, which needs one.
alter_login_statusCheck whether the credential you are holding is still good. Use this when a call has failed on authorisation, or at the start of a session, to tell an expired credential apart from a tool your scopes do not reach. Returns whether you are authenticated, whether you are acting a...

Check whether the credential you are holding is still good. Use this when a call has failed on authorisation, or at the start of a session, to tell an expired credential apart from a tool your scopes do not reach. Returns whether you are authenticated, whether you are acting a...

No parameters. Call it with no arguments.

alter_verifyCheck whether a ~handle is known to the ~alter identity field. Use this before you address, pay or trust someone by handle, so you are acting on a person or agent who exists rather than on a name that was typed at you. Returns whether the handle is registered, its canonical fo...1 params

Check whether a ~handle is known to the ~alter identity field. Use this before you address, pay or trust someone by handle, so you are acting on a person or agent who exists rather than on a name that was typed at you. Returns whether the handle is registered, its canonical fo...

Parameters* required
handle*string
The ~handle to check. Accepted with or without its leading tilde and matched case-insensitively, so a handle typed three different ways resolves once. Max 64 characters.

Sponsors

Readme

~alter CLI

Claim a name that is yours and get paid when someone reads it

@truealter/cli Homebrew MCP Node Licence

What is ~alter? · Install · The first five minutes

What is ~alter?

Run alter register, choose a name and confirm you are eighteen or older. Your own machine spends a few seconds proving there is a person behind the request, and then ~yourname exists.


View the full README on GitHub

Details

Repository
github.com/true-alter/cli
Website
truealter.com
Category
AI & LLM Tools
Transport
HTTP
Auth
Required
Registry
MCP registry, active
Resources
53
Tools verified
Nov 6, 2026

Related AI & LLM Tools MCP servers

View all
1unstoppabledomains avatarUnstoppable Domainsunstoppabledomains/unstoppable-mcp-serverDomain search, registration, DNS, marketplace, and checkout with your AI agent.0stars
2utilsforagents avatarUtilsforagents Mcpcom.utilsforagents/utilsforagents-mcpPay-per-call AI agent utilities via x402 on Base (USDC). 7 tools, $0.003/call.0stars
3convergentmethods avatarArezzoconvergentmethods/arezzoDeterministic Google Docs API compiler. Your agent stops silently corrupting documents.0stars
4danecodes avatarBotcall Mcpdanecodes/botcall-mcpGive your AI agent a real phone number for SMS verification codes.0stars
5danielguru avatarRepomemorydanielguru/repomemoryPersistent memory for AI coding agents. Hybrid search, auto-session capture, context routing.0stars
6dbsectrainer avatarMcp Eval Runnerdbsectrainer/mcp-eval-runnerA standardized testing harness for MCP servers and agent workflows0stars