naftiko: 1.0.0-alpha2
info:
  label: Ramp Accounting Integration
  description: Workflow capability for syncing Ramp spend data with external accounting platforms. Enables accounting teams
    to map transactions to general ledger accounts, manage vendors, apply accounting fields, and export financial data for
    reconciliation in systems like QuickBooks, Xero, NetSuite, and Sage.
  tags:
  - Finance
  - Accounting
  - Accounts Payable
  - Vendors
  - Ramp
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    RAMP_ACCESS_TOKEN: RAMP_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: ramp
    baseUri: https://api.ramp.com/developer/v1
    description: Ramp Developer API for finance automation and spend management.
    authentication:
      type: bearer
      token: '{{RAMP_ACCESS_TOKEN}}'
    resources:
    - name: accounting-accounts
      path: /accounting/accounts
      description: General ledger account resources.
      operations:
      - name: list-accounting-accounts
        method: GET
        description: Returns a paginated list of general ledger accounts.
        inputParameters:
        - name: page_size
          in: query
          type: integer
          required: false
          description: Number of records per page.
        - name: start
          in: query
          type: string
          required: false
          description: Cursor for pagination.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accounting-vendors
      path: /accounting/vendors
      description: Vendor records for accounting integrations.
      operations:
      - name: list-accounting-vendors
        method: GET
        description: Returns a list of vendor records.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: transactions
      path: /transactions
      description: Card and bill transactions.
      operations:
      - name: list-transactions
        method: GET
        description: Returns a paginated list of transactions.
        inputParameters:
        - name: from_date
          in: query
          type: string
          required: false
          description: Start date filter (YYYY-MM-DD).
        - name: to_date
          in: query
          type: string
          required: false
          description: End date filter (YYYY-MM-DD).
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: transaction
      path: /transactions/{id}
      description: Single transaction resource.
      operations:
      - name: get-transaction
        method: GET
        description: Retrieves a single transaction by ID.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Transaction identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: cards
      path: /cards
      description: Physical and virtual cards.
      operations:
      - name: list-cards
        method: GET
        description: Returns a paginated list of cards.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users
      path: /users
      description: User accounts.
      operations:
      - name: list-users
        method: GET
        description: Returns a paginated list of users.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: departments
      path: /departments
      description: Department records.
      operations:
      - name: list-departments
        method: GET
        description: Returns a paginated list of departments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: locations
      path: /locations
      description: Location records.
      operations:
      - name: list-locations
        method: GET
        description: Returns a paginated list of locations.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: reimbursements
      path: /reimbursements
      description: Out-of-pocket reimbursement requests.
      operations:
      - name: list-reimbursements
        method: GET
        description: Returns a paginated list of reimbursements.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: bills
      path: /bills
      description: Bill pay records.
      operations:
      - name: list-bills
        method: GET
        description: Returns a paginated list of bills.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: statements
      path: /statements
      description: Card statement records.
      operations:
      - name: list-statements
        method: GET
        description: Returns a paginated list of statements.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: audit-logs
      path: /audit-logs/events
      description: Audit events.
      operations:
      - name: list-audit-events
        method: GET
        description: Returns a paginated list of audit events.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8081
    namespace: ramp-accounting-api
    description: Unified REST API for Ramp accounting integration workflows.
    resources:
    - path: /v1/accounting/accounts
      name: accounting-accounts
      description: General ledger accounts.
      operations:
      - method: GET
        name: list-accounting-accounts
        description: List all general ledger accounts.
        call: ramp.list-accounting-accounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/accounting/vendors
      name: accounting-vendors
      description: Vendor records for accounting integrations.
      operations:
      - method: GET
        name: list-accounting-vendors
        description: List all vendor records.
        call: ramp.list-accounting-vendors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/bills
      name: bills
      description: Bill pay records.
      operations:
      - method: GET
        name: list-bills
        description: List all bills pending accounting review.
        call: ramp.list-bills
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/audit-logs
      name: audit-logs
      description: Audit events for compliance and accounting review.
      operations:
      - method: GET
        name: list-audit-events
        description: List audit events.
        call: ramp.list-audit-events
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9081
    namespace: ramp-accounting-mcp
    transport: http
    description: MCP server for AI-assisted accounting integration with Ramp.
    tools:
    - name: list-gl-accounts
      description: List general ledger accounts configured in Ramp for accounting system mapping.
      hints:
        readOnly: true
        openWorld: true
      call: ramp.list-accounting-accounts
      outputParameters:
      - type: object
        mapping: $.
    - name: list-vendors
      description: List vendor records used for bill pay and accounting integrations.
      hints:
        readOnly: true
        openWorld: true
      call: ramp.list-accounting-vendors
      outputParameters:
      - type: object
        mapping: $.
    - name: list-bills
      description: List bill pay records for accounts payable workflows.
      hints:
        readOnly: true
        openWorld: true
      call: ramp.list-bills
      outputParameters:
      - type: object
        mapping: $.
    - name: list-audit-events
      description: List audit events for compliance reporting and accounting review.
      hints:
        readOnly: true
        openWorld: true
      call: ramp.list-audit-events
      outputParameters:
      - type: object
        mapping: $.
    - name: list-statements
      description: List card statements for period-end close and reconciliation.
      hints:
        readOnly: true
        openWorld: true
      call: ramp.list-statements
      outputParameters:
      - type: object
        mapping: $.