Frankfurter API — Currencies

naftiko: 1.0.0-alpha2
info:
  label: Frankfurter API — Currencies
  description: 'Frankfurter API — Currencies. 2 operation(s). Lead operation: Frankfurter Get a Single Currency. Self-contained Naftiko capability covering one Frankfurter business surface.'
  tags:
    - Frankfurter
    - Currency Exchange
    - Currencies
  created: '2026-05-29'
  modified: '2026-05-29'
binds: []
capability:
  consumes:
    - type: http
      namespace: v2-currencies
      baseUri: https://api.frankfurter.dev/v2
      description: Frankfurter API — Currencies business capability. Self-contained, no shared references. Public, no authentication required.
      resources:
        - name: currency-code
          path: /currency/{code}
          operations:
            - name: getCurrency
              method: GET
              description: Frankfurter Get a Single Currency
              inputParameters:
                - name: code
                  in: path
                  type: string
                  required: true
                  description: ''
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: currencies
          path: /currencies
          operations:
            - name: getCurrencies
              method: GET
              description: Frankfurter Get Available Currencies
              inputParameters:
                - name: scope
                  in: query
                  type: string
                  required: false
                  description: Set to 'all' to include legacy currencies
                - name: providers
                  in: query
                  type: string
                  required: false
                  description: Comma-separated list of data providers to include
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: rest
      namespace: v2-currencies-rest
      port: 8080
      description: REST adapter for Frankfurter API — Currencies. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/currency/{code}
          name: v1-currency-code
          description: REST surface for Frankfurter Get a Single Currency.
          operations:
            - method: GET
              name: getCurrency
              description: Frankfurter Get a Single Currency
              call: v2-currencies.getCurrency
              with:
                code: rest.code
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/currencies
          name: v1-currencies
          description: REST surface for Frankfurter Get Available Currencies.
          operations:
            - method: GET
              name: getCurrencies
              description: Frankfurter Get Available Currencies
              call: v2-currencies.getCurrencies
              with:
                scope: rest.scope
                providers: rest.providers
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: v2-currencies-mcp
      port: 9090
      transport: http
      description: MCP adapter for Frankfurter API — Currencies. One verb-noun tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: get-single-currency
          description: Frankfurter Get a Single Currency
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: v2-currencies.getCurrency
          with:
            code: tools.code
          outputParameters:
            - type: object
              mapping: $.
        - name: get-available-currencies
          description: Frankfurter Get Available Currencies
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: v2-currencies.getCurrencies
          with:
            scope: tools.scope
            providers: tools.providers
          outputParameters:
            - type: object
              mapping: $.