Power your agent
The publisher's own URL. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
https://mcp.truealter.com/api/v1/mcpThe Claude button above opens Claude with the name and URL filled in. You still confirm it there.
claude mcp add --transport http com.truealter-identity https://mcp.truealter.com/api/v1/mcpRun in a terminal.
{ "mcpServers": { "com.truealter-identity": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.truealter.com/api/v1/mcp" ] } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchRun 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.
A second before that command there was no you on this protocol, and afterwards there is one that is yours. No browser opened, no password was set, no email address was asked for, and no card was taken.
~alter is what that name resolves to. ~yourname is an address, and behind it
sits a record of what you have actually done. Every command below reads or
writes some part of it, and anything else speaking the protocol resolves the
same address to the same record.
The step is that small, and it is the one everything else here runs from. Agents
you wire on this machine act under the name, so what they do in your stead
carries it. Anybody wanting more of you than the fact you exist pays for it on
terms you set first, and alter queries names each of them and what you kept.
Nothing else in the stack is where a name starts. The website argues the case, the runtime keeps a handle known on your own machine, and the SDK reads one from code you have written. Each of those begins with a name that already exists, and this is the command that makes one.
None of it needs taking on trust. Hand this to the AI you already use and let it take you through in your own words.
Go to truealter.com, find the genesis and the origin
papers, and read all of them. Then start a discussion
with me in my own language, no jargon.
Ask me one question at a time and wait for my answer.
Follow what I am curious about, not the order the site
is written in.
Do not only read the pages. Connect to their interface
directly and call get_started. That tells you where I am
and what comes next, and we work the rest of this from
there.
If I have a ~handle I will give it to you. If I do not
and I decide I want one, set it up with me here.
What I want to understand is what ~Alter is, how it
applies to me, and what it means for everyone else. Find
me somewhere in it, and not the version written for
people who work in technology. Find the life nearest
mine and walk me through it, including what it would
cost me.
Try to prove them wrong. Go and find where they show
their working, and if something is unclear or does not
hold up, say so.
One binary, and every command in it runs under your own handle. Nothing to paste, no key to carry between machines, and no browser step at any point.
It covers six things. Holding a name that is yours and keeping it safe. Deciding who may read you, attribute by attribute. Connecting the sources it reads what you do from. Seeing who looked you up and what each read paid you. Running your agents under your handle, so what they do carries it. Asking the field for somebody when you know nobody who would know them.
Two of those need no account at all. alter audit reads this machine, prints
what ~Alter could learn from it, and stops. alter doctor loom checks a folder
for secrets, bad encoding and broken links, with no network. Both run before you
decide anything.
The rest of this page is the install, and the first five minutes.
Nothing needs setting up first. The installer brings its own Node when the machine has none. Take the line for the shell you are in.
macOS, Linux and WSL
curl -sSf https://truealter.com/install.sh | bash
Windows PowerShell
irm https://truealter.com/install.ps1 | iex
Four things land, and the rest of this section is what does not.
alter command, which is the npm package
@truealter/cli, installed
globally.PATH, so alter is there in every shell you open.~/.local/share/alter/node. Windows installs
Node LTS through winget, or Chocolatey when winget is not there. Node already
here is left alone.install.sh.sha256 and
install.ps1.sha256, so you can check the script before you run it.Nothing runs under sudo. The installer refuses to run as root, because root
would own Node, npm and alter, and you would not be able to run the command at
all. macOS asks for a password once, to link the binary into /usr/local/bin,
and nothing else needs administrator rights on either platform. Nothing lands
outside your home directory.
No account is created and nothing is sent. When the install finishes ~Alter has
read nothing about you or about this machine. alter audit is the first command
that reads anything, and it reads locally. alter register is the first that
creates anything, and you run it yourself.
brew install true-alter/tap/alter
pacman knows about it like
anything else on the machine.paru works the same way, with paru -S truealter-cli.yay -S truealter-cli
PATH handling.npm install -g @truealter/cli
Run alter on its own.
The menu opens on the four commands that turn earning on.
After that there is one command to remember. Start this today, get pulled away,
and come back next week not knowing what is left, and alter status names which
of six steps you are on and what to do next. Those six steps are the sections
below.
Run alter audit.
You have not decided anything yet and want to see what it would read off your own machine first. It reads this machine, prints what ~Alter could learn from it, and stops. Nothing is sent and nothing is created.
Close the terminal here and you are exactly where you started.
Run alter register.
Free, and it asks for no account, no card and no application. Use
alter login instead if the handle is already yours.
Nothing is printed for you to write down. The handle is claimed, a member
credential is minted onto this machine, and the session is stored for you. The
secret worth keeping is the root seed, which alter key device register mints
and shows once, on the run that mints it. Run alter key seed export to see it
again on that machine and alter key seed import to put it on a new one. No
server holds it, so nobody can reissue it for you.
Run alter discovery preview first.
Say you are happy to be found for the trade you do and for nothing else. This prints your record the way a caller would receive it, with the price on that read, before anybody is able to make one.
The levels are set by alter discovery preset recognition. There are four, and
they apply attribute by attribute.
Three presets are the starting points, minimal, recognition and open, and
alter discovery set moves one attribute off whichever you picked.
Run alter pair.
Run it with nothing after it and you get the menu. GitHub, GitLab, Discord,
Mastodon, Bluesky, ORCID, Steam, Lichess, a domain you control, an Obsidian
vault. Naming one, alter pair github, skips the menu. Neither route opens a
browser at you, both hand you a code to type in.
You already do the work somewhere. What comes back is what you did there, not
what you say about it. None of it belongs to the source, so it survives leaving
the source. Use alter connections to list them, alter pair status to see
what each returned, and alter unpair <id> to drop one.
Run alter discovery enable.
Until you run it your handle does not resolve at all. After it, a caller gets
what step 2 allows and nothing else. Running alter discovery disable takes you
back out with the settings intact.
Run alter queries.
You have applied for nothing and somebody has looked you up anyway. Who asked,
what they paid, what you kept. It is the log itself, not a summary of it, and
yours costs nothing to read. Anybody's access ends from here with
alter consent revoke.
Run alter earnings.
The balance moves whether or not you can withdraw yet. Two things open withdrawal, and the readiness line in the menu says where each of them stands.
Your email has to be confirmed, because nothing accrues from a query against an
unconfirmed address, and a payout wallet has to be registered with
alter wallet register. Withdrawal opens at Augmented, the third of four levels,
and the balance keeps building until you reach it.
Run alter wire.
You use one of those every day and would rather not explain who you are to it
every time you open it. It finds the AI harnesses installed here and connects
each of them to the rail. What an agent does in your name then carries your
handle, and turns up in alter queries like any other read.
alter ask is the one to try first. It queries the field by situation instead
of by name, and it costs $1.00 a call, which is the same dollar landing in
somebody else's alter earnings when they are the answer. The whole economy in
one command, seen from both ends.
Somebody messages you offering work and signs off as ~sam, and you want to know
there is a person behind that before you answer. alter verify answers it and
costs nothing. So does alter doctor loom, which reads a folder you are about to
send somebody and tells you a password is not sitting in one of the files.
alter help lists every command, and the interactive menu groups them the same
way.
An accord is where two parties who have never met agree a paid job. Each side has a name, both sign the same terms, what gets done is recorded, and payment lands in USDC on those terms. No company sits in the middle holding the work, the money or the relationship.
alter wire covers the harnesses on your machine. If you would rather connect
something by hand, or you are on a client that reads its own config, point it at
the hosted endpoint:
https://mcp.truealter.com/api/v1/mcp
Codex reads that from its config file. ChatGPT takes it as a custom connector.
The six steps are only the start.
A thread is something you are working towards. You take one on, or one is planted from what the field can already see, or a collective confers one on you. What gets read is the trail you leave while doing it, never a certificate at the end.
A collective holds a record on the same terms you do, and can vouch for its own members. A team, a union, a club or a trade body, one record at every scale.
The runtime keeps your handle known on
this machine without the command line running, and alter help advanced covers
the MCP wiring.
The deep-dives are all in the terminal, at alter help getting-started,
alter help earning, alter help concepts and alter help advanced. None of
them send you to a web page.
npm update -g @truealter/cli
On the Homebrew path it is brew update && brew upgrade alter instead. Either
way you get the current release, and alter --version says which one you are
on.
Run alter doctor first. It checks the install, the session and the
connections, then tells you which one is unhappy.
If it reports a session problem, alter login is the answer. You will never be
asked to create, obtain or paste a token or a key to fix something. If any
message ever tells you to, that is a defect on our side, and it is worth
an issue.
The record formats are open Internet-Drafts, so somebody else's implementation reads and writes the same records this one does without asking us. These are the drafts this repository actually rests on.
Eighteen drafts make up the whole stack. The rest are on the IETF datatracker.
~alter is one identity rail with several ways in, and this command line is the
front door for a person.
This repository is the public home of the released command line, and the npm
release runs from here. The source arrives on a separate branch written by
automation, so a pull request against it cannot be accepted.
Issues are the way to reach us.
Security reports go to [email protected],
never a public issue, and SECURITY.md has the detail.
Apache-2.0, see LICENSE.
~alter is identity infrastructure. Your name is ~yourname and claiming one is free.
© 2026 MCP Directory.
Mint an agent identity in two free calls. Verify anyone. Earn 75% when someone reads you.
{ "mcpServers": { "com.truealter-identity": { "url": "https://mcp.truealter.com/api/v1/mcp", "headers": {} } }}Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
~Alter is reached over HTTP.
Last checked 2026-11-12. Mint an agent identity in two free calls. Verify anyone. Earn 75% when someone reads you.