RealMarket Survey Builder MCP

{
  "type": "object",
  "required": [
    "product",
    "category",
    "objective",
    "audience",
    "business_question"
  ],
  "properties": {
    "product": {
      "type": "string",
      "pattern": "\\S",
      "maxLength": 120,
      "minLength": 1,
      "description": "Product or brand supplied by the user, e.g. Acme cereal. Preserve its name."
    },
    "audience": {
      "enum": [
        "category_buyers",
        "brand_buyers",
        "competitor_buyers",
        "never_buyers",
        "previous_brand_buyers"
      ],
      "type": "string",
      "description": "category_buyers: category purchase in past 3 months; brand_buyers: brand purchase in that period; competitor_buyers: other brands but not this brand in that period, possibly former brand buyers; never_buyers: recent category buyers who never bought the brand; previous_brand_buyers: any past brand purchase, even without recent category purchases. Repeat purchase excludes never_buyers; non_buyers excludes brand_buyers and previous_brand_buyers."
    },
    "category": {
      "type": "string",
      "pattern": "\\S",
      "maxLength": 120,
      "minLength": 1,
      "description": "Consumer product category, e.g. breakfast cereal. Ask if missing or ambiguous."
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Required for pricing, including extra topics. User-supplied three-letter uppercase code, e.g. USD; no conversion."
    },
    "objective": {
      "enum": [
        "packaging",
        "product_launch",
        "pricing",
        "repeat_purchase",
        "purchase_frequency",
        "non_buyers",
        "brand_perception"
      ],
      "type": "string",
      "description": "Map the user's goal to one supported objective; brand_perception is a value, not a tool name."
    },
    "extra_topics": {
      "type": "array",
      "items": {
        "enum": [
          "packaging",
          "product_launch",
          "pricing",
          "repeat_purchase",
          "purchase_frequency",
          "non_buyers",
          "brand_perception"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "description": "Only additional topics requested by the user. Same audience restrictions apply as for the primary objective; complete blocks may be omitted at 15 questions.",
      "uniqueItems": true
    },
    "product_unit": {
      "type": "string",
      "pattern": "\\S",
      "maxLength": 120,
      "minLength": 1,
      "description": "Required for pricing, including extra topics. User-supplied unit, e.g. 500 g pack."
    },
    "business_question": {
      "type": "string",
      "pattern": "\\S",
      "maxLength": 400,
      "minLength": 10,
      "description": "Short user-provided research decision or question. Recorded as context, not interpreted by the server."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "title",
    "business_question",
    "goal",
    "screening",
    "sections",
    "question_count",
    "omitted_topics",
    "fieldwork_notes",
    "limitations"
  ],
  "properties": {
    "goal": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "topic",
          "title",
          "instructions",
          "questions"
        ],
        "properties": {
          "title": {
            "type": "string",
            "minLength": 1
          },
          "topic": {
            "type": "string",
            "minLength": 1
          },
          "questions": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "number",
                "text",
                "answer_format",
                "purpose"
              ],
              "properties": {
                "text": {
                  "type": "string",
                  "minLength": 1
                },
                "number": {
                  "type": "integer",
                  "maximum": 15,
                  "minimum": 1
                },
                "purpose": {
                  "type": "string",
                  "minLength": 1
                },
                "answer_format": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "additionalProperties": false
            },
            "minItems": 1
          },
          "instructions": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "minItems": 1
    },
    "screening": {
      "type": "string"
    },
    "limitations": {
      "type": "string"
    },
    "omitted_topics": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "question_count": {
      "type": "integer",
      "maximum": 15,
      "minimum": 1
    },
    "fieldwork_notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "business_question": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "title": "Build a consumer questionnaire",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}