Skip to main content
API Preview
Developers

No terminal? In Claude, ChatGPT, Le Chat, or Perplexity, add ~alter as a custom connector at https://mcp.truealter.com, sign in through your browser, and choose your ~handle. That is the way in, and it creates your account. See the connector steps. The command-line wiring below is the deeper path for Claude Code sessions.

Claude Code

Wire ~alter as a remote MCP server in Claude Code, then call identity tools from any session. The no-terminal way in is the custom connector above; this command-line path suits a Claude Code session. Anonymous tools work with no account; connect via OAuth to reach the authenticated tools.

Connection

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

Setup

1Add the server

Run this once. Drop the --header flag to use only the anonymous tools. Claude Code can also negotiate the OAuth connect flow on first authenticated call, prompting you to grant consent and storing the capability token for you.

bash
claude mcp add --transport http alter https://mcp.truealter.com/api/v1/mcp \
  --header "Authorization: Bearer <capability_token>"

2Or configure it for a project

Commit this to .mcp.json at the repository root to share the server with your team.

json
{
  "mcpServers": {
    "alter": {
      "type": "streamable-http",
      "url": "https://mcp.truealter.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <capability_token>"
      }
    }
  }
}

Verify

List your MCP servers, or run /mcp inside a session. ~alter should report as connected with its tool count.

bash
claude mcp list

Notes

  • -The CLI flag is --transport http; the .mcp.json key is "type": "streamable-http". Both select the same Streamable HTTP transport.
  • -Anonymous access covers every public tool. The authenticated tools need the OAuth-bearer capability token in the header and settle per call over x402.
Claude Code · Connect your agent · Docs