naftiko: 1.0.0-alpha2
info:
  label: TrustRadius Buyer Intelligence
  description: Unified B2B buyer intelligence capability combining product data, verified reviews, and category research.
    Used by sales and marketing teams to research software categories, compare products, access verified buyer reviews, and
    surface competitive intelligence. Enables AI-assisted vendor evaluation, competitive analysis, and review-based demand
    generation workflows.
  tags:
  - B2B Software Reviews
  - Buyer Intelligence
  - Intent Data
  - Product Reviews
  - Software Categories
  - Competitive Analysis
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    TRUSTRADIUS_API_KEY: TRUSTRADIUS_API_KEY
capability:
  consumes:
  - type: http
    namespace: trustradius-products
    baseUri: https://api.trustradius.com/v1
    description: TrustRadius product and category data.
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{TRUSTRADIUS_API_KEY}}'
      placement: header
    resources:
    - name: products
      path: /products
      description: B2B software product listings
      operations:
      - name: list-products
        method: GET
        description: Retrieve B2B software products with ratings and review counts.
        inputParameters:
        - name: category
          in: query
          type: string
          required: false
        - name: page
          in: query
          type: integer
          required: false
        - name: perPage
          in: query
          type: integer
          required: false
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: product
      path: /products/{productSlug}
      description: Individual product details
      operations:
      - name: get-product
        method: GET
        description: Get detailed product profile including TrustRadius score.
        inputParameters:
        - name: productSlug
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: product-ratings
      path: /products/{productSlug}/ratings
      description: Product aggregate ratings
      operations:
      - name: get-product-ratings
        method: GET
        description: Get aggregate rating breakdown for a product.
        inputParameters:
        - name: productSlug
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: categories
      path: /categories
      description: Software categories
      operations:
      - name: list-categories
        method: GET
        description: List all software categories on TrustRadius.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: category
      path: /categories/{categorySlug}
      description: Category details with top products
      operations:
      - name: get-category
        method: GET
        description: Get category details including top-rated products.
        inputParameters:
        - name: categorySlug
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: trustradius-reviews
    baseUri: https://api.trustradius.com/v1
    description: TrustRadius verified review data.
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{TRUSTRADIUS_API_KEY}}'
      placement: header
    resources:
    - name: reviews
      path: /reviews
      description: Verified user reviews
      operations:
      - name: list-reviews
        method: GET
        description: List verified reviews with filtering by product, category, industry, and rating.
        inputParameters:
        - name: product
          in: query
          type: string
          required: false
        - name: category
          in: query
          type: string
          required: false
        - name: industry
          in: query
          type: string
          required: false
        - name: companySize
          in: query
          type: string
          required: false
        - name: minScore
          in: query
          type: integer
          required: false
        - name: page
          in: query
          type: integer
          required: false
        - name: perPage
          in: query
          type: integer
          required: false
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: review
      path: /reviews/{reviewId}
      description: Individual review
      operations:
      - name: get-review
        method: GET
        description: Get full content of a specific review.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: trustradius-buyer-intelligence-api
    description: Unified REST API for B2B software research, product comparison, and buyer review access.
    resources:
    - path: /v1/products
      name: products
      description: B2B software products
      operations:
      - method: GET
        name: list-products
        description: List B2B software products with TrustRadius scores.
        call: trustradius-products.list-products
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/products/{productSlug}
      name: product
      description: Product profile
      operations:
      - method: GET
        name: get-product
        description: Get detailed product profile.
        call: trustradius-products.get-product
        with:
          productSlug: rest.productSlug
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/products/{productSlug}/ratings
      name: product-ratings
      description: Product ratings
      operations:
      - method: GET
        name: get-product-ratings
        description: Get aggregate product ratings.
        call: trustradius-products.get-product-ratings
        with:
          productSlug: rest.productSlug
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/categories
      name: categories
      description: Software categories
      operations:
      - method: GET
        name: list-categories
        description: List software categories.
        call: trustradius-products.list-categories
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/categories/{categorySlug}
      name: category
      description: Category details
      operations:
      - method: GET
        name: get-category
        description: Get category with top products.
        call: trustradius-products.get-category
        with:
          categorySlug: rest.categorySlug
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reviews
      name: reviews
      description: Verified reviews
      operations:
      - method: GET
        name: list-reviews
        description: List verified B2B software reviews.
        call: trustradius-reviews.list-reviews
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reviews/{reviewId}
      name: review
      description: Individual review
      operations:
      - method: GET
        name: get-review
        description: Get full review content.
        call: trustradius-reviews.get-review
        with:
          reviewId: rest.reviewId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9080
    namespace: trustradius-buyer-intelligence-mcp
    transport: http
    description: MCP server for AI-assisted B2B software research, competitive analysis, and buyer review access.
    tools:
    - name: list-products
      description: List B2B software products in a category with TrustRadius scores and review counts.
      hints:
        readOnly: true
        openWorld: true
      call: trustradius-products.list-products
      with:
        category: tools.category
      outputParameters:
      - type: object
        mapping: $.
    - name: get-product
      description: Get detailed product profile including TrustRadius score, categories, and aggregate ratings.
      hints:
        readOnly: true
        openWorld: false
      call: trustradius-products.get-product
      with:
        productSlug: tools.productSlug
      outputParameters:
      - type: object
        mapping: $.
    - name: get-product-ratings
      description: Get multi-dimensional rating breakdown for a product across usability, support, and value.
      hints:
        readOnly: true
        openWorld: false
      call: trustradius-products.get-product-ratings
      with:
        productSlug: tools.productSlug
      outputParameters:
      - type: object
        mapping: $.
    - name: list-categories
      description: List all B2B software categories available on TrustRadius.
      hints:
        readOnly: true
        openWorld: true
      call: trustradius-products.list-categories
      outputParameters:
      - type: object
        mapping: $.
    - name: get-category
      description: Get a software category with its top-rated products for category research.
      hints:
        readOnly: true
        openWorld: false
      call: trustradius-products.get-category
      with:
        categorySlug: tools.categorySlug
      outputParameters:
      - type: object
        mapping: $.
    - name: list-reviews
      description: List verified B2B software reviews with filtering by product, industry, company size, and minimum score.
      hints:
        readOnly: true
        openWorld: true
      call: trustradius-reviews.list-reviews
      with:
        product: tools.product
        category: tools.category
        industry: tools.industry
        companySize: tools.companySize
        minScore: tools.minScore
      outputParameters:
      - type: object
        mapping: $.
    - name: get-review
      description: Get the complete text, ratings, pros, and cons from a specific verified B2B software review.
      hints:
        readOnly: true
        openWorld: false
      call: trustradius-reviews.get-review
      with:
        reviewId: tools.reviewId
      outputParameters:
      - type: object
        mapping: $.