Mastercard Developer Hub for FDX APIs FDX Authorization Server

naftiko: 1.0.0-alpha2
info:
  label: Mastercard Developer Hub for FDX APIs FDX Authorization Server
  description: Dynamic Client Registration, Token, Introspection, Authorize API
  tags:
  - Mastercard
  - Developer
  - Hub
  - For
  - Fdx
  - Apis
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: mastercard-developer-hub-for-fdx-apis
    baseUri: http://localhost:8080
    description: Mastercard Developer Hub for FDX APIs FDX Authorization Server HTTP API.
    authentication:
      type: bearer
      token: '{{MASTERCARD_DEVELOPER_HUB_FOR_FDX_APIS_TOKEN}}'
    resources:
    - name: fdx-v6-register
      path: /fdx/v6/register
      operations:
      - name: registerclient
        method: POST
        description: Mastercard Developer Hub for FDX APIs Client Registration Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: oauth2-token
      path: /oauth2/token
      operations:
      - name: gettoken
        method: POST
        description: Mastercard Developer Hub for FDX APIs Get Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: fdx-v6-register-clientid
      path: /fdx/v6/register/{clientId}
      operations:
      - name: getclient
        method: GET
        description: Mastercard Developer Hub for FDX APIs Get Client
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: modifyclient
        method: PUT
        description: Mastercard Developer Hub for FDX APIs Update Client
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteclient
        method: DELETE
        description: Mastercard Developer Hub for FDX APIs Delete Client
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: oauth2-par
      path: /oauth2/par
      operations:
      - name: authorizeviaparrar
        method: POST
        description: Mastercard Developer Hub for FDX APIs Submit an Authorization Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: oauth2-authorize
      path: /oauth2/authorize
      operations:
      - name: parauthorizedonthitcopytheurlfromcurl
        method: GET
        description: Mastercard Developer Hub for FDX APIs User Authorization Endpoint
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: oauth2-introspect
      path: /oauth2/introspect
      operations:
      - name: introspectiontoken
        method: POST
        description: Mastercard Developer Hub for FDX APIs Token Introspection Endpoint
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: mastercard-developer-hub-for-fdx-apis-rest
    description: REST adapter for Mastercard Developer Hub for FDX APIs FDX Authorization Server.
    resources:
    - path: /fdx/v6/register
      name: registerclient
      operations:
      - method: POST
        name: registerclient
        description: Mastercard Developer Hub for FDX APIs Client Registration Request
        call: mastercard-developer-hub-for-fdx-apis.registerclient
        outputParameters:
        - type: object
          mapping: $.
    - path: /oauth2/token
      name: gettoken
      operations:
      - method: POST
        name: gettoken
        description: Mastercard Developer Hub for FDX APIs Get Token
        call: mastercard-developer-hub-for-fdx-apis.gettoken
        outputParameters:
        - type: object
          mapping: $.
    - path: /fdx/v6/register/{clientId}
      name: getclient
      operations:
      - method: GET
        name: getclient
        description: Mastercard Developer Hub for FDX APIs Get Client
        call: mastercard-developer-hub-for-fdx-apis.getclient
        outputParameters:
        - type: object
          mapping: $.
    - path: /fdx/v6/register/{clientId}
      name: modifyclient
      operations:
      - method: PUT
        name: modifyclient
        description: Mastercard Developer Hub for FDX APIs Update Client
        call: mastercard-developer-hub-for-fdx-apis.modifyclient
        outputParameters:
        - type: object
          mapping: $.
    - path: /fdx/v6/register/{clientId}
      name: deleteclient
      operations:
      - method: DELETE
        name: deleteclient
        description: Mastercard Developer Hub for FDX APIs Delete Client
        call: mastercard-developer-hub-for-fdx-apis.deleteclient
        outputParameters:
        - type: object
          mapping: $.
    - path: /oauth2/par
      name: authorizeviaparrar
      operations:
      - method: POST
        name: authorizeviaparrar
        description: Mastercard Developer Hub for FDX APIs Submit an Authorization Request
        call: mastercard-developer-hub-for-fdx-apis.authorizeviaparrar
        outputParameters:
        - type: object
          mapping: $.
    - path: /oauth2/authorize
      name: parauthorizedonthitcopytheurlfromcurl
      operations:
      - method: GET
        name: parauthorizedonthitcopytheurlfromcurl
        description: Mastercard Developer Hub for FDX APIs User Authorization Endpoint
        call: mastercard-developer-hub-for-fdx-apis.parauthorizedonthitcopytheurlfromcurl
        outputParameters:
        - type: object
          mapping: $.
    - path: /oauth2/introspect
      name: introspectiontoken
      operations:
      - method: POST
        name: introspectiontoken
        description: Mastercard Developer Hub for FDX APIs Token Introspection Endpoint
        call: mastercard-developer-hub-for-fdx-apis.introspectiontoken
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: mastercard-developer-hub-for-fdx-apis-mcp
    transport: http
    description: MCP adapter for Mastercard Developer Hub for FDX APIs FDX Authorization Server for AI agent use.
    tools:
    - name: registerclient
      description: Mastercard Developer Hub for FDX APIs Client Registration Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: mastercard-developer-hub-for-fdx-apis.registerclient
      outputParameters:
      - type: object
        mapping: $.
    - name: gettoken
      description: Mastercard Developer Hub for FDX APIs Get Token
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: mastercard-developer-hub-for-fdx-apis.gettoken
      outputParameters:
      - type: object
        mapping: $.
    - name: getclient
      description: Mastercard Developer Hub for FDX APIs Get Client
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: mastercard-developer-hub-for-fdx-apis.getclient
      outputParameters:
      - type: object
        mapping: $.
    - name: modifyclient
      description: Mastercard Developer Hub for FDX APIs Update Client
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: mastercard-developer-hub-for-fdx-apis.modifyclient
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteclient
      description: Mastercard Developer Hub for FDX APIs Delete Client
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: mastercard-developer-hub-for-fdx-apis.deleteclient
      outputParameters:
      - type: object
        mapping: $.
    - name: authorizeviaparrar
      description: Mastercard Developer Hub for FDX APIs Submit an Authorization Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: mastercard-developer-hub-for-fdx-apis.authorizeviaparrar
      outputParameters:
      - type: object
        mapping: $.
    - name: parauthorizedonthitcopytheurlfromcurl
      description: Mastercard Developer Hub for FDX APIs User Authorization Endpoint
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: mastercard-developer-hub-for-fdx-apis.parauthorizedonthitcopytheurlfromcurl
      outputParameters:
      - type: object
        mapping: $.
    - name: introspectiontoken
      description: Mastercard Developer Hub for FDX APIs Token Introspection Endpoint
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: mastercard-developer-hub-for-fdx-apis.introspectiontoken
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    MASTERCARD_DEVELOPER_HUB_FOR_FDX_APIS_TOKEN: MASTERCARD_DEVELOPER_HUB_FOR_FDX_APIS_TOKEN