{
  "openapi": "3.0.1",
  "info": {
    "title": "Real Estate MCP API - Gaiphedra - Sociedade de Mediação Imobiliária, Lda",
    "version": "1.1",
    "description": "MCP 房地产上下文，用于搜索房产并提交联系请求。 - Gaiphedra - Sociedade de Mediação Imobiliária, Lda",
    "termsOfService": "https://www.gaiphedra.com/termos-e-condicoes",
    "contact": {
      "name": "Gaiphedra - Sociedade de Mediação Imobiliária, Lda",
      "url": "https://www.gaiphedra.com/",
      "email": "comercial@gaiphedra.com"
    },
    "x-company-info": {
      "name": "Gaiphedra - Sociedade de Mediação Imobiliária, Lda",
      "ami": "6338",
      "address": "Rua Manuel Moreira Costa Júnior, nº 4 sala BB, Valadares, 4405-571 Vila Nova Gaia, https://goo.gl/maps/924QeA7LyJE2 Vila Nova de Gaia"
    }
  },
  "servers": [
    {
      "url": "https://www.gaiphedra.com/",
      "description": "MCP 服务器标识符"
    }
  ],
  "components": {
    "schemas": {
      "searchToMatchRequest": {
        "type": "object",
        "properties": {
          "businessType": {
            "type": "string",
            "description": "定义或返回物业业务类型的标识符"
          },
          "countryName": {
            "type": "string",
            "description": "用作筛选条件的国家名称。当无法识别国家时，此字段必须保持为空。"
          },
          "stateName": {
            "type": "string",
            "description": "房产所在地区（区）的名称（如果未指定市/镇，则在搜索中为必填项）。"
          },
          "townName": {
            "type": "string",
            "description": "房产所在市/镇的名称（如果未指定区，则在搜索中为必填项）。"
          },
          "neighborhoodName": {
            "type": "string",
            "description": "房产所在街区或社区的名称或ID。"
          },
          "zoneName": {
            "type": "string",
            "description": "用于搜索过滤的地理区域标识符。"
          },
          "masterCategoryIds": {
            "type": "array",
            "description": "一个或多个主要房产类别组的标识符（ID）（例如公寓、房屋、仓库、土地、酒店）。如果未指定具体房产类型，则至少需要指定一个。"
          },
          "categoryIds": {
            "type": "array",
            "description": "一个或多个特定房产类别的标识符 (ID)（例如公寓、住宅、仓库、土地、酒店）。"
          },
          "condition": {
            "type": "string",
            "description": "状况状态。"
          },
          "minPrice": {
            "type": "integer",
            "description": "最低价格（欧元）。当用户指定最低预算或价格下限时填写。",
            "format": "int32"
          },
          "maxPrice": {
            "type": "integer",
            "description": "最高价格（欧元）。当用户指定最高预算或价格上限时填写。",
            "format": "int32"
          },
          "minBedrooms": {
            "type": "integer",
            "description": "用于筛选的最少卧室数量",
            "format": "int32"
          },
          "maxBedrooms": {
            "type": "integer",
            "description": "用于筛选的最多卧室数量",
            "format": "int32"
          },
          "bathrooms": {
            "type": "integer",
            "description": "最少浴室数量。",
            "format": "int32"
          },
          "listingReference": {
            "type": "string",
            "description": "用于标识房产的内部参考。"
          },
          "developmentName": {
            "type": "string",
            "description": "开发项目名称。"
          },
          "developmentFractions": {
            "type": "boolean",
            "description": "指示搜索是否应考虑项目中的单元（例如公寓或商铺），而不是整个项目。启用后，结果仅包含与项目关联的单元。"
          },
          "developmentTags": {
            "type": "array",
            "description": "用于筛选搜索结果的房地产开发项目标签。"
          },
          "withVideos": {
            "type": "boolean",
            "description": "仅搜索带有可用视频的房源。当用户提到“有视频”、“带视频”、“房源视频”、“在线看视频”等表达时适用。"
          },
          "withBluePrints": {
            "type": "boolean",
            "description": "仅搜索有可用平面图（blueprints）的房产。当用户提到“有平面图”、“房屋平面图”、“房产地图”、“楼层平面图”、“查看平面图”等时使用。"
          },
          "withVirtualVisits": {
            "type": "boolean",
            "description": "仅搜索提供虚拟看房的房源。适用于用户提到“虚拟看房”、“虚拟导览”、“3D 看房”、“互动看房”、“虚拟体验”、“虚拟视图”、“在线查看虚拟看房”等情况。"
          },
          "with360Photos": {
            "type": "boolean",
            "description": "仅搜索有可用360º照片的房产。当用户提到“有360º照片”、“提供360º照片”、“有全景照片”、“查看360º照片在线”等时使用。"
          },
          "featuresNames": {
            "type": "array",
            "description": "房产特征，包括设施、服务、附近兴趣点以及景观类型，用于提供完整详细的物业描述"
          },
          "page": {
            "type": "integer",
            "description": "搜索结果中返回的页码。",
            "format": "int32"
          }
        },
        "description": "描述房地产搜索输入参数的架构。"
      },
      "searchResponse": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "description": "当前页面的结果列表，基于每页的记录数量。",
            "items": {
              "$ref": "#/components/schemas/DetailResponse"
            }
          },
          "count": {
            "type": "integer",
            "description": "符合搜索条件的结果总数。",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "description": "根据搜索条件的当前页码。",
            "format": "int32"
          },
          "totalpages": {
            "type": "integer",
            "description": "符合搜索条件的页面总数。",
            "format": "int32"
          },
          "statetownnameequals": {
            "type": "boolean",
            "description": "指示地区名称是否与城市名称相同。"
          },
          "developmentname": {
            "type": "string",
            "description": "项目名称；仅当结果与具有此名称的特定项目相关时才会填充该字段。"
          }
        },
        "description": "描述房地产搜索输出参数的架构。"
      },
      "detailRequest": {
        "type": "object",
        "properties": {
          "listingId": {
            "type": "integer",
            "description": "用于联系的房产ID。",
            "format": "int32"
          },
          "listingReference": {
            "type": "string",
            "description": "用于标识房产的内部参考。"
          },
          "developmentFractions": {
            "type": "boolean",
            "description": "指示搜索是否应考虑项目中的单元（例如公寓或商铺），而不是整个项目。启用后，结果仅包含与项目关联的单元。"
          }
        },
        "description": "描述房地产详情输入参数的架构。"
      },
      "detailResponse": {
        "type": "object",
        "properties": {
          "listingId": {
            "type": "integer",
            "description": "房产列表的唯一ID。",
            "format": "int32"
          },
          "propertyType": {
            "type": "string",
            "description": "房产类型。"
          },
          "condition": {
            "type": "string",
            "description": "物业状况。"
          },
          "listingReference": {
            "type": "string",
            "description": "搜索结果中显示的物业参考编号。"
          },
          "firstPhoto": {
            "type": "string",
            "description": "物业第一张照片缩略图的 URL。"
          },
          "description": {
            "type": "string",
            "description": "物业详细描述。"
          },
          "title": {
            "type": "string",
            "description": "广告标题。"
          },
          "price": {
            "type": "string",
            "description": "价格（欧元）。"
          },
          "imiValue": {
            "type": "string",
            "description": "房产需缴纳的IMI金额，根据VPT和适用的税收规则计算。"
          },
          "business": {
            "type": "string",
            "description": "物业交易类型。"
          },
          "location": {
            "type": "string",
            "description": "位置名称。"
          },
          "bedrooms": {
            "type": "integer",
            "description": "房产卧室数量。",
            "format": "int32"
          },
          "bathrooms": {
            "type": "integer",
            "description": "房产浴室数量。",
            "format": "int32"
          },
          "url": {
            "type": "string",
            "description": "公告的公开URL。"
          },
          "hasVideos": {
            "type": "boolean",
            "description": "指示该房产是否有可用的视频。"
          },
          "hasBluePrints": {
            "type": "boolean",
            "description": "指示该房产是否有可用的平面图或蓝图。"
          },
          "has360Photos": {
            "type": "boolean",
            "description": "指示房产是否有可用的360°照片。"
          },
          "hasVirtualVisits": {
            "type": "boolean",
            "description": "指示房产是否有可用的虚拟参观或虚拟导览。"
          },
          "features": {
            "description": "这些键表示特定物业特征的描述，包括物理属性和相关位置，如游泳池、海景、靠近医院、学校及其他重要设施。这些信息有助于详细说明和评估物业，以根据用户偏好改进搜索过滤和结果展示。",
            "$ref": "#/components/schemas/Dictionary`2"
          }
        },
        "description": "描述房地产详情输出参数的架构。"
      },
      "leadRequest": {
        "type": "object",
        "properties": {
          "listingId": {
            "type": "integer",
            "description": "用于联系的房产ID。",
            "format": "int32"
          },
          "listingReference": {
            "type": "string",
            "description": "用于标识房产的内部参考。"
          },
          "name": {
            "type": "string",
            "description": "用户姓名。"
          },
          "email": {
            "type": "string",
            "description": "用户的电子邮件地址（如果未提供电话号码，则为必填）。"
          },
          "phone": {
            "type": "string",
            "description": "用户电话号码（如果提供电子邮件地址，可选）。"
          },
          "phoneCountryCode": {
            "type": "string",
            "description": "电话号码国家代码，包括加号，例如，葡萄牙为 \"+351\"，中国为 \"+86\"。"
          },
          "message": {
            "type": "string",
            "description": "用户自定义消息。"
          }
        },
        "description": "描述发送房地产leads输入参数的架构。"
      },
      "leadResponse": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "联系表单提交状态（例如：成功，错误）。"
          },
          "message": {
            "type": "string",
            "description": "描述联系表单提交结果的消息。"
          },
          "confirmedLead": {
            "type": "boolean",
            "description": ""
          }
        },
        "description": "描述发送房地产leads输出参数的架构。"
      },
      "companyInfoRequest": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "integer",
            "description": "要查询的公司/机构标识符（可选，默认为公司内部标识）。",
            "format": "int32"
          }
        },
        "description": "公司信息请求的输入模式"
      },
      "companyInfoWithAgenciesResponse": {
        "type": "object",
        "properties": {
          "headquarters": {
            "description": "与公司总部相关的公司联系方式信息。",
            "$ref": "#/components/schemas/CompanyInfoResponse"
          },
          "agencies": {
            "type": "array",
            "description": "公司各分支机构的联系方式信息。",
            "items": {
              "$ref": "#/components/schemas/CompanyInfoResponse"
            }
          }
        },
        "description": "公司信息数据的输出模式"
      },
      "companyInfoResponse": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "公司名称"
          },
          "phone": {
            "type": "string",
            "description": "公司电话号码"
          },
          "mobile": {
            "type": "string",
            "description": "公司手机号码"
          },
          "email": {
            "type": "string",
            "description": "公司联系电子邮箱"
          },
          "address": {
            "type": "string",
            "description": "公司地址（不含邮政编码）"
          },
          "district": {
            "type": "string",
            "description": "公司所在区/县"
          },
          "municipality": {
            "type": "string",
            "description": "公司所在市/区"
          },
          "parish": {
            "type": "string",
            "description": "公司所在教区"
          },
          "zipCode": {
            "type": "string",
            "description": "公司地址邮政编码"
          },
          "businessHours": {
            "type": "string",
            "description": "公司营业时间"
          },
          "googleMapsUrl": {
            "type": "string",
            "description": "公司在 Google 地图的直接链接"
          }
        },
        "description": "公司信息数据的输出模式"
      },
      "rasorInfoRequest": {
        "type": "object",
        "properties": {
          "rasorName": {
            "type": "string",
            "description": "需要获取其详细信息的房产顾问的姓名。"
          },
          "stateName": {
            "type": "string",
            "description": "允许按地区搜索顾问。"
          },
          "townName": {
            "type": "string",
            "description": "允许按市/镇搜索顾问。"
          }
        },
        "description": "用于请求房地产顾问详细信息的输入模式"
      },
      "rasorInfoResponse": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "房地产顾问的全名。"
          },
          "phone": {
            "type": "string",
            "description": "房地产顾问的固定电话。"
          },
          "mobile": {
            "type": "string",
            "description": "房地产顾问的手机号码。"
          },
          "observations": {
            "type": "string",
            "description": "与房地产顾问相关的附加备注。"
          },
          "email": {
            "type": "string",
            "description": "房地产顾问的电子邮箱地址。"
          },
          "address": {
            "type": "string",
            "description": "房地产顾问或办公室的完整地址。"
          },
          "city": {
            "type": "string",
            "description": "顾问工作的市/区。"
          },
          "parish": {
            "type": "string",
            "description": "顾问工作的教区/乡镇。"
          },
          "spokenLanguages": {
            "type": "array",
            "description": "顾问所说的语言列表。"
          },
          "socialProfiles": {
            "type": "array",
            "description": "顾问社交资料或页面的链接列表。",
            "items": {
              "$ref": "#/components/schemas/SocialProfile"
            }
          },
          "avatar": {
            "type": "string",
            "description": "与顾问关联的头像图片。"
          },
          "listingUrl": {
            "type": "string",
            "description": "显示所有分配给顾问或与其相关的房源的页面 URL，使您能够直接访问这些房源的完整列表。"
          },
          "detailUrl": {
            "type": "string",
            "description": "显示代理人完整信息的页面，包括联系方式、专业简介及其关联的房源。"
          }
        },
        "description": "顾问详细信息的输出模式"
      },
      "imiRequest": {
        "type": "object",
        "properties": {
          "townName": {
            "type": "string",
            "description": "房产所在市镇名称。此字段为地理识别和IMI税率确定的必填项。例如：\"里斯本\"、\"波尔图\"、\"辛特拉\"、\"阿尔布费拉\"。"
          },
          "taxableValue": {
            "type": "number",
            "description": "物业的应税资产价值（VPT），按葡萄牙税务机关登记的数值计算。这是用于计算 IMI 的官方财政价值。必须是以欧元表示的正数小数值。示例：\"185000.00\"。",
            "format": "decimal"
          },
          "dependentsNumber": {
            "type": "integer",
            "description": "纳税人在相关纳税年度的家庭中所拥有的受扶养人数。这包括儿童、年迈父母以及其他依法认可、可能享受 IMI 减免或免税的受扶养人。有效值：整数 ≥ 0。示例：“2”。",
            "format": "int32"
          },
          "isUrban": {
            "type": "boolean",
            "description": "指示物业是否被分类为城市或乡村。城市物业需缴纳IMI，而乡村物业可能适用不同的税收规则。示例：true/false。"
          }
        },
        "description": "用于请求计算物业市政税 (IMI) 的输入数据结构。"
      },
      "imiResponse": {
        "type": "object",
        "properties": {
          "townName": {
            "type": "string",
            "description": "用于计算IMI的市镇名称"
          },
          "taxableValue": {
            "type": "string",
            "description": "用于IMI计算的应税资产价值（VPT），以欧元表示"
          },
          "dependentsNumber": {
            "type": "string",
            "description": "在IMI计算中考虑的受抚养人数"
          },
          "isUrban": {
            "type": "string",
            "description": "标示该房产为城市或农村，用于IMI计算"
          },
          "imiValue": {
            "type": "string",
            "description": "根据提供的数据计算的最终IMI（市政房地产税）值。"
          },
          "imiTaxValue": {
            "type": "string",
            "description": "用于计算 IMI 的税率。"
          },
          "dependentDiscount": {
            "type": "string",
            "description": "基于受扶养人数的折扣金额。"
          },
          "dataYear": {
            "type": "integer",
            "description": "用于计算 IMI 的税率参考年份。",
            "format": "int32"
          }
        },
        "description": "输出数据结构，提供IMI计算结果，包括应支付金额的详细信息。"
      },
      "servicesInfoRequest": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "integer",
            "description": "要查询的公司/机构标识符（可选，默认为公司内部标识）。",
            "format": "int32"
          }
        },
        "description": "可用服务概述，包括其目的及对客户的应用。"
      },
      "servicesInfoResponse": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "integer",
            "description": "与服务目录关联的公司的唯一标识符。",
            "format": "int32"
          },
          "companyName": {
            "type": "string",
            "description": "提供服务目录的公司名称。"
          },
          "categories": {
            "type": "array",
            "description": "可用服务类别列表，按客户档案组织。",
            "items": {
              "$ref": "#/components/schemas/ServiceCategory"
            }
          }
        },
        "description": "提供给客户的服务概述，包括细节、范围和应用。"
      }
    }
  },
  "paths": {
    "/mcp/search": {
      "get": {
        "summary": "使用位置、价格、类型和状态等过滤器搜索房地产列表。",
        "description": "使用位置、价格、类型和状态等过滤器搜索房地产列表。",
        "operationId": "mcpSearch",
        "parameters": [
          {
            "name": "BusinessType",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "定义或返回物业业务类型的标识符 (出售, 租赁). 如果搜索中未指定，默认使用出售"
          },
          {
            "name": "CountryName",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用作筛选条件的国家名称。当无法识别国家时，此字段必须保持为空。, (is required)"
          },
          {
            "name": "StateName",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "房产所在地区（区）的名称（如果未指定市/镇，则在搜索中为必填项）。, (is required)"
          },
          {
            "name": "TownName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "房产所在市/镇的名称（如果未指定区，则在搜索中为必填项）。"
          },
          {
            "name": "NeighborhoodName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "房产所在街区或社区的名称或ID。"
          },
          {
            "name": "ZoneName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "用于搜索过滤的地理区域标识符。"
          },
          {
            "name": "MasterCategoryIds",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "一个或多个主要房产类别组的标识符（ID）（例如公寓、房屋、仓库、土地、酒店）。如果未指定具体房产类型，则至少需要指定一个。"
          },
          {
            "name": "CategoryIds",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "一个或多个特定房产类别的标识符 (ID)（例如公寓、住宅、仓库、土地、酒店）。"
          },
          {
            "name": "Condition",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "状况状态。 (Remodelled, Reserved, 不适用, 拆除或重建, 待售, 待装修, 二手的, 新的, 已装修, 在项目中, 正在施工之中, 重建计划)"
          },
          {
            "name": "MinPrice",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "最低价格（欧元）。当用户指定最低预算或价格下限时填写。"
          },
          {
            "name": "MaxPrice",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "最高价格（欧元）。当用户指定最高预算或价格上限时填写。"
          },
          {
            "name": "MinBedrooms",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "用于筛选的最少卧室数量"
          },
          {
            "name": "MaxBedrooms",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "用于筛选的最多卧室数量"
          },
          {
            "name": "Bathrooms",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "最少浴室数量。"
          },
          {
            "name": "ListingReference",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "用于标识房产的内部参考。"
          },
          {
            "name": "DevelopmentName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "开发项目名称。"
          },
          {
            "name": "DevelopmentFractions",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "指示搜索是否应考虑项目中的单元（例如公寓或商铺），而不是整个项目。启用后，结果仅包含与项目关联的单元。"
          },
          {
            "name": "DevelopmentTags",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "用于筛选搜索结果的房地产开发项目标签。 ()"
          },
          {
            "name": "WithVideos",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "仅搜索带有可用视频的房源。当用户提到“有视频”、“带视频”、“房源视频”、“在线看视频”等表达时适用。"
          },
          {
            "name": "WithBluePrints",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "仅搜索有可用平面图（blueprints）的房产。当用户提到“有平面图”、“房屋平面图”、“房产地图”、“楼层平面图”、“查看平面图”等时使用。"
          },
          {
            "name": "WithVirtualVisits",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "仅搜索提供虚拟看房的房源。适用于用户提到“虚拟看房”、“虚拟导览”、“3D 看房”、“互动看房”、“虚拟体验”、“虚拟视图”、“在线查看虚拟看房”等情况。"
          },
          {
            "name": "With360Photos",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "仅搜索有可用360º照片的房产。当用户提到“有360º照片”、“提供360º照片”、“有全景照片”、“查看360º照片在线”等时使用。"
          },
          {
            "name": "FeaturesNames",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "房产特征，包括设施、服务、附近兴趣点以及景观类型，用于提供完整详细的物业描述 (Airport, B. 巴 法, Closet, Dinning room, Ejendommen har kontor, Electric gate, Golf course, Kitcheette, Kitchen, Playroom, Plot, Porch, Sea port, Subway, Swimming pools, Trade Zone, 餐厅, 操场, 车库, 城市, 储物室, 地下室, 电力, 电梯, 房舍, 分析, 弗朗索树, 高尔夫球, 隔离, 工作人员变动室, 公共交通, 公共停车, 公共图书馆, 公共照明, 公路, 购物中心, 广泛的服务, 国家, 河, 河流, 湖, 花园, 会议室, 获得良好机会, 加 斯, 加油站, 建 议, 健身房, 郊区, 接受, 近海, 警报, 警察, 开放空间, 历史领域, 绿色空间, 评 注, 沙格尔·迪亚拉, 沙滩, 山, 生活室, 市场, 市中心, 水, 税率, 私人管道, 太阳能导向, 套房, 特级超市, 停车, 停车场, 图书馆, 洗衣房, 消防站, 协作, 学校, 药店, 医院, 银行, 智 利, 重点领域, 自然线, 最小的会议室)"
          },
          {
            "name": "Page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "搜索结果中返回的页码。"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResponse"
                }
              }
            }
          }
        }
      }
    },
    "/mcp/detail": {
      "get": {
        "summary": "获取房地产的详细信息。",
        "description": "获取房地产的详细信息。",
        "operationId": "mcpDetail",
        "parameters": [
          {
            "name": "ListingId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "用于联系的房产ID。"
          },
          {
            "name": "ListingReference",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "用于标识房产的内部参考。"
          },
          {
            "name": "DevelopmentFractions",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "指示搜索是否应考虑项目中的单元（例如公寓或商铺），而不是整个项目。启用后，结果仅包含与项目关联的单元。"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DetailResponse"
                }
              }
            }
          }
        }
      }
    },
    "/mcp/lead": {
      "get": {
        "summary": "为特定房源提交联系表单。",
        "description": "为特定房源提交联系表单。",
        "operationId": "mcpLead",
        "parameters": [
          {
            "name": "ListingId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "用于联系的房产ID。"
          },
          {
            "name": "ListingReference",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "用于标识房产的内部参考。"
          },
          {
            "name": "Name",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户姓名。, (is required)"
          },
          {
            "name": "Email",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户的电子邮件地址（如果未提供电话号码，则为必填）。, (is required)"
          },
          {
            "name": "Phone",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "用户电话号码（如果提供电子邮件地址，可选）。"
          },
          {
            "name": "PhoneCountryCode",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "电话号码国家代码，包括加号，例如，葡萄牙为 \"+351\"，中国为 \"+86\"。"
          },
          {
            "name": "Message",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "用户自定义消息。"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LeadResponse"
                }
              }
            }
          }
        }
      }
    },
    "/mcp/companyinfo": {
      "get": {
        "summary": "允许检索公司的联系方式，包括代理机构名称、地址、电话号码和电子邮件。非常适合显示机构信息或让用户能够联系代理机构。",
        "description": "允许检索公司的联系方式，包括代理机构名称、地址、电话号码和电子邮件。非常适合显示机构信息或让用户能够联系代理机构。",
        "operationId": "mcpCompanyInfo",
        "parameters": [
          {
            "name": "CompanyId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "要查询的公司/机构标识符（可选，默认为公司内部标识）。"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanyInfoWithAgenciesResponse"
                }
              }
            }
          }
        }
      }
    },
    "/mcp/rasorinfo": {
      "get": {
        "summary": "允许检索房地产顾问的联系方式，包括姓名、电话、电子邮件和地址。非常适合显示顾问联系信息或让用户能够联系他。",
        "description": "允许检索房地产顾问的联系方式，包括姓名、电话、电子邮件和地址。非常适合显示顾问联系信息或让用户能够联系他。",
        "operationId": "mcpRasorInfo",
        "parameters": [
          {
            "name": "RasorName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "需要获取其详细信息的房产顾问的姓名。"
          },
          {
            "name": "StateName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "允许按地区搜索顾问。"
          },
          {
            "name": "TownName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "允许按市/镇搜索顾问。"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RasorInfoResponse"
                }
              }
            }
          }
        }
      }
    },
    "/mcp/imicalculator": {
      "get": {
        "summary": "允许根据用户提供的数据确定市政物业税（IMI）的金额。该服务验证指定的市镇，确定适用系数，处理应税财产价值（VPT）、受抚养人数及房产性质（城市或农村），并返回根据葡萄牙现行税法应支付的最终IMI金额。",
        "description": "允许根据用户提供的数据确定市政物业税（IMI）的金额。该服务验证指定的市镇，确定适用系数，处理应税财产价值（VPT）、受抚养人数及房产性质（城市或农村），并返回根据葡萄牙现行税法应支付的最终IMI金额。",
        "operationId": "mcpImiCalculator",
        "parameters": [
          {
            "name": "TownName",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "房产所在市镇名称。此字段为地理识别和IMI税率确定的必填项。例如：\"里斯本\"、\"波尔图\"、\"辛特拉\"、\"阿尔布费拉\"。"
          },
          {
            "name": "TaxableValue",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number",
              "format": "decimal"
            },
            "description": "物业的应税资产价值（VPT），按葡萄牙税务机关登记的数值计算。这是用于计算 IMI 的官方财政价值。必须是以欧元表示的正数小数值。示例：\"185000.00\"。"
          },
          {
            "name": "DependentsNumber",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "纳税人在相关纳税年度的家庭中所拥有的受扶养人数。这包括儿童、年迈父母以及其他依法认可、可能享受 IMI 减免或免税的受扶养人。有效值：整数 ≥ 0。示例：“2”。"
          },
          {
            "name": "IsUrban",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean"
            },
            "description": "指示物业是否被分类为城市或乡村。城市物业需缴纳IMI，而乡村物业可能适用不同的税收规则。示例：true/false。"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IMIResponse"
                }
              }
            }
          }
        }
      }
    },
    "/mcp/servicesinfo": {
      "get": {
        "summary": "提供关于客户资料可用服务的完整信息的端点描述。",
        "description": "提供关于客户资料可用服务的完整信息的端点描述。",
        "operationId": "mcpServicesInfo",
        "parameters": [
          {
            "name": "CompanyId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "description": "要查询的公司/机构标识符（可选，默认为公司内部标识）。"
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServicesInfoResponse"
                }
              }
            }
          }
        }
      }
    }
  }
}