Fireblocks Wallets — Wallets

naftiko: 1.0.0-alpha2
info:
  label: "Fireblocks Wallets \u2014 Wallets"
  description: Fireblocks Wallets business capability. 24 operations against the Fireblocks REST API v1.
  tags:
  - Fireblocks
  - Wallets
  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: wallets
    baseUri: https://api.fireblocks.io/v1
    description: Fireblocks Wallets REST capability. JWT-signed using API key + RSA private key.
    resources:
    - name: getinternalwallets
      path: /internal_wallets
      operations:
      - name: getinternalwallets
        method: GET
        description: List internal wallets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createinternalwallet
      path: /internal_wallets
      operations:
      - name: createinternalwallet
        method: POST
        description: Create an internal wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getinternalwallet
      path: /internal_wallets/{walletId}
      operations:
      - name: getinternalwallet
        method: GET
        description: Get assets for internal wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deleteinternalwallet
      path: /internal_wallets/{walletId}
      operations:
      - name: deleteinternalwallet
        method: DELETE
        description: Delete an internal wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getinternalwalletassetspaginated
      path: /internal_wallets/{walletId}/assets
      operations:
      - name: getinternalwalletassetspaginated
        method: GET
        description: List assets in an internal wallet (Paginated)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: setcustomerrefidforinternalwallet
      path: /internal_wallets/{walletId}/set_customer_ref_id
      operations:
      - name: setcustomerrefidforinternalwallet
        method: POST
        description: Set an AML/KYT customer reference ID for internal wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getinternalwalletasset
      path: /internal_wallets/{walletId}/{assetId}
      operations:
      - name: getinternalwalletasset
        method: GET
        description: Get an asset from an internal wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createinternalwalletasset
      path: /internal_wallets/{walletId}/{assetId}
      operations:
      - name: createinternalwalletasset
        method: POST
        description: Add an asset to an internal wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deleteinternalwalletasset
      path: /internal_wallets/{walletId}/{assetId}
      operations:
      - name: deleteinternalwalletasset
        method: DELETE
        description: Delete a whitelisted address
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getexternalwallets
      path: /external_wallets
      operations:
      - name: getexternalwallets
        method: GET
        description: List external wallets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createexternalwallet
      path: /external_wallets
      operations:
      - name: createexternalwallet
        method: POST
        description: Create an external wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getexternalwallet
      path: /external_wallets/{walletId}
      operations:
      - name: getexternalwallet
        method: GET
        description: Find an external wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deleteexternalwallet
      path: /external_wallets/{walletId}
      operations:
      - name: deleteexternalwallet
        method: DELETE
        description: Delete an external wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: setexternalwalletcustomerrefid
      path: /external_wallets/{walletId}/set_customer_ref_id
      operations:
      - name: setexternalwalletcustomerrefid
        method: POST
        description: Set an AML customer reference ID for an external wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getexternalwalletasset
      path: /external_wallets/{walletId}/{assetId}
      operations:
      - name: getexternalwalletasset
        method: GET
        description: Get an asset from an external wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: addassettoexternalwallet
      path: /external_wallets/{walletId}/{assetId}
      operations:
      - name: addassettoexternalwallet
        method: POST
        description: Add an asset to an external wallet.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: removeassetfromexternalwallet
      path: /external_wallets/{walletId}/{assetId}
      operations:
      - name: removeassetfromexternalwallet
        method: DELETE
        description: Delete an asset from an external wallet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getcontracts
      path: /contracts
      operations:
      - name: getcontracts
        method: GET
        description: List Whitelisted Contracts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: createcontract
      path: /contracts
      operations:
      - name: createcontract
        method: POST
        description: Create a Whitelisted Contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: getcontract
      path: /contracts/{contractId}
      operations:
      - name: getcontract
        method: GET
        description: Find a Specific Whitelisted Contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deletecontract
      path: /contracts/{contractId}
      operations:
      - name: deletecontract
        method: DELETE
        description: Delete a Whitelisted Contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: getcontractasset
      path: /contracts/{contractId}/{assetId}
      operations:
      - name: getcontractasset
        method: GET
        description: Find a whitelisted contract's asset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: addcontractasset
      path: /contracts/{contractId}/{assetId}
      operations:
      - name: addcontractasset
        method: POST
        description: Add an Asset to a Whitelisted Contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deletecontractasset
      path: /contracts/{contractId}/{assetId}
      operations:
      - name: deletecontractasset
        method: DELETE
        description: Delete a Whitelisted Contract's Asset
        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: wallets-rest
    port: 8080
    description: REST adapter for Fireblocks Wallets.
    resources:
    - path: /v1/internal_wallets
      name: getinternalwallets
      description: List internal wallets
      operations:
      - method: GET
        name: getinternalwallets
        description: List internal wallets
        call: wallets.getinternalwallets
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal_wallets
      name: createinternalwallet
      description: Create an internal wallet
      operations:
      - method: POST
        name: createinternalwallet
        description: Create an internal wallet
        call: wallets.createinternalwallet
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/internal_wallets/{walletId}
      name: getinternalwallet
      description: Get assets for internal wallet
      operations:
      - method: GET
        name: getinternalwallet
        description: Get assets for internal wallet
        call: wallets.getinternalwallet
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal_wallets/{walletId}
      name: deleteinternalwallet
      description: Delete an internal wallet
      operations:
      - method: DELETE
        name: deleteinternalwallet
        description: Delete an internal wallet
        call: wallets.deleteinternalwallet
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal_wallets/{walletId}/assets
      name: getinternalwalletassetspaginated
      description: List assets in an internal wallet (Paginated)
      operations:
      - method: GET
        name: getinternalwalletassetspaginated
        description: List assets in an internal wallet (Paginated)
        call: wallets.getinternalwalletassetspaginated
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal_wallets/{walletId}/set_customer_ref_id
      name: setcustomerrefidforinternalwallet
      description: Set an AML/KYT customer reference ID for internal wallet
      operations:
      - method: POST
        name: setcustomerrefidforinternalwallet
        description: Set an AML/KYT customer reference ID for internal wallet
        call: wallets.setcustomerrefidforinternalwallet
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/internal_wallets/{walletId}/{assetId}
      name: getinternalwalletasset
      description: Get an asset from an internal wallet
      operations:
      - method: GET
        name: getinternalwalletasset
        description: Get an asset from an internal wallet
        call: wallets.getinternalwalletasset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal_wallets/{walletId}/{assetId}
      name: createinternalwalletasset
      description: Add an asset to an internal wallet
      operations:
      - method: POST
        name: createinternalwalletasset
        description: Add an asset to an internal wallet
        call: wallets.createinternalwalletasset
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/internal_wallets/{walletId}/{assetId}
      name: deleteinternalwalletasset
      description: Delete a whitelisted address
      operations:
      - method: DELETE
        name: deleteinternalwalletasset
        description: Delete a whitelisted address
        call: wallets.deleteinternalwalletasset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external_wallets
      name: getexternalwallets
      description: List external wallets
      operations:
      - method: GET
        name: getexternalwallets
        description: List external wallets
        call: wallets.getexternalwallets
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external_wallets
      name: createexternalwallet
      description: Create an external wallet
      operations:
      - method: POST
        name: createexternalwallet
        description: Create an external wallet
        call: wallets.createexternalwallet
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/external_wallets/{walletId}
      name: getexternalwallet
      description: Find an external wallet
      operations:
      - method: GET
        name: getexternalwallet
        description: Find an external wallet
        call: wallets.getexternalwallet
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external_wallets/{walletId}
      name: deleteexternalwallet
      description: Delete an external wallet
      operations:
      - method: DELETE
        name: deleteexternalwallet
        description: Delete an external wallet
        call: wallets.deleteexternalwallet
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external_wallets/{walletId}/set_customer_ref_id
      name: setexternalwalletcustomerrefid
      description: Set an AML customer reference ID for an external wallet
      operations:
      - method: POST
        name: setexternalwalletcustomerrefid
        description: Set an AML customer reference ID for an external wallet
        call: wallets.setexternalwalletcustomerrefid
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/external_wallets/{walletId}/{assetId}
      name: getexternalwalletasset
      description: Get an asset from an external wallet
      operations:
      - method: GET
        name: getexternalwalletasset
        description: Get an asset from an external wallet
        call: wallets.getexternalwalletasset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external_wallets/{walletId}/{assetId}
      name: addassettoexternalwallet
      description: Add an asset to an external wallet.
      operations:
      - method: POST
        name: addassettoexternalwallet
        description: Add an asset to an external wallet.
        call: wallets.addassettoexternalwallet
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/external_wallets/{walletId}/{assetId}
      name: removeassetfromexternalwallet
      description: Delete an asset from an external wallet
      operations:
      - method: DELETE
        name: removeassetfromexternalwallet
        description: Delete an asset from an external wallet
        call: wallets.removeassetfromexternalwallet
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/contracts
      name: getcontracts
      description: List Whitelisted Contracts
      operations:
      - method: GET
        name: getcontracts
        description: List Whitelisted Contracts
        call: wallets.getcontracts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/contracts
      name: createcontract
      description: Create a Whitelisted Contract
      operations:
      - method: POST
        name: createcontract
        description: Create a Whitelisted Contract
        call: wallets.createcontract
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/contracts/{contractId}
      name: getcontract
      description: Find a Specific Whitelisted Contract
      operations:
      - method: GET
        name: getcontract
        description: Find a Specific Whitelisted Contract
        call: wallets.getcontract
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/contracts/{contractId}
      name: deletecontract
      description: Delete a Whitelisted Contract
      operations:
      - method: DELETE
        name: deletecontract
        description: Delete a Whitelisted Contract
        call: wallets.deletecontract
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/contracts/{contractId}/{assetId}
      name: getcontractasset
      description: Find a whitelisted contract's asset
      operations:
      - method: GET
        name: getcontractasset
        description: Find a whitelisted contract's asset
        call: wallets.getcontractasset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/contracts/{contractId}/{assetId}
      name: addcontractasset
      description: Add an Asset to a Whitelisted Contract
      operations:
      - method: POST
        name: addcontractasset
        description: Add an Asset to a Whitelisted Contract
        call: wallets.addcontractasset
        outputParameters:
        - type: object
          mapping: $.
        with:
          body: rest.body
    - path: /v1/contracts/{contractId}/{assetId}
      name: deletecontractasset
      description: Delete a Whitelisted Contract's Asset
      operations:
      - method: DELETE
        name: deletecontractasset
        description: Delete a Whitelisted Contract's Asset
        call: wallets.deletecontractasset
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: wallets-mcp
    port: 9090
    transport: http
    description: MCP adapter for Fireblocks Wallets. One tool per consumed operation.
    tools:
    - name: fireblocks-getinternalwallets
      description: List internal wallets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getinternalwallets
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createinternalwallet
      description: Create an internal wallet
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: wallets.createinternalwallet
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getinternalwallet
      description: Get assets for internal wallet
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getinternalwallet
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-deleteinternalwallet
      description: Delete an internal wallet
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: wallets.deleteinternalwallet
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getinternalwalletassetspaginated
      description: List assets in an internal wallet (Paginated)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getinternalwalletassetspaginated
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-setcustomerrefidforinternalwallet
      description: Set an AML/KYT customer reference ID for internal wallet
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: wallets.setcustomerrefidforinternalwallet
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getinternalwalletasset
      description: Get an asset from an internal wallet
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getinternalwalletasset
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createinternalwalletasset
      description: Add an asset to an internal wallet
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: wallets.createinternalwalletasset
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-deleteinternalwalletasset
      description: Delete a whitelisted address
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: wallets.deleteinternalwalletasset
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getexternalwallets
      description: List external wallets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getexternalwallets
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createexternalwallet
      description: Create an external wallet
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: wallets.createexternalwallet
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getexternalwallet
      description: Find an external wallet
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getexternalwallet
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-deleteexternalwallet
      description: Delete an external wallet
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: wallets.deleteexternalwallet
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-setexternalwalletcustomerrefid
      description: Set an AML customer reference ID for an external wallet
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: wallets.setexternalwalletcustomerrefid
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getexternalwalletasset
      description: Get an asset from an external wallet
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getexternalwalletasset
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-addassettoexternalwallet
      description: Add an asset to an external wallet.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: wallets.addassettoexternalwallet
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-removeassetfromexternalwallet
      description: Delete an asset from an external wallet
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: wallets.removeassetfromexternalwallet
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getcontracts
      description: List Whitelisted Contracts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getcontracts
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-createcontract
      description: Create a Whitelisted Contract
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: wallets.createcontract
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-getcontract
      description: Find a Specific Whitelisted Contract
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getcontract
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-deletecontract
      description: Delete a Whitelisted Contract
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: wallets.deletecontract
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-getcontractasset
      description: Find a whitelisted contract's asset
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: wallets.getcontractasset
      outputParameters:
      - type: object
        mapping: $.
    - name: fireblocks-addcontractasset
      description: Add an Asset to a Whitelisted Contract
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: wallets.addcontractasset
      outputParameters:
      - type: object
        mapping: $.
      with:
        body: tools.body
    - name: fireblocks-deletecontractasset
      description: Delete a Whitelisted Contract's Asset
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: wallets.deletecontractasset
      outputParameters:
      - type: object
        mapping: $.