Skip to main content
API Preview
Developers

Connect your AI client

The way in is a custom connector. In Claude, or another supported client below, add ~alter as a custom connector at https://mcp.truealter.com, sign in through your browser, and choose your ~handle. Choosing your ~handle is how your account is created. Then use your AI as you normally would, and it can read verified identity the same way it reads any other tool. No terminal needed.

Add the connector

  1. In your AI client, open the connector settings and add a custom connector at https://mcp.truealter.com.
  2. Sign in through your browser. Sign-in runs over standards-based OAuth, so the client handles the consent flow and there is nothing to paste.
  3. Choose your ~handle. That choice creates your account on the protocol.
  4. Use your AI as you normally would. The identity tools are now available to it.

The anonymous tools work with no account; signing in reaches the authenticated tools, which settle per call over x402. Prefer to wire a client yourself, or run from the terminal? The per-client cards and the one-command wire below are the deeper paths.

Clients that add a connector with no terminal

These clients add a custom connector from their own settings, with browser sign-in and nothing to paste. Each guide shows the exact steps and states the tiers it works on.

One endpoint, every client

Endpointhttps://mcp.truealter.com/api/v1/mcp
TransportStreamable HTTP (JSON-RPC 2.0 over POST)
Auth headerAuthorization: Bearer <capability_token> (omit for anonymous tools)

Deeper path: wire every client with one command

Working from a terminal? To wire every MCP client on your machine at once, run one command. It detects the clients you have installed (Claude Code, Cursor, Claude Desktop, VS Code) and points each at ~alter, with a provenance record so you can reverse it later.

bash
npx -y @truealter/cli wire

Undo it any time with npx -y @truealter/cli unwire. Prefer to set a single client up by hand? Use the per-client steps below.

Deeper path: developer tools and any MCP client

The command-line tools and editors wire ~alter through a config file rather than a settings panel. Each guide shows the per-client steps, and the last card covers any other MCP client, including Goose and OpenCLAW.

  • Claude Code: One claude mcp add command, or a project .mcp.json entry.
  • Codex CLI: A server block in OpenAI Codex's config.toml.
  • Cursor & Cline: A remote server by url in the editor MCP config.
  • Any MCP client: The mcp-remote bridge, or raw JSON-RPC over HTTP.