naftiko: 1.0.0-alpha2
info:
  label: Unified.to Financial Operations
  description: Unified financial operations workflow combining accounting, invoicing, transactions, and payment management
    across 41 accounting integrations including QuickBooks, Xero, and FreshBooks. Used by fintech developers, accounting automation
    tools, and finance teams building cross-platform financial reporting and billing automation.
  tags:
  - Unified.to
  - Accounting
  - Financial
  - Invoices
  - Payments
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    UNIFIED_TO_API_KEY: UNIFIED_TO_API_KEY
capability:
  consumes:
  - type: http
    namespace: unified-accounting
    baseUri: https://api.unified.to
    description: Unified Accounting API for financial data management.
    authentication:
      type: bearer
      token: '{{UNIFIED_TO_API_KEY}}'
    resources:
    - name: accounts
      path: /accounting/{connection_id}/account
      description: Chart of accounts management
      operations:
      - name: list-accounting-accounts
        method: GET
        description: List accounts from the chart of accounts
        inputParameters:
        - name: connection_id
          in: path
          type: string
          required: true
          description: Accounting integration connection ID
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: invoices
      path: /accounting/{connection_id}/invoice
      description: Invoice management
      operations:
      - name: list-accounting-invoices
        method: GET
        description: List invoices
        inputParameters:
        - name: connection_id
          in: path
          type: string
          required: true
          description: Accounting integration connection ID
        - name: limit
          in: query
          type: integer
          required: false
          description: Maximum number of results
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-accounting-invoice
        method: POST
        description: Create an invoice
        inputParameters:
        - name: connection_id
          in: path
          type: string
          required: true
          description: Accounting integration connection ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: transactions
      path: /accounting/{connection_id}/transaction
      description: Financial transaction management
      operations:
      - name: list-accounting-transactions
        method: GET
        description: List financial transactions
        inputParameters:
        - name: connection_id
          in: path
          type: string
          required: true
          description: Accounting integration connection ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: contacts
      path: /accounting/{connection_id}/contact
      description: Accounting contact (customer/vendor) management
      operations:
      - name: list-accounting-contacts
        method: GET
        description: List accounting contacts
        inputParameters:
        - name: connection_id
          in: path
          type: string
          required: true
          description: Accounting integration connection ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: payments
      path: /accounting/{connection_id}/payment
      description: Payment management
      operations:
      - name: list-accounting-payments
        method: GET
        description: List accounting payments
        inputParameters:
        - name: connection_id
          in: path
          type: string
          required: true
          description: Accounting integration connection ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8082
    namespace: unified-financial-ops-api
    description: Unified REST API for financial operations across 41+ accounting integrations.
    resources:
    - path: /v1/accounting/{connection_id}/accounts
      name: accounts
      description: Chart of accounts management
      operations:
      - method: GET
        name: list-accounting-accounts
        description: List accounts from chart of accounts
        call: unified-accounting.list-accounting-accounts
        with:
          connection_id: rest.connection_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounting/{connection_id}/invoices
      name: invoices
      description: Invoice management
      operations:
      - method: GET
        name: list-accounting-invoices
        description: List invoices
        call: unified-accounting.list-accounting-invoices
        with:
          connection_id: rest.connection_id
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-accounting-invoice
        description: Create a new invoice
        call: unified-accounting.create-accounting-invoice
        with:
          connection_id: rest.connection_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounting/{connection_id}/transactions
      name: transactions
      description: Financial transaction history
      operations:
      - method: GET
        name: list-accounting-transactions
        description: List financial transactions
        call: unified-accounting.list-accounting-transactions
        with:
          connection_id: rest.connection_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounting/{connection_id}/payments
      name: payments
      description: Payment management
      operations:
      - method: GET
        name: list-accounting-payments
        description: List accounting payments
        call: unified-accounting.list-accounting-payments
        with:
          connection_id: rest.connection_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounting/{connection_id}/contacts
      name: contacts
      description: Accounting customer and vendor contacts
      operations:
      - method: GET
        name: list-accounting-contacts
        description: List accounting contacts
        call: unified-accounting.list-accounting-contacts
        with:
          connection_id: rest.connection_id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9082
    namespace: unified-financial-ops-mcp
    transport: http
    description: MCP server for AI-assisted financial operations across 41+ accounting integrations.
    tools:
    - name: list-accounting-accounts
      description: List chart of accounts from a connected accounting integration (QuickBooks, Xero, etc.)
      hints:
        readOnly: true
        openWorld: false
      call: unified-accounting.list-accounting-accounts
      with:
        connection_id: tools.connection_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-accounting-invoices
      description: List invoices from a connected accounting integration
      hints:
        readOnly: true
        openWorld: false
      call: unified-accounting.list-accounting-invoices
      with:
        connection_id: tools.connection_id
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: create-accounting-invoice
      description: Create a new invoice in a connected accounting integration
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: unified-accounting.create-accounting-invoice
      with:
        connection_id: tools.connection_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-accounting-transactions
      description: List financial transactions from a connected accounting integration
      hints:
        readOnly: true
        openWorld: false
      call: unified-accounting.list-accounting-transactions
      with:
        connection_id: tools.connection_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-accounting-payments
      description: List payments from a connected accounting integration
      hints:
        readOnly: true
        openWorld: false
      call: unified-accounting.list-accounting-payments
      with:
        connection_id: tools.connection_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-accounting-contacts
      description: List accounting contacts (customers and vendors) from a connected accounting integration
      hints:
        readOnly: true
        openWorld: false
      call: unified-accounting.list-accounting-contacts
      with:
        connection_id: tools.connection_id
      outputParameters:
      - type: object
        mapping: $.