Submit App Feedback

Record agent-authored feedback about a Charming app.

MCP name: submit_feedback

Tool contract

{
  "annotations": {
    "destructiveHint": false,
    "openWorldHint": false,
    "readOnlyHint": false,
    "title": "Submit App Feedback"
  },
  "description": "Record agent-authored feedback about a Charming app. Use this to log observed bugs, suggested enhancements, caught crash reports, or qualitative notes. Source is server-enforced to \"agent\" — agents cannot impersonate user or auto-crash sources. The caller must own the app.",
  "execution": {
    "taskSupport": "forbidden"
  },
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "properties": {
      "app_id": {
        "description": "The app ID (UUID) the feedback is attached 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"
      },
      "category": {
        "description": "Feedback category. One of: bug, crash, enhancement, praise, other. Pass \"crash\" only when crash_data carries the captured error.",
        "enum": [
          "bug",
          "crash",
          "enhancement",
          "praise",
          "other"
        ],
        "type": "string"
      },
      "crash_data": {
        "description": "Required when category=crash. Optional otherwise.",
        "properties": {
          "message": {
            "description": "Error message; required when category=crash.",
            "type": "string"
          },
          "stack": {
            "type": "string"
          },
          "traceId": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "userAgent": {
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "type": "object"
      },
      "structured_data": {
        "additionalProperties": {},
        "description": "Optional JSON object with caller-supplied structured context (e.g. route, repro inputs).",
        "propertyNames": {
          "type": "string"
        },
        "type": "object"
      },
      "text": {
        "description": "Free-form feedback body (up to 16384 chars). Optional, but at least one of text / structured_data / crash_data should usually be set so the row is actionable.",
        "maxLength": 16384,
        "type": "string"
      }
    },
    "required": [
      "app_id",
      "category"
    ],
    "type": "object"
  },
  "name": "submit_feedback",
  "outputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "app_id": {
        "description": "UUID of the app the feedback was attached to.",
        "type": "string"
      },
      "created_at": {
        "description": "ISO-8601 timestamp when the row was inserted.",
        "type": "string"
      },
      "id": {
        "description": "UUID of the newly-inserted feedback row.",
        "type": "string"
      },
      "ok": {
        "const": true,
        "description": "Indicates success. Errors arrive as content with isError:true.",
        "type": "boolean"
      }
    },
    "required": [
      "ok",
      "id",
      "app_id",
      "created_at"
    ],
    "type": "object"
  }
}