REST API Reference

The ~alter REST API exposes 76 endpoints across 11 sections for authentication, identity management, Discovery, identity matching, and credential infrastructure. For agent-based access, see the MCP Identity Server.

Base URL

https://mcp.truealter.com/api/v1

All endpoint paths below are relative to this base URL.

Authentication

Endpoints use one of four authentication methods, indicated by the auth badge on each endpoint. For full details, see Authentication:

JWTBearer

Bearer token in the Authorization header. Obtained via /auth/login or /auth/register. Expires after 6 hours; refresh via /auth/refresh.

Capability tokenBearer

The path for agents and programmatic clients. Connect through the OAuth flow and receive a capability token scoped per tool with explicit consent, passed as a bearer credential in the Authorization header.

x402micropayment

HTTP 402-based micropayment protocol. The server returns a 402 response with payment requirements; the client fulfils payment and retries. $0.01–$1.00 per identity query, 75% to data subject.

Publicno auth

No authentication required. Used for registration, login, public archetype exploration, and anonymous discovery entry points.

Pagination

All list endpoints use cursor-based pagination. Pass cursor and limit as query parameters. The response includes a next_cursor field for fetching the next page.

GET /members?limit=20&cursor=eyJpZCI6MTAwfQ==

Default limit varies by endpoint (max 100); see each endpoint's reference. Omit cursor to start from the beginning. When has_more is false, you have reached the last page.

API Sections