{
  "id": "mrscraper.china-southern.flights",
  "object": "tool",
  "name": "China Southern Fare Search",
  "summary": "Search China Southern Airlines fares between two airports for a departure date.",
  "description": "Query China Southern Airlines for flights between two IATA airport codes on a date. Returns the itinerary list with departure segments, return segments where present, and available fare options. Takes passenger counts, fare class, locale, and currency. Suited for airline-direct fare monitoring and China route research.\n\nRaw mrscraper#/china-southern/flights endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://docs.mrscraper.com/docs/features/marketplace).",
  "category": "lookup",
  "hosted_by": "MrScraper",
  "runtime": "partner",
  "side_effects": false,
  "status": "live",
  "credits": 0,
  "price": null,
  "providers": [
    {
      "id": "mrscraper",
      "name": "MrScraper",
      "price": null,
      "own_key_only": true
    }
  ],
  "mcp_name": "mrscraper_china-southern_flights",
  "input_schema": {
    "type": "object",
    "properties": {
      "body": {
        "type": "object",
        "properties": {
          "origin": {
            "type": "string",
            "pattern": "^[A-Za-z]{3}$",
            "description": "Departure airport IATA code, e.g. 'BKK'."
          },
          "dest": {
            "type": "string",
            "pattern": "^[A-Za-z]{3}$",
            "description": "Destination airport IATA code, e.g. 'CGK'."
          },
          "adult": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991,
            "description": "Number of adult passengers."
          },
          "child": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Number of child passengers."
          },
          "infant": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Number of infant passengers."
          },
          "dptDate": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Departure date in YYYY-MM-DD format."
          },
          "fareClass": {
            "type": "string",
            "enum": [
              "economy",
              "business"
            ],
            "description": "Travel class."
          },
          "locale": {
            "type": "string",
            "minLength": 2,
            "description": "Locale for returned content, e.g. 'en-US'."
          },
          "currency": {
            "type": "string",
            "minLength": 3,
            "maxLength": 3,
            "description": "Three-letter currency code for returned prices, e.g. 'USD'."
          }
        },
        "required": [
          "origin",
          "dest",
          "adult",
          "child",
          "infant",
          "dptDate",
          "fareClass",
          "locale",
          "currency"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "body"
    ],
    "additionalProperties": false
  },
  "kind": "endpoint"
}