naftiko: 1.0.0-alpha2
info:
  label: "Fireblocks Vaults \u2014 Vaults"
  description: Fireblocks Vaults business capability. 38 operations against the Fireblocks REST API v1.
  tags:
  - Fireblocks
  - Vaults
  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: vaults
    baseUri: https://api.fireblocks.io/v1
    description: Fireblocks Vaults REST capability. JWT-signed using API key + RSA private key.
    resources:
    - name: getvaultaccounts
      path: /vault/accounts
      operations:
      - name: getvaultaccounts
        method: GET
        description: Get vault accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createvaultaccount
      path: /vault/accounts
      operations:
      - name: createvaultaccount
        method: POST
        description: Create a new vault account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: createmultipledepositaddresses
      path: /vault/accounts/addresses/bulk
      operations:
      - name: createmultipledepositaddresses
        method: POST
        description: Bulk creation of new deposit addresses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getcreatemultipledepositaddressesjobstatus
      path: /vault/accounts/addresses/bulk/{jobId}
      operations:
      - name: getcreatemultipledepositaddressesjobstatus
        method: GET
        description: Get the job status of the bulk deposit address creation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createmultipleaccounts
      path: /vault/accounts/bulk/
      operations:
      - name: createmultipleaccounts
        method: POST
        description: Bulk creation of new vault accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getcreatemultiplevaultaccountsjobstatus
      path: /vault/accounts/bulk/{jobId}
      operations:
      - name: getcreatemultiplevaultaccountsjobstatus
        method: GET
        description: Get job status of bulk creation of new vault accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: attachordetachtagsfromvaultaccounts
      path: /vault/accounts/attached_tags
      operations:
      - name: attachordetachtagsfromvaultaccounts
        method: POST
        description: Attach or detach tags from vault accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getpagedvaultaccounts
      path: /vault/accounts_paged
      operations:
      - name: getpagedvaultaccounts
        method: GET
        description: Get vault accounts (Paginated)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getvaultaccount
      path: /vault/accounts/{vaultAccountId}
      operations:
      - name: getvaultaccount
        method: GET
        description: Get a vault account by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: updatevaultaccount
      path: /vault/accounts/{vaultAccountId}
      operations:
      - name: updatevaultaccount
        method: PUT
        description: Rename a vault account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getassetwallets
      path: /vault/asset_wallets
      operations:
      - name: getassetwallets
        method: GET
        description: Get vault wallets (Paginated)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: hidevaultaccount
      path: /vault/accounts/{vaultAccountId}/hide
      operations:
      - name: hidevaultaccount
        method: POST
        description: Hide a vault account in the console
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: unhidevaultaccount
      path: /vault/accounts/{vaultAccountId}/unhide
      operations:
      - name: unhidevaultaccount
        method: POST
        description: Unhide a vault account in the console
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: activateassetforvaultaccount
      path: /vault/accounts/{vaultAccountId}/{assetId}/activate
      operations:
      - name: activateassetforvaultaccount
        method: POST
        description: Activate a wallet in a vault account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: setvaultaccountcustomerrefid
      path: /vault/accounts/{vaultAccountId}/set_customer_ref_id
      operations:
      - name: setvaultaccountcustomerrefid
        method: POST
        description: Set an AML/KYT ID for a vault account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: setvaultaccountautofuel
      path: /vault/accounts/{vaultAccountId}/set_auto_fuel
      operations:
      - name: setvaultaccountautofuel
        method: POST
        description: Set auto fueling to on or off
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getvaultaccountasset
      path: /vault/accounts/{vaultAccountId}/{assetId}
      operations:
      - name: getvaultaccountasset
        method: GET
        description: Get the asset balance for a vault account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createvaultaccountasset
      path: /vault/accounts/{vaultAccountId}/{assetId}
      operations:
      - name: createvaultaccountasset
        method: POST
        description: Create a new vault wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: updatevaultaccountassetbalance
      path: /vault/accounts/{vaultAccountId}/{assetId}/balance
      operations:
      - name: updatevaultaccountassetbalance
        method: POST
        description: Refresh asset balance data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getvaultaccountassetaddresses
      path: /vault/accounts/{vaultAccountId}/{assetId}/addresses
      operations:
      - name: getvaultaccountassetaddresses
        method: GET
        description: Get asset addresses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createvaultaccountassetaddress
      path: /vault/accounts/{vaultAccountId}/{assetId}/addresses
      operations:
      - name: createvaultaccountassetaddress
        method: POST
        description: Create new asset deposit address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getvaultaccountassetaddressespaginated
      path: /vault/accounts/{vaultAccountId}/{assetId}/addresses_paginated
      operations:
      - name: getvaultaccountassetaddressespaginated
        method: GET
        description: Get addresses (Paginated)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getmaxspendableamount
      path: /vault/accounts/{vaultAccountId}/{assetId}/max_spendable_amount
      operations:
      - name: getmaxspendableamount
        method: GET
        description: Get max spendable amount in a transaction
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: updatevaultaccountassetaddress
      path: /vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId}
      operations:
      - name: updatevaultaccountassetaddress
        method: PUT
        description: Update address description
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: setcustomerrefidforaddress
      path: /vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId}/set_customer_ref_id
      operations:
      - name: setcustomerrefidforaddress
        method: POST
        description: Assign AML customer reference ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: createlegacyaddress
      path: /vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId}/create_legacy
      operations:
      - name: createlegacyaddress
        method: POST
        description: Convert a segwit address to legacy format
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getunspentinputs
      path: /vault/accounts/{vaultAccountId}/{assetId}/unspent_inputs
      operations:
      - name: getunspentinputs
        method: GET
        description: Get UTXO unspent inputs information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getpublickeyinfo
      path: /vault/public_key_info
      operations:
      - name: getpublickeyinfo
        method: GET
        description: Get the public key for a derivation path
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getpublickeyinfoforaddress
      path: /vault/accounts/{vaultAccountId}/{assetId}/{change}/{addressIndex}/public_key_info
      operations:
      - name: getpublickeyinfoforaddress
        method: GET
        description: Get an asset's public key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: attachtagstovaultaccounts
      path: /vault/accounts/attached/tags/attach
      operations:
      - name: attachtagstovaultaccounts
        method: POST
        description: Attach tags to a vault accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: detachtagsfromvaultaccounts
      path: /vault/accounts/attached/tags/detached
      operations:
      - name: detachtagsfromvaultaccounts
        method: POST
        description: Detach tags from a vault accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getvaultassets
      path: /vault/assets
      operations:
      - name: getvaultassets
        method: GET
        description: Get asset balance for chosen assets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getvaultbalancebyasset
      path: /vault/assets/{assetId}
      operations:
      - name: getvaultbalancebyasset
        method: GET
        description: Get vault balance by an asset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createtag
      path: /tags
      operations:
      - name: createtag
        method: POST
        description: Create a tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: gettags
      path: /tags
      operations:
      - name: gettags
        method: GET
        description: Get list of tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: gettag
      path: /tags/{tagId}
      operations:
      - name: gettag
        method: GET
        description: Get a tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: updatetag
      path: /tags/{tagId}
      operations:
      - name: updatetag
        method: PATCH
        description: Update a tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deletetag
      path: /tags/{tagId}
      operations:
      - name: deletetag
        method: DELETE
        description: Delete a tag
        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: vaults-rest
    port: 8080
    description: REST adapter for Fireblocks Vaults.
    resources:
    - path: /v1/vault/accounts
      name: getvaultaccounts
      description: Get vault accounts
      operations:
      - method: GET
        name: getvaultaccounts
        description: Get vault accounts
        call: vaults.getvaultaccounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts
      name: createvaultaccount
      description: Create a new vault account
      operations:
      - method: POST
        name: createvaultaccount
        description: Create a new vault account
        call: vaults.createvaultaccount
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/addresses/bulk
      name: createmultipledepositaddresses
      description: Bulk creation of new deposit addresses
      operations:
      - method: POST
        name: createmultipledepositaddresses
        description: Bulk creation of new deposit addresses
        call: vaults.createmultipledepositaddresses
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/addresses/bulk/{jobId}
      name: getcreatemultipledepositaddressesjobstatus
      description: Get the job status of the bulk deposit address creation
      operations:
      - method: GET
        name: getcreatemultipledepositaddressesjobstatus
        description: Get the job status of the bulk deposit address creation
        call: vaults.getcreatemultipledepositaddressesjobstatus
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/bulk/
      name: createmultipleaccounts
      description: Bulk creation of new vault accounts
      operations:
      - method: POST
        name: createmultipleaccounts
        description: Bulk creation of new vault accounts
        call: vaults.createmultipleaccounts
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/bulk/{jobId}
      name: getcreatemultiplevaultaccountsjobstatus
      description: Get job status of bulk creation of new vault accounts
      operations:
      - method: GET
        name: getcreatemultiplevaultaccountsjobstatus
        description: Get job status of bulk creation of new vault accounts
        call: vaults.getcreatemultiplevaultaccountsjobstatus
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/attached_tags
      name: attachordetachtagsfromvaultaccounts
      description: Attach or detach tags from vault accounts
      operations:
      - method: POST
        name: attachordetachtagsfromvaultaccounts
        description: Attach or detach tags from vault accounts
        call: vaults.attachordetachtagsfromvaultaccounts
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts_paged
      name: getpagedvaultaccounts
      description: Get vault accounts (Paginated)
      operations:
      - method: GET
        name: getpagedvaultaccounts
        description: Get vault accounts (Paginated)
        call: vaults.getpagedvaultaccounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/{vaultAccountId}
      name: getvaultaccount
      description: Get a vault account by ID
      operations:
      - method: GET
        name: getvaultaccount
        description: Get a vault account by ID
        call: vaults.getvaultaccount
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/{vaultAccountId}
      name: updatevaultaccount
      description: Rename a vault account
      operations:
      - method: PUT
        name: updatevaultaccount
        description: Rename a vault account
        call: vaults.updatevaultaccount
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/asset_wallets
      name: getassetwallets
      description: Get vault wallets (Paginated)
      operations:
      - method: GET
        name: getassetwallets
        description: Get vault wallets (Paginated)
        call: vaults.getassetwallets
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/{vaultAccountId}/hide
      name: hidevaultaccount
      description: Hide a vault account in the console
      operations:
      - method: POST
        name: hidevaultaccount
        description: Hide a vault account in the console
        call: vaults.hidevaultaccount
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/unhide
      name: unhidevaultaccount
      description: Unhide a vault account in the console
      operations:
      - method: POST
        name: unhidevaultaccount
        description: Unhide a vault account in the console
        call: vaults.unhidevaultaccount
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/activate
      name: activateassetforvaultaccount
      description: Activate a wallet in a vault account
      operations:
      - method: POST
        name: activateassetforvaultaccount
        description: Activate a wallet in a vault account
        call: vaults.activateassetforvaultaccount
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/set_customer_ref_id
      name: setvaultaccountcustomerrefid
      description: Set an AML/KYT ID for a vault account
      operations:
      - method: POST
        name: setvaultaccountcustomerrefid
        description: Set an AML/KYT ID for a vault account
        call: vaults.setvaultaccountcustomerrefid
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/set_auto_fuel
      name: setvaultaccountautofuel
      description: Set auto fueling to on or off
      operations:
      - method: POST
        name: setvaultaccountautofuel
        description: Set auto fueling to on or off
        call: vaults.setvaultaccountautofuel
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}
      name: getvaultaccountasset
      description: Get the asset balance for a vault account
      operations:
      - method: GET
        name: getvaultaccountasset
        description: Get the asset balance for a vault account
        call: vaults.getvaultaccountasset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}
      name: createvaultaccountasset
      description: Create a new vault wallet
      operations:
      - method: POST
        name: createvaultaccountasset
        description: Create a new vault wallet
        call: vaults.createvaultaccountasset
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/balance
      name: updatevaultaccountassetbalance
      description: Refresh asset balance data
      operations:
      - method: POST
        name: updatevaultaccountassetbalance
        description: Refresh asset balance data
        call: vaults.updatevaultaccountassetbalance
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/addresses
      name: getvaultaccountassetaddresses
      description: Get asset addresses
      operations:
      - method: GET
        name: getvaultaccountassetaddresses
        description: Get asset addresses
        call: vaults.getvaultaccountassetaddresses
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/addresses
      name: createvaultaccountassetaddress
      description: Create new asset deposit address
      operations:
      - method: POST
        name: createvaultaccountassetaddress
        description: Create new asset deposit address
        call: vaults.createvaultaccountassetaddress
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/addresses_paginated
      name: getvaultaccountassetaddressespaginated
      description: Get addresses (Paginated)
      operations:
      - method: GET
        name: getvaultaccountassetaddressespaginated
        description: Get addresses (Paginated)
        call: vaults.getvaultaccountassetaddressespaginated
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/max_spendable_amount
      name: getmaxspendableamount
      description: Get max spendable amount in a transaction
      operations:
      - method: GET
        name: getmaxspendableamount
        description: Get max spendable amount in a transaction
        call: vaults.getmaxspendableamount
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId}
      name: updatevaultaccountassetaddress
      description: Update address description
      operations:
      - method: PUT
        name: updatevaultaccountassetaddress
        description: Update address description
        call: vaults.updatevaultaccountassetaddress
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId}/set_customer_ref_id
      name: setcustomerrefidforaddress
      description: Assign AML customer reference ID
      operations:
      - method: POST
        name: setcustomerrefidforaddress
        description: Assign AML customer reference ID
        call: vaults.setcustomerrefidforaddress
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/addresses/{addressId}/create_legacy
      name: createlegacyaddress
      description: Convert a segwit address to legacy format
      operations:
      - method: POST
        name: createlegacyaddress
        description: Convert a segwit address to legacy format
        call: vaults.createlegacyaddress
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/unspent_inputs
      name: getunspentinputs
      description: Get UTXO unspent inputs information
      operations:
      - method: GET
        name: getunspentinputs
        description: Get UTXO unspent inputs information
        call: vaults.getunspentinputs
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/public_key_info
      name: getpublickeyinfo
      description: Get the public key for a derivation path
      operations:
      - method: GET
        name: getpublickeyinfo
        description: Get the public key for a derivation path
        call: vaults.getpublickeyinfo
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/{vaultAccountId}/{assetId}/{change}/{addressIndex}/public_key_info
      name: getpublickeyinfoforaddress
      description: Get an asset's public key
      operations:
      - method: GET
        name: getpublickeyinfoforaddress
        description: Get an asset's public key
        call: vaults.getpublickeyinfoforaddress
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/accounts/attached/tags/attach
      name: attachtagstovaultaccounts
      description: Attach tags to a vault accounts
      operations:
      - method: POST
        name: attachtagstovaultaccounts
        description: Attach tags to a vault accounts
        call: vaults.attachtagstovaultaccounts
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/accounts/attached/tags/detached
      name: detachtagsfromvaultaccounts
      description: Detach tags from a vault accounts
      operations:
      - method: POST
        name: detachtagsfromvaultaccounts
        description: Detach tags from a vault accounts
        call: vaults.detachtagsfromvaultaccounts
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/vault/assets
      name: getvaultassets
      description: Get asset balance for chosen assets
      operations:
      - method: GET
        name: getvaultassets
        description: Get asset balance for chosen assets
        call: vaults.getvaultassets
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vault/assets/{assetId}
      name: getvaultbalancebyasset
      description: Get vault balance by an asset
      operations:
      - method: GET
        name: getvaultbalancebyasset
        description: Get vault balance by an asset
        call: vaults.getvaultbalancebyasset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tags
      name: createtag
      description: Create a tag
      operations:
      - method: POST
        name: createtag
        description: Create a tag
        call: vaults.createtag
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/tags
      name: gettags
      description: Get list of tags
      operations:
      - method: GET
        name: gettags
        description: Get list of tags
        call: vaults.gettags
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tags/{tagId}
      name: gettag
      description: Get a tag
      operations:
      - method: GET
        name: gettag
        description: Get a tag
        call: vaults.gettag
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tags/{tagId}
      name: updatetag
      description: Update a tag
      operations:
      - method: PATCH
        name: updatetag
        description: Update a tag
        call: vaults.updatetag
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/tags/{tagId}
      name: deletetag
      description: Delete a tag
      operations:
      - method: DELETE
        name: deletetag
        description: Delete a tag
        call: vaults.deletetag
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: vaults-mcp
    port: 9090
    transport: http
    description: MCP adapter for Fireblocks Vaults. One tool per consumed operation.
    tools:
    - name: fireblocks-getvaultaccounts
      description: Get vault accounts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getvaultaccounts
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createvaultaccount
      description: Create a new vault account
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.createvaultaccount
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-createmultipledepositaddresses
      description: Bulk creation of new deposit addresses
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.createmultipledepositaddresses
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getcreatemultipledepositaddressesjobstatus
      description: Get the job status of the bulk deposit address creation
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getcreatemultipledepositaddressesjobstatus
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createmultipleaccounts
      description: Bulk creation of new vault accounts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.createmultipleaccounts
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getcreatemultiplevaultaccountsjobstatus
      description: Get job status of bulk creation of new vault accounts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getcreatemultiplevaultaccountsjobstatus
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-attachordetachtagsfromvaultaccounts
      description: Attach or detach tags from vault accounts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.attachordetachtagsfromvaultaccounts
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getpagedvaultaccounts
      description: Get vault accounts (Paginated)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getpagedvaultaccounts
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getvaultaccount
      description: Get a vault account by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getvaultaccount
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-updatevaultaccount
      description: Rename a vault account
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: vaults.updatevaultaccount
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getassetwallets
      description: Get vault wallets (Paginated)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getassetwallets
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-hidevaultaccount
      description: Hide a vault account in the console
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.hidevaultaccount
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-unhidevaultaccount
      description: Unhide a vault account in the console
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.unhidevaultaccount
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-activateassetforvaultaccount
      description: Activate a wallet in a vault account
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.activateassetforvaultaccount
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-setvaultaccountcustomerrefid
      description: Set an AML/KYT ID for a vault account
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.setvaultaccountcustomerrefid
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-setvaultaccountautofuel
      description: Set auto fueling to on or off
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.setvaultaccountautofuel
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getvaultaccountasset
      description: Get the asset balance for a vault account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getvaultaccountasset
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createvaultaccountasset
      description: Create a new vault wallet
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.createvaultaccountasset
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-updatevaultaccountassetbalance
      description: Refresh asset balance data
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.updatevaultaccountassetbalance
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getvaultaccountassetaddresses
      description: Get asset addresses
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getvaultaccountassetaddresses
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createvaultaccountassetaddress
      description: Create new asset deposit address
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.createvaultaccountassetaddress
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getvaultaccountassetaddressespaginated
      description: Get addresses (Paginated)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getvaultaccountassetaddressespaginated
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getmaxspendableamount
      description: Get max spendable amount in a transaction
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getmaxspendableamount
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-updatevaultaccountassetaddress
      description: Update address description
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: vaults.updatevaultaccountassetaddress
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-setcustomerrefidforaddress
      description: Assign AML customer reference ID
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.setcustomerrefidforaddress
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-createlegacyaddress
      description: Convert a segwit address to legacy format
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.createlegacyaddress
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getunspentinputs
      description: Get UTXO unspent inputs information
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getunspentinputs
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getpublickeyinfo
      description: Get the public key for a derivation path
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getpublickeyinfo
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getpublickeyinfoforaddress
      description: Get an asset's public key
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getpublickeyinfoforaddress
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-attachtagstovaultaccounts
      description: Attach tags to a vault accounts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.attachtagstovaultaccounts
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-detachtagsfromvaultaccounts
      description: Detach tags from a vault accounts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.detachtagsfromvaultaccounts
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getvaultassets
      description: Get asset balance for chosen assets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getvaultassets
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getvaultbalancebyasset
      description: Get vault balance by an asset
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.getvaultbalancebyasset
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createtag
      description: Create a tag
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.createtag
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-gettags
      description: Get list of tags
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.gettags
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-gettag
      description: Get a tag
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: vaults.gettag
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-updatetag
      description: Update a tag
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: vaults.updatetag
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-deletetag
      description: Delete a tag
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: vaults.deletetag
      outputParameters:
      - type: object
        mapping: $.