{
  "openapi": "3.0.1",
  "info": {
    "title": "Real Estate MCP API - Sandra Serrano Lda",
    "version": "1.1",
    "description": "MCP 房地产上下文，用于搜索房产并提交联系请求。 - Sandra Serrano Lda",
    "termsOfService": "https://www.sandraserranorealestate.pt/termos-e-condicoes",
    "contact": {
      "name": "Sandra Serrano Lda",
      "url": "https://www.sandraserranorealestate.pt/",
      "email": "sandra.serrano@sandraserranorealestate.pt"
    },
    "x-company-info": {
      "name": "Sandra Serrano Lda",
      "ami": "20372",
      "address": "Rua Mato das Cruzadas 7, 2ºP - Quinta da Beloura II, 2710-701 Sintra"
    }
  },
  "servers": [
    {
      "url": "https://www.sandraserranorealestate.pt/",
      "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": "房产特征，包括设施、服务、附近兴趣点以及景观类型，用于提供完整详细的物业描述 (餐厅, 车库, 电梯, 公共交通, 公路, 建 议, 警察, 绿色空间, 生活室, 市中心, 特级超市, 停车场, 学校, 药店)"
          },
          {
            "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"
                }
              }
            }
          }
        }
      }
    }
  }
}