AgentPMT .well Known API

openapi: 3.2.0
info:
  title: Fast .well Known API
  version: 0.1.0
tags:
- name: .well Known
paths:
  /.well-known/oauth-protected-resource:
    get:
      summary: OAuth protected resource metadata (RFC 9728)
      operationId: protected_resource_metadata__well_known_oauth_protected_resource_get
      responses:
        '200':
          description: Resource metadata for MCP clients.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthProtectedResourceMetadata'
      tags:
      - .well Known
  /.well-known/agent.json:
    get:
      summary: Agent discovery manifest
      operationId: well_known_agent_json__well_known_agent_json_get
      responses:
        '200':
          description: AgentPMT agent discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/agent-card.json:
    get:
      summary: Agent discovery manifest (alias)
      operationId: well_known_agent_card_json__well_known_agent_card_json_get
      responses:
        '200':
          description: AgentPMT agent discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/mcp:
    get:
      summary: MCP discovery manifest
      operationId: well_known_mcp__well_known_mcp_get
      responses:
        '200':
          description: AgentPMT MCP discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/mcp/server.json:
    get:
      summary: MCP server descriptor
      operationId: well_known_mcp_server_json__well_known_mcp_server_json_get
      responses:
        '200':
          description: AgentPMT MCP discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/mcp/server-card.json:
    get:
      summary: MCP server card
      operationId: well_known_mcp_server_card_json__well_known_mcp_server_card_json_get
      responses:
        '200':
          description: AgentPMT MCP discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/x402:
    get:
      summary: x402 payment discovery manifest
      operationId: well_known_x402__well_known_x402_get
      responses:
        '200':
          description: x402 payment protocol discovery metadata
          content:
            application/json:
              schema: {}
      tags:
      - .well Known
    head:
      summary: x402 payment discovery manifest
      operationId: headWellKnownX402
      responses:
        '200':
          description: x402 payment protocol discovery metadata
          content:
            application/json:
              schema: {}
      tags:
      - .well Known
      x-operation-id-source: normalized
      x-operation-id-original: well_known_x402__well_known_x402_get
  /.well-known/x402.json:
    get:
      summary: x402 payment discovery manifest (alias)
      operationId: well_known_x402_json__well_known_x402_json_get
      responses:
        '200':
          description: x402 payment protocol discovery metadata
          content:
            application/json:
              schema: {}
      tags:
      - .well Known
    head:
      summary: x402 payment discovery manifest (alias)
      operationId: headWellKnownX402Json
      responses:
        '200':
          description: x402 payment protocol discovery metadata
          content:
            application/json:
              schema: {}
      tags:
      - .well Known
      x-operation-id-source: normalized
      x-operation-id-original: well_known_x402_json__well_known_x402_json_get
  /.well-known/agents.json:
    get:
      summary: Agent discovery manifest (compatibility alias)
      operationId: _well_known_agent_alias__well_known_agents_json_get
      responses:
        '200':
          description: AgentPMT agent discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/agent-directory.json:
    get:
      summary: Agent discovery manifest (compatibility alias)
      operationId: _well_known_agent_alias__well_known_agent_directory_json_get
      responses:
        '200':
          description: AgentPMT agent discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/mcp.json:
    get:
      summary: MCP discovery manifest (compatibility alias)
      operationId: _well_known_mcp_alias__well_known_mcp_json_get
      responses:
        '200':
          description: AgentPMT MCP discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/glama.json:
    get:
      summary: MCP discovery manifest (compatibility alias)
      operationId: _well_known_mcp_alias__well_known_glama_json_get
      responses:
        '200':
          description: AgentPMT MCP discovery manifest. All aliases return the same shape.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpDiscoveryManifest'
      tags:
      - .well Known
  /.well-known/oauth-protected-resource/{resource_path}:
    get:
      summary: OAuth protected resource metadata for scoped paths (RFC 9728)
      description: 'RFC 9728: Protected resource metadata with path suffix.

        For resource https://example.com/mcp, client requests /.well-known/oauth-protected-resource/mcp

        Supports /mcp, /mcp/support, and /mcp/product/{slug} resource paths.'
      operationId: protected_resource_metadata_with_path__well_known_oauth_protected_resource__resource_path__get
      parameters:
      - name: resource_path
        in: path
        required: true
        schema:
          type: string
          title: Resource Path
      responses:
        '200':
          description: Resource metadata for a scoped resource path (for example `/mcp`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthProtectedResourceMetadata'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - .well Known
  /.well-known/oauth-authorization-server:
    get:
      summary: OAuth authorization server metadata (RFC 8414)
      operationId: oauth_server_metadata__well_known_oauth_authorization_server_get
      responses:
        '200':
          description: Authorization server metadata document.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthAuthorizationServerMetadata'
      tags:
      - .well Known
  /.well-known/openid-configuration:
    get:
      summary: OpenID Connect discovery (alias of oauth-authorization-server)
      operationId: openid_configuration__well_known_openid_configuration_get
      responses:
        '200':
          description: Authorization server metadata document.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthAuthorizationServerMetadata'
      tags:
      - .well Known
  /.well-known/openai-apps-challenge:
    get:
      summary: Openai Apps Challenge
      description: OpenAI domain verification.
      operationId: openai_apps_challenge__well_known_openai_apps_challenge_get
      responses:
        '200':
          description: Successful Response
          content:
            text/plain:
              schema:
                type: string
      tags:
      - .well Known
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    McpDiscoveryManifest:
      properties:
        schema_version:
          type: string
          title: Schema Version
          description: Manifest schema version.
        generated_at:
          type: string
          title: Generated At
          description: ISO-8601 timestamp when the manifest was generated.
        server_name:
          type: string
          title: Server Name
          description: Display name of this MCP server.
        endpoint:
          type: string
          title: Endpoint
          description: MCP endpoint URL.
        authorization:
          $ref: '#/components/schemas/McpDiscoveryAuthorization'
        preferred_autonomous_interface:
          $ref: '#/components/schemas/McpDiscoveryPreferredAutonomous'
        discovery_aliases:
          items:
            type: string
          type: array
          title: Discovery Aliases
          description: Alternate well-known URLs that return an equivalent manifest.
      additionalProperties: true
      type: object
      required:
      - schema_version
      - generated_at
      - server_name
      - endpoint
      - authorization
      - preferred_autonomous_interface
      - discovery_aliases
      title: McpDiscoveryManifest
      description: MCP discovery manifest returned from `/.well-known/mcp` and its aliases.
    AgentDiscoveryInstructionUrls:
      properties:
        canonical:
          anyOf:
          - type: string
          - type: 'null'
          title: Canonical
          description: Canonical agent instructions document (agent-md).
        docs:
          anyOf:
          - type: string
          - type: 'null'
          title: Docs
          description: Human-readable docs entry point.
        llms_txt:
          anyOf:
          - type: string
          - type: 'null'
          title: Llms Txt
          description: llms.txt summary.
        llms_full_txt:
          anyOf:
          - type: string
          - type: 'null'
          title: Llms Full Txt
          description: Full llms-full.txt summary.
        announcements:
          anyOf:
          - type: string
          - type: 'null'
          title: Announcements
          description: Machine-readable announcements feed.
        agent_home:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Home
          description: Agent-oriented landing page.
      additionalProperties: true
      type: object
      title: AgentDiscoveryInstructionUrls
    OAuthProtectedResourceMetadata:
      properties:
        resource:
          type: string
          title: Resource
          description: Canonical resource identifier clients should use as the `aud` claim target.
        authorization_servers:
          items:
            type: string
          type: array
          title: Authorization Servers
          description: Issuer URLs of the authorization servers that mint tokens for this resource.
        scopes_supported:
          items:
            type: string
          type: array
          title: Scopes Supported
          description: OAuth scopes supported by this resource.
      additionalProperties: true
      type: object
      required:
      - resource
      - authorization_servers
      - scopes_supported
      title: OAuthProtectedResourceMetadata
      description: RFC 9728 Protected Resource Metadata response.
    McpDiscoveryAuthorization:
      properties:
        protected_resource_metadata:
          anyOf:
          - type: string
          - type: 'null'
          title: Protected Resource Metadata
        authorization_server_metadata:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization Server Metadata
        openid_configuration:
          anyOf:
          - type: string
          - type: 'null'
          title: Openid Configuration
      additionalProperties: true
      type: object
      title: McpDiscoveryAuthorization
    OAuthAuthorizationServerMetadata:
      properties:
        issuer:
          type: string
          title: Issuer
          description: Issuer identifier URL.
        authorization_endpoint:
          type: string
          title: Authorization Endpoint
          description: Authorization endpoint URL.
        token_endpoint:
          type: string
          title: Token Endpoint
          description: Token endpoint URL.
        jwks_uri:
          type: string
          title: Jwks Uri
          description: JWKS URL for signature verification.
        registration_endpoint:
          anyOf:
          - type: string
          - type: 'null'
          title: Registration Endpoint
          description: Dynamic Client Registration endpoint, when supported.
        response_types_supported:
          items:
            type: string
          type: array
          title: Response Types Supported
          description: Supported OAuth response types.
        grant_types_supported:
          items:
            type: string
          type: array
          title: Grant Types Supported
          description: Supported OAuth grant types.
        token_endpoint_auth_methods_supported:
          items:
            type: string
          type: array
          title: Token Endpoint Auth Methods Supported
          description: Client authentication methods accepted at the token endpoint.
        code_challenge_methods_supported:
          items:
            type: string
          type: array
          title: Code Challenge Methods Supported
          description: PKCE code challenge methods supported.
        scopes_supported:
          items:
            type: string
          type: array
          title: Scopes Supported
          description: OAuth scopes supported by this authorization server.
      additionalProperties: true
      type: object
      required:
      - issuer
      - authorization_endpoint
      - token_endpoint
      - jwks_uri
      - response_types_supported
      - grant_types_supported
      - token_endpoint_auth_methods_supported
      - code_challenge_methods_supported
      - scopes_supported
      title: OAuthAuthorizationServerMetadata
      description: RFC 8414 / OpenID Connect Discovery metadata document.
    McpDiscoveryPreferredAutonomous:
      properties:
        type:
          type: string
          title: Type
          description: Preferred autonomous integration surface.
        payment:
          type: string
          title: Payment
          description: Payment flow associated with the preferred surface.
        agent_card_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Card Url
        canonical_instructions_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Canonical Instructions Url
        docs_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Docs Url
        llms_txt_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Llms Txt Url
      additionalProperties: true
      type: object
      required:
      - type
      - payment
      title: McpDiscoveryPreferredAutonomous
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    AgentDiscoveryManifest:
      properties:
        schema_version:
          type: string
          title: Schema Version
          description: Manifest schema version.
        generated_at:
          type: string
          title: Generated At
          description: ISO-8601 timestamp when the manifest was generated.
        platform:
          type: string
          title: Platform
          description: Platform name (for example `AgentPMT`).
        preferred_interface:
          type: string
          title: Preferred Interface
          description: Preferred integration surface for autonomous agents.
        payment_flow:
          type: string
          title: Payment Flow
          description: Payment flow clients should use.
        instruction_urls:
          $ref: '#/components/schemas/AgentDiscoveryInstructionUrls'
        discovery_aliases:
          items:
            type: string
          type: array
          title: Discovery Aliases
          description: Alternate well-known URLs that return an equivalent manifest.
        external_agent_api:
          additionalProperties: true
          type: object
          title: External Agent Api
          description: Profile of the external-agent-api surface (tool catalog, invoke, session URLs).
        mcp:
          $ref: '#/components/schemas/AgentDiscoveryMcpSection'
      additionalProperties: true
      type: object
      required:
      - schema_version
      - generated_at
      - platform
      - preferred_interface
      - payment_flow
      - instruction_urls
      - discovery_aliases
      - external_agent_api
      - mcp
      title: AgentDiscoveryManifest
      description: Agent discovery manifest returned from `/.well-known/agent.json`.
    AgentDiscoveryMcpSection:
      properties:
        endpoint:
          anyOf:
          - type: string
          - type: 'null'
          title: Endpoint
          description: MCP endpoint URL.
        oauth_protected_resource_metadata:
          anyOf:
          - type: string
          - type: 'null'
          title: Oauth Protected Resource Metadata
        oauth_authorization_server_metadata:
          anyOf:
          - type: string
          - type: 'null'
          title: Oauth Authorization Server Metadata
        openid_configuration:
          anyOf:
          - type: string
          - type: 'null'
          title: Openid Configuration
        note:
          anyOf:
          - type: string
          - type: 'null'
          title: Note
          description: Guidance for autonomous clients (typically points at the x402 flow).
      additionalProperties: true
      type: object
      title: AgentDiscoveryMcpSection
  securitySchemes:
    HTTPBasic:
      type: http
      scheme: basic