For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/auth/register-o-auth-client.md.
Register an OAuth client
POST/oauth/register
Dynamic client registration (RFC 7591). A remote MCP client — Claude,
Meta Muse, MCP Inspector — calls this itself before starting an
authorization flow; none of them can be handed a client_id out of
band.
Registration is open in mechanism and closed in reach: every
redirect_uri must belong to one known client vendor, and a caller
whose callback belongs to none is refused. Clients registered here are
public, use PKCE with S256, and are marked unverified on the consent
screen because their name is self-asserted.
Errors answer in the OAuth envelope (RFC 6749 5.2), not the usual one.
Request
Responses
- 201
- 400
- 500
Client registered
Invalid client metadata, or a redirect_uri belonging to no known
vendor. error is invalid_redirect_uri, invalid_client_metadata
or invalid_scope.
Internal server error