naftiko: 1.0.0-alpha2
info:
  label: TensorDock Marketplace API — Billing
  description: 'TensorDock Marketplace API — Billing. 3 operations. Lead operation: Retrieve Balance.
    Self-contained Naftiko capability for balance, revenue, and monthly summary lookups.'
  tags:
  - TensorDock
  - Billing
  - FinOps
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    TENSORDOCK_API_KEY: TENSORDOCK_API_KEY
    TENSORDOCK_API_TOKEN: TENSORDOCK_API_TOKEN
capability:
  consumes:
  - type: http
    namespace: marketplace-billing
    baseUri: https://marketplace.tensordock.com
    description: Retrieve customer balance and hosting-provider revenue from TensorDock.
    resources:
    - name: balance
      path: /api/v0/billing/balance
      operations:
      - name: retrievebalance
        method: POST
        description: Retrieve the current account balance.
        inputParameters:
        - name: api_key
          value: '{{env.TENSORDOCK_API_KEY}}'
          in: form
        - name: api_token
          value: '{{env.TENSORDOCK_API_TOKEN}}'
          in: form
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: revenue
      path: /api/v0/billing/revenue
      operations:
      - name: retrieverevenue
        method: POST
        description: Retrieve revenue history for a hosting provider.
        inputParameters:
        - name: api_key
          value: '{{env.TENSORDOCK_API_KEY}}'
          in: form
        - name: api_token
          value: '{{env.TENSORDOCK_API_TOKEN}}'
          in: form
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: summary
      path: /api/v0/billing/summary
      operations:
      - name: retrievemonthlysummary
        method: POST
        description: Retrieve the monthly billing summary.
        inputParameters:
        - name: api_key
          value: '{{env.TENSORDOCK_API_KEY}}'
          in: form
        - name: api_token
          value: '{{env.TENSORDOCK_API_TOKEN}}'
          in: form
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: mcp
    namespace: marketplace-billing-mcp
    port: 9090
    transport: http
    description: MCP adapter for TensorDock billing.
    tools:
    - name: tensordock-retrieve-balance
      description: Retrieve current TensorDock account balance.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: marketplace-billing.retrievebalance
      outputParameters:
      - type: object
        mapping: $.
    - name: tensordock-retrieve-revenue
      description: Retrieve TensorDock host revenue history.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: marketplace-billing.retrieverevenue
      outputParameters:
      - type: object
        mapping: $.
    - name: tensordock-retrieve-monthly-summary
      description: Retrieve TensorDock monthly billing summary.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: marketplace-billing.retrievemonthlysummary
      outputParameters:
      - type: object
        mapping: $.