Fireblocks Tokenization — Tokenization

naftiko: 1.0.0-alpha2
info:
  label: "Fireblocks Tokenization \u2014 Tokenization"
  description: Fireblocks Tokenization business capability. 12 operations against the Fireblocks REST API v1.
  tags:
  - Fireblocks
  - Tokenization
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    FIREBLOCKS_API_KEY: FIREBLOCKS_API_KEY
    FIREBLOCKS_API_SECRET: FIREBLOCKS_API_SECRET
capability:
  consumes:
  - type: http
    namespace: tokenization
    baseUri: https://api.fireblocks.io/v1
    description: Fireblocks Tokenization REST capability. JWT-signed using API key + RSA private key.
    resources:
    - name: issuenewtoken
      path: /tokenization/tokens
      operations:
      - name: issuenewtoken
        method: POST
        description: Issue a new token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getlinkedtokens
      path: /tokenization/tokens
      operations:
      - name: getlinkedtokens
        method: GET
        description: List all linked tokens
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: link
      path: /tokenization/tokens/link
      operations:
      - name: link
        method: POST
        description: Link a contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: createnewcollection
      path: /tokenization/collections
      operations:
      - name: createnewcollection
        method: POST
        description: Create a new collection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getlinkedcollections
      path: /tokenization/collections
      operations:
      - name: getlinkedcollections
        method: GET
        description: Get collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getcollectionbyid
      path: /tokenization/collections/{id}
      operations:
      - name: getcollectionbyid
        method: GET
        description: Get a collection by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: unlinkcollection
      path: /tokenization/collections/{id}
      operations:
      - name: unlinkcollection
        method: DELETE
        description: Delete a collection link
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: fetchcollectiontokendetails
      path: /tokenization/collections/{id}/tokens/{tokenId}
      operations:
      - name: fetchcollectiontokendetails
        method: GET
        description: Get collection token details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: mintcollectiontoken
      path: /tokenization/collections/{id}/tokens/mint
      operations:
      - name: mintcollectiontoken
        method: POST
        description: Mint tokens
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: burncollectiontoken
      path: /tokenization/collections/{id}/tokens/burn
      operations:
      - name: burncollectiontoken
        method: POST
        description: Burn tokens
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: unlink
      path: /tokenization/tokens/{id}
      operations:
      - name: unlink
        method: DELETE
        description: Unlink a token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getlinkedtoken
      path: /tokenization/tokens/{id}
      operations:
      - name: getlinkedtoken
        method: GET
        description: Return a linked token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.FIREBLOCKS_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: tokenization-rest
    port: 8080
    description: REST adapter for Fireblocks Tokenization.
    resources:
    - path: /v1/tokenization/tokens
      name: issuenewtoken
      description: Issue a new token
      operations:
      - method: POST
        name: issuenewtoken
        description: Issue a new token
        call: tokenization.issuenewtoken
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/tokenization/tokens
      name: getlinkedtokens
      description: List all linked tokens
      operations:
      - method: GET
        name: getlinkedtokens
        description: List all linked tokens
        call: tokenization.getlinkedtokens
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tokenization/tokens/link
      name: link
      description: Link a contract
      operations:
      - method: POST
        name: link
        description: Link a contract
        call: tokenization.link
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/tokenization/collections
      name: createnewcollection
      description: Create a new collection
      operations:
      - method: POST
        name: createnewcollection
        description: Create a new collection
        call: tokenization.createnewcollection
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/tokenization/collections
      name: getlinkedcollections
      description: Get collections
      operations:
      - method: GET
        name: getlinkedcollections
        description: Get collections
        call: tokenization.getlinkedcollections
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tokenization/collections/{id}
      name: getcollectionbyid
      description: Get a collection by id
      operations:
      - method: GET
        name: getcollectionbyid
        description: Get a collection by id
        call: tokenization.getcollectionbyid
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tokenization/collections/{id}
      name: unlinkcollection
      description: Delete a collection link
      operations:
      - method: DELETE
        name: unlinkcollection
        description: Delete a collection link
        call: tokenization.unlinkcollection
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tokenization/collections/{id}/tokens/{tokenId}
      name: fetchcollectiontokendetails
      description: Get collection token details
      operations:
      - method: GET
        name: fetchcollectiontokendetails
        description: Get collection token details
        call: tokenization.fetchcollectiontokendetails
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tokenization/collections/{id}/tokens/mint
      name: mintcollectiontoken
      description: Mint tokens
      operations:
      - method: POST
        name: mintcollectiontoken
        description: Mint tokens
        call: tokenization.mintcollectiontoken
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/tokenization/collections/{id}/tokens/burn
      name: burncollectiontoken
      description: Burn tokens
      operations:
      - method: POST
        name: burncollectiontoken
        description: Burn tokens
        call: tokenization.burncollectiontoken
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/tokenization/tokens/{id}
      name: unlink
      description: Unlink a token
      operations:
      - method: DELETE
        name: unlink
        description: Unlink a token
        call: tokenization.unlink
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tokenization/tokens/{id}
      name: getlinkedtoken
      description: Return a linked token
      operations:
      - method: GET
        name: getlinkedtoken
        description: Return a linked token
        call: tokenization.getlinkedtoken
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: tokenization-mcp
    port: 9090
    transport: http
    description: MCP adapter for Fireblocks Tokenization. One tool per consumed operation.
    tools:
    - name: fireblocks-issuenewtoken
      description: Issue a new token
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: tokenization.issuenewtoken
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getlinkedtokens
      description: List all linked tokens
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tokenization.getlinkedtokens
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-link
      description: Link a contract
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: tokenization.link
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-createnewcollection
      description: Create a new collection
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: tokenization.createnewcollection
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getlinkedcollections
      description: Get collections
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tokenization.getlinkedcollections
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getcollectionbyid
      description: Get a collection by id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tokenization.getcollectionbyid
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-unlinkcollection
      description: Delete a collection link
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: tokenization.unlinkcollection
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-fetchcollectiontokendetails
      description: Get collection token details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tokenization.fetchcollectiontokendetails
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-mintcollectiontoken
      description: Mint tokens
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: tokenization.mintcollectiontoken
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-burncollectiontoken
      description: Burn tokens
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: tokenization.burncollectiontoken
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-unlink
      description: Unlink a token
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: tokenization.unlink
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getlinkedtoken
      description: Return a linked token
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tokenization.getlinkedtoken
      outputParameters:
      - type: object
        mapping: $.