---
title: "List Feedback Responses"
description: "Fetch unread Charming staff responses to feedback submitted by this authenticated account."
sidebar:
  order: 11
---

<!-- Generated by apps/docs/scripts/generate-mcp-reference.mjs. -->

MCP name: `list_feedback_responses`

## Tool contract

```json
{
  "annotations": {
    "destructiveHint": false,
    "openWorldHint": false,
    "readOnlyHint": true,
    "title": "List Feedback Responses"
  },
  "description": "Fetch unread Charming staff responses to feedback submitted by this authenticated account. Use this when a feedback-responses-available advisory appears. Responses are ordered oldest-first. Reading does not acknowledge them; call acknowledge_feedback_responses with the returned response IDs after processing them.",
  "execution": {
    "taskSupport": "forbidden"
  },
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "properties": {
      "cursor": {
        "description": "Opaque cursor returned by the prior page.",
        "type": "string"
      },
      "limit": {
        "description": "Max responses to return (1-50, default 20).",
        "maximum": 50,
        "minimum": 1,
        "type": "integer"
      }
    },
    "type": "object"
  },
  "name": "list_feedback_responses",
  "outputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "advisories": {
        "description": "Structured non-fatal advisories, including authoring issues and unread staff feedback responses. Each advisory.summary is also appended to the text content for the LLM path.",
        "items": {
          "additionalProperties": false,
          "properties": {
            "data": {
              "additionalProperties": {},
              "description": "Kind-specific structured payload. Shape varies per advisory kind.",
              "propertyNames": {
                "type": "string"
              },
              "type": "object"
            },
            "doc_url": {
              "description": "Optional docs pointer for this advisory kind.",
              "type": "string"
            },
            "kind": {
              "description": "Stable advisory identifier (e.g. \"legacy-bridge\").",
              "type": "string"
            },
            "severity": {
              "description": "Severity; omitted advisories are treated as 'info'.",
              "enum": [
                "info",
                "warn"
              ],
              "type": "string"
            },
            "summary": {
              "description": "Agent-facing summary. Self-sufficient; no extra context required.",
              "type": "string"
            },
            "userSummary": {
              "description": "End-user-facing summary. Set when the advisory should render in-app.",
              "type": "string"
            }
          },
          "required": [
            "kind",
            "summary"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "cursor": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "Opaque cursor for the next oldest-first page. Null on the final page."
      },
      "items": {
        "description": "Unread staff responses ordered by `created_at ASC, id ASC`.",
        "items": {
          "additionalProperties": false,
          "properties": {
            "acknowledged_at": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "ISO-8601 acknowledgement timestamp. Null for unread responses."
            },
            "app_id": {
              "description": "App UUID the original feedback belongs to.",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "created_at": {
              "description": "ISO-8601 timestamp when staff authored the response.",
              "type": "string"
            },
            "feedback": {
              "additionalProperties": false,
              "description": "Original feedback context for this response thread.",
              "properties": {
                "category": {
                  "description": "Feedback category. One of: bug, crash, enhancement, praise, other.",
                  "type": "string"
                },
                "crash_data": {
                  "anyOf": [
                    {
                      "additionalProperties": {},
                      "propertyNames": {
                        "type": "string"
                      },
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Crash details (message + optional stack/url/userAgent/traceId). Null unless category=crash."
                },
                "created_at": {
                  "description": "ISO-8601 timestamp when the row was inserted.",
                  "type": "string"
                },
                "source": {
                  "description": "Origin of the row: \"user\", \"agent\", or \"auto-crash\". Server-enforced.",
                  "type": "string"
                },
                "structured_data": {
                  "anyOf": [
                    {
                      "additionalProperties": {},
                      "propertyNames": {
                        "type": "string"
                      },
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Caller-supplied JSON payload. Null when not supplied."
                },
                "text": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Free-form feedback body. Null when not supplied."
                }
              },
              "required": [
                "category",
                "text",
                "structured_data",
                "crash_data",
                "source",
                "created_at"
              ],
              "type": "object"
            },
            "feedback_id": {
              "description": "Original feedback UUID for this thread.",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "id": {
              "description": "Feedback response UUID.",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            },
            "text": {
              "description": "Charming staff question or resolution.",
              "type": "string"
            }
          },
          "required": [
            "id",
            "feedback_id",
            "app_id",
            "text",
            "created_at",
            "acknowledged_at",
            "feedback"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "ok": {
        "const": true,
        "description": "Indicates success. Errors arrive as content with isError:true.",
        "type": "boolean"
      }
    },
    "required": [
      "ok",
      "items",
      "cursor"
    ],
    "type": "object"
  }
}
```

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.