openapi: 3.2.0
info:
  title: AI Gateway MCP Server Userinfo API
  description: Universal MCP Gateway with OAuth integration - Modern Architecture
  version: 2.0.3290
tags:
- name: User Info
paths:
  /userinfo:
    get:
      summary: Userinfo
      description: 'OpenID Connect UserInfo for the Bearer token ``/mcp`` accepts.


        The token is validated by the same ``validate_mcp_token`` the MCP

        route uses, but WITHOUT the request headers: a delegation grant

        swaps the resolved identity for a tool call, and a UserInfo answer

        that changed with a header would make one token name two subjects.

        UserInfo states the token''s owner. A rejected token is a 401 Bearer

        challenge (RFC 6750 §3), never a 404, because a relying party reads

        404 as "no such provider".'
      operationId: _userinfo_userinfo_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - User Info
    post:
      summary: Userinfo
      description: 'OpenID Connect UserInfo for the Bearer token ``/mcp`` accepts.


        The token is validated by the same ``validate_mcp_token`` the MCP

        route uses, but WITHOUT the request headers: a delegation grant

        swaps the resolved identity for a tool call, and a UserInfo answer

        that changed with a header would make one token name two subjects.

        UserInfo states the token''s owner. A rejected token is a 401 Bearer

        challenge (RFC 6750 §3), never a 404, because a relying party reads

        404 as "no such provider".'
      operationId: _userinfo_userinfo_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - User Info