naftiko: 1.0.0-alpha2
info:
  label: Tropic Procurement Management
  description: Workflow capability for managing the full procurement lifecycle in Tropic — from intake and request approval
    through contract execution and supplier management. Used by procurement teams, finance managers, and operations leads.
  tags:
  - Tropic
  - Procurement
  - Contract Management
  - Supplier Management
  - Spend Management
  - Approval Workflows
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    TROPIC_API_KEY: TROPIC_API_KEY
capability:
  consumes:
  - type: http
    namespace: tropic
    baseUri: https://api.tropicapp.io/v1
    description: Tropic procurement and spend management API
    authentication:
      type: bearer
      token: '{{TROPIC_API_KEY}}'
    resources:
    - name: contracts
      path: /contracts
      description: Contract lifecycle management
      operations:
      - name: list-contracts
        method: GET
        description: List all contracts
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: per_page
          in: query
          type: integer
          required: false
          description: Results per page
        - name: status
          in: query
          type: string
          required: false
          description: Filter by status
        - name: supplier_id
          in: query
          type: string
          required: false
          description: Filter by supplier ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-contract
        method: POST
        description: Create a new contract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            supplier_id: '{{tools.supplier_id}}'
            start_date: '{{tools.start_date}}'
            end_date: '{{tools.end_date}}'
            total_value: '{{tools.total_value}}'
    - name: contract
      path: /contracts/{id}
      description: Individual contract operations
      operations:
      - name: get-contract
        method: GET
        description: Get contract by ID
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Contract ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-contract
        method: PUT
        description: Update an existing contract
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Contract ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            status: '{{tools.status}}'
            renewal_date: '{{tools.renewal_date}}'
            total_value: '{{tools.total_value}}'
      - name: delete-contract
        method: DELETE
        description: Delete a contract
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: suppliers
      path: /suppliers
      description: Supplier profile management
      operations:
      - name: list-suppliers
        method: GET
        description: List all suppliers
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
        - name: per_page
          in: query
          type: integer
          required: false
        - name: q
          in: query
          type: string
          required: false
          description: Search query
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-supplier
        method: POST
        description: Create a new supplier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            website: '{{tools.website}}'
            category: '{{tools.category}}'
    - name: supplier
      path: /suppliers/{id}
      description: Individual supplier operations
      operations:
      - name: get-supplier
        method: GET
        description: Get supplier by ID
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-supplier
        method: PUT
        description: Update a supplier
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            status: '{{tools.status}}'
    - name: requests
      path: /requests
      description: Procurement request management
      operations:
      - name: list-requests
        method: GET
        description: List procurement requests
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
        - name: per_page
          in: query
          type: integer
          required: false
        - name: status
          in: query
          type: string
          required: false
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-request
        method: POST
        description: Create a procurement request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            title: '{{tools.title}}'
            amount: '{{tools.amount}}'
            supplier_id: '{{tools.supplier_id}}'
            category: '{{tools.category}}'
    - name: request
      path: /requests/{id}
      description: Individual request operations
      operations:
      - name: get-request
        method: GET
        description: Get request by ID
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: request-approve
      path: /requests/{id}/approve
      description: Approve a procurement request
      operations:
      - name: approve-request
        method: POST
        description: Approve a pending request
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            notes: '{{tools.notes}}'
    - name: request-reject
      path: /requests/{id}/reject
      description: Reject a procurement request
      operations:
      - name: reject-request
        method: POST
        description: Reject a pending request
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            reason: '{{tools.reason}}'
    - name: webhooks
      path: /webhooks
      description: Webhook subscription management
      operations:
      - name: list-webhooks
        method: GET
        description: List all webhooks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-webhook
        method: POST
        description: Create a webhook subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            url: '{{tools.url}}'
            events: '{{tools.events}}'
    - name: users
      path: /users
      description: User management
      operations:
      - name: list-users
        method: GET
        description: List organization users
        inputParameters:
        - name: page
          in: query
          type: integer
          required: false
        - name: per_page
          in: query
          type: integer
          required: false
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: tropic-procurement-api
    description: Unified REST API for Tropic procurement lifecycle management.
    resources:
    - path: /v1/contracts
      name: contracts
      description: Contract lifecycle management
      operations:
      - method: GET
        name: list-contracts
        description: List all contracts with optional filters
        call: tropic.list-contracts
        with:
          page: rest.page
          per_page: rest.per_page
          status: rest.status
          supplier_id: rest.supplier_id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-contract
        description: Create a new contract record
        call: tropic.create-contract
        with:
          name: rest.name
          supplier_id: rest.supplier_id
          start_date: rest.start_date
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/contracts/{id}
      name: contract
      description: Individual contract operations
      operations:
      - method: GET
        name: get-contract
        description: Get a contract by ID
        call: tropic.get-contract
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: update-contract
        description: Update a contract
        call: tropic.update-contract
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete-contract
        description: Delete a contract
        call: tropic.delete-contract
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/suppliers
      name: suppliers
      description: Supplier relationship management
      operations:
      - method: GET
        name: list-suppliers
        description: List all suppliers
        call: tropic.list-suppliers
        with:
          q: rest.q
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-supplier
        description: Create a new supplier
        call: tropic.create-supplier
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/suppliers/{id}
      name: supplier
      operations:
      - method: GET
        name: get-supplier
        description: Get a supplier by ID
        call: tropic.get-supplier
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: update-supplier
        description: Update a supplier
        call: tropic.update-supplier
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests
      name: requests
      description: Procurement request management
      operations:
      - method: GET
        name: list-requests
        description: List procurement requests
        call: tropic.list-requests
        with:
          status: rest.status
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-request
        description: Submit a new procurement request
        call: tropic.create-request
        with:
          title: rest.title
          amount: rest.amount
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests/{id}
      name: request
      operations:
      - method: GET
        name: get-request
        description: Get a request by ID
        call: tropic.get-request
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests/{id}/approve
      name: request-approve
      operations:
      - method: POST
        name: approve-request
        description: Approve a pending request
        call: tropic.approve-request
        with:
          id: rest.id
          notes: rest.notes
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/requests/{id}/reject
      name: request-reject
      operations:
      - method: POST
        name: reject-request
        description: Reject a pending request
        call: tropic.reject-request
        with:
          id: rest.id
          reason: rest.reason
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/webhooks
      name: webhooks
      description: Event webhook management
      operations:
      - method: GET
        name: list-webhooks
        description: List webhook subscriptions
        call: tropic.list-webhooks
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-webhook
        description: Create a webhook subscription
        call: tropic.create-webhook
        with:
          url: rest.url
          events: rest.events
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/users
      name: users
      description: User management
      operations:
      - method: GET
        name: list-users
        description: List organization users
        call: tropic.list-users
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: tropic-procurement-mcp
    transport: http
    description: MCP server for AI-assisted procurement management in Tropic.
    tools:
    - name: list-contracts
      description: List all contracts with optional status and supplier filters
      hints:
        readOnly: true
        openWorld: true
      call: tropic.list-contracts
      with:
        status: tools.status
        supplier_id: tools.supplier_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-contract
      description: Get a specific contract by ID
      hints:
        readOnly: true
        idempotent: true
      call: tropic.get-contract
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-contract
      description: Create a new vendor contract in Tropic
      hints:
        readOnly: false
      call: tropic.create-contract
      with:
        name: tools.name
        supplier_id: tools.supplier_id
        start_date: tools.start_date
      outputParameters:
      - type: object
        mapping: $.
    - name: update-contract
      description: Update contract details (status, renewal date, value)
      hints:
        readOnly: false
        idempotent: true
      call: tropic.update-contract
      with:
        id: tools.id
        status: tools.status
      outputParameters:
      - type: object
        mapping: $.
    - name: list-suppliers
      description: List all supplier profiles
      hints:
        readOnly: true
        openWorld: true
      call: tropic.list-suppliers
      with:
        q: tools.q
      outputParameters:
      - type: object
        mapping: $.
    - name: get-supplier
      description: Get a specific supplier by ID
      hints:
        readOnly: true
        idempotent: true
      call: tropic.get-supplier
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-supplier
      description: Create a new supplier profile
      hints:
        readOnly: false
      call: tropic.create-supplier
      with:
        name: tools.name
        website: tools.website
        category: tools.category
      outputParameters:
      - type: object
        mapping: $.
    - name: list-requests
      description: List procurement requests with optional status filter
      hints:
        readOnly: true
        openWorld: true
      call: tropic.list-requests
      with:
        status: tools.status
      outputParameters:
      - type: object
        mapping: $.
    - name: get-request
      description: Get a specific procurement request by ID
      hints:
        readOnly: true
        idempotent: true
      call: tropic.get-request
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-request
      description: Submit a new procurement request
      hints:
        readOnly: false
      call: tropic.create-request
      with:
        title: tools.title
        amount: tools.amount
        supplier_id: tools.supplier_id
        category: tools.category
      outputParameters:
      - type: object
        mapping: $.
    - name: approve-request
      description: Approve a pending procurement request
      hints:
        readOnly: false
        idempotent: true
      call: tropic.approve-request
      with:
        id: tools.id
        notes: tools.notes
      outputParameters:
      - type: object
        mapping: $.
    - name: reject-request
      description: Reject a pending procurement request with a reason
      hints:
        readOnly: false
        idempotent: true
      call: tropic.reject-request
      with:
        id: tools.id
        reason: tools.reason
      outputParameters:
      - type: object
        mapping: $.
    - name: list-webhooks
      description: List configured webhook subscriptions
      hints:
        readOnly: true
      call: tropic.list-webhooks
      outputParameters:
      - type: object
        mapping: $.
    - name: create-webhook
      description: Create a new webhook subscription for procurement events
      hints:
        readOnly: false
      call: tropic.create-webhook
      with:
        url: tools.url
        events: tools.events
      outputParameters:
      - type: object
        mapping: $.
    - name: list-users
      description: List organization users in Tropic
      hints:
        readOnly: true
      call: tropic.list-users
      outputParameters:
      - type: object
        mapping: $.