Feefo MCP by usefulapi

List reviews of your Feefo account, newest updates first. mode: all (service + product, default), service (seller/service reviews), product (product reviews; give product_sku or parent_product_sku) or nps (Net Promoter Score responses). Returns summary.meta (count, pages) and reviews[] with ratings, comment text, customer display name and review threads. Page with page/page_size.

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "all",
      "type": "string",
      "enum": [
        "all",
        "service",
        "product",
        "nps"
      ]
    },
    "product_sku": {
      "description": "Product SKU (required for mode=product unless parent_product_sku is set). Comma-separated list allowed.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "parent_product_sku": {
      "description": "Parent product SKU (all its variants)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "rating": {
      "description": "Only reviews with this rating: 1-5 stars; for mode=nps the 0-10 score",
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    },
    "since_period": {
      "description": "Reviews created within this period (Feefo default: year). Use 'all' for the whole history.",
      "type": "string",
      "enum": [
        "month",
        "year",
        "all"
      ]
    },
    "since_updated_period": {
      "description": "Reviews updated within this period",
      "type": "string",
      "enum": [
        "month",
        "year",
        "all"
      ]
    },
    "tags": {
      "description": "Sales tag filter (comma-separated)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "media": {
      "description": "Photo/video reviews filter",
      "type": "string",
      "enum": [
        "include",
        "exclude",
        "only",
        "video",
        "photo"
      ]
    },
    "unanswered_feedback": {
      "description": "Whether unanswered low-rated feedback from the last 48 hours is included (Feefo default: include)",
      "type": "string",
      "enum": [
        "include",
        "exclude",
        "exclude_negative"
      ]
    },
    "empty_product_comments": {
      "description": "Whether product reviews with no text comment are included",
      "type": "string",
      "enum": [
        "include",
        "default",
        "exclude"
      ]
    },
    "origin": {
      "description": "Origin/domain (needed when several domains share the feed)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "order_reference": {
      "description": "Only the review(s) for this order reference (needs the App Key)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "customer_reference": {
      "description": "Only reviews for this customer reference (needs the App Key)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "full_thread": {
      "description": "Include the full exchange (replies, rating changes) on each review",
      "type": "boolean"
    },
    "enhanced_insight": {
      "description": "Include sentiment features/snippets (needs Smart Themes)",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Reviews per page (default 20, max 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get one review by its id (the `id` of a service or product element from feefo_list_reviews), optionally with its full thread of replies.

{
  "type": "object",
  "properties": {
    "review_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Review id, for example 6a3bbf38e4b0d81661f292b1"
    },
    "full_thread": {
      "description": "Include replies and rating changes",
      "type": "boolean"
    }
  },
  "required": [
    "review_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Aggregate ratings for your Feefo account: average rating and star distribution (1 to 5 stars) for service and product reviews, merchant details, review counts. mode: all (default), service, product (needs product_sku or parent_product_sku) or nps (promoters/passives/detractors). Use since_period=all for lifetime figures (Feefo default: the last year).

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "all",
      "type": "string",
      "enum": [
        "all",
        "service",
        "product",
        "nps"
      ]
    },
    "product_sku": {
      "description": "Product SKU (required for mode=product unless parent_product_sku is set). Comma-separated list allowed.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "parent_product_sku": {
      "description": "Parent product SKU (all its variants)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "rating": {
      "description": "Only reviews with this rating: 1-5 stars; for mode=nps the 0-10 score",
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    },
    "since_period": {
      "description": "Reviews created within this period (Feefo default: year). Use 'all' for the whole history.",
      "type": "string",
      "enum": [
        "month",
        "year",
        "all"
      ]
    },
    "since_updated_period": {
      "description": "Reviews updated within this period",
      "type": "string",
      "enum": [
        "month",
        "year",
        "all"
      ]
    },
    "tags": {
      "description": "Sales tag filter (comma-separated)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "media": {
      "description": "Photo/video reviews filter",
      "type": "string",
      "enum": [
        "include",
        "exclude",
        "only",
        "video",
        "photo"
      ]
    },
    "unanswered_feedback": {
      "description": "Whether unanswered low-rated feedback from the last 48 hours is included (Feefo default: include)",
      "type": "string",
      "enum": [
        "include",
        "exclude",
        "exclude_negative"
      ]
    },
    "empty_product_comments": {
      "description": "Whether product reviews with no text comment are included",
      "type": "string",
      "enum": [
        "include",
        "default",
        "exclude"
      ]
    },
    "origin": {
      "description": "Origin/domain (needed when several domains share the feed)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "order_reference": {
      "description": "Only the review(s) for this order reference (needs the App Key)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "customer_reference": {
      "description": "Only reviews for this customer reference (needs the App Key)",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "enhanced_insight": {
      "description": "Include sentiment features/snippets (needs Smart Themes)",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Average star rating per product SKU (products[] with rating, sku and optionally review_count). Filter by product_sku (comma-separated, leading/trailing * wildcards allowed) or parent_product_sku.

{
  "type": "object",
  "properties": {
    "product_sku": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "parent_product_sku": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "review_count": {
      "description": "Also return how many reviews back each rating",
      "type": "boolean"
    },
    "since_period": {
      "description": "Reviews counted from this period (default year)",
      "type": "string",
      "enum": [
        "24_hours",
        "week",
        "month",
        "year",
        "all"
      ]
    },
    "summary": {
      "description": "Also return merchant and pagination information",
      "type": "boolean"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "page_size": {
      "description": "Default 20, max 100",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE: publish a public reply to a review on your Feefo account, optionally emailing the customer (notify_customer). Visible to the public on your Feefo page and not undoable through this server. `review_id` is the `id` of the service or product element returned by feefo_list_reviews (not the outer review url id). Confirm the wording with the user first.

{
  "type": "object",
  "properties": {
    "review_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Id of the individual service or product review element"
    },
    "author": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Name shown as the author of the reply, for example 'Customer Care Team'"
    },
    "response_text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "The public reply"
    },
    "notify_customer": {
      "default": false,
      "description": "Email the customer that you replied (default false)",
      "type": "boolean"
    }
  },
  "required": [
    "review_id",
    "author",
    "response_text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}