Rundum Immo Real Estate Appraisal
German property depreciation, purchase-price allocation, appraisal prices and bookings via AfAMax.
我該用這個嗎
品質與安全性
A
發現項目（4）
- HIGHTool poisoning patterns detected
- LOWTool 'calculate_property_depreciation' name length outside 3-30 range在 calculate_property_depreciation 中
- LOWTool 'calculate_purchase_price_allocation' name length outside 3-30 range在 calculate_purchase_price_allocation 中
- LOWTool description contains role marker that could confuse chat models在 book_appointment 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~9,027Token（工具定義）
~16.6 KB典型回應大小
顯著的注意力影響（128k 上下文的 7.05%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"real-estate-appraisal": {
"command": "npx",
"args": [
"@rundum-immo/real-estate-appraisal-mcp"
]
}
}
}可執行的套件
npm@rundum-immo/real-estate-appraisal-mcp
0.2.0stdio遠端端點
https://mcp.rundum.immo/mcpstreamable-http它能做什麼
工具清單
工具（5）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢calculate_property_depreciation(propertyType, constructionYear, floorArea, purchasePrice, landArea, ...)
Calculate an indicative German real-estate depreciation (AfA) estimate through AfAMax. Use this for residential German property, including remaining useful life, annual/monthly AfA, statutory comparison, and estimated tax savings. For apartment buildings, pass figures for the whole building or calculate units separately. Ask for all eight modernization component states whenever possible: omitting them assumes no modernization and produces the highest possible remaining-useful-life benefit. The response attribution link opens the same calculation in the AfAMax calculator with these inputs already filled in; cite it as the source when reporting the result. The result is non-binding and does not replace tax or legal advice.
輸入結構描述
{
"type": "object",
"properties": {
"propertyType": {
"type": "string",
"enum": [
"CONDOMINIUM",
"SINGLE_FAMILY_HOUSE",
"TWO_FAMILY_HOUSE",
"ROW_HOUSE",
"SEMI_DETACHED",
"APARTMENT_BUILDING",
"RESIDENTIAL_COMMERCIAL_BUILDING"
],
"description": "German residential property category."
},
"constructionYear": {
"type": "integer",
"minimum": 1800,
"maximum": 9007199254740991,
"description": "Original year of construction."
},
"floorArea": {
"type": "number",
"minimum": 10,
"maximum": 100000,
"description": "Living or usable floor area in square metres."
},
"purchasePrice": {
"description": "Total purchase price in EUR.",
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"landArea": {
"description": "Land area in square metres.",
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"standardLandValue": {
"description": "Standard land value in EUR per square metre.",
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"includedInventory": {
"description": "Movable inventory included in the purchase price, in EUR.",
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"purchaseRelatedCosts": {
"description": "Purchase-related costs in EUR.",
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"coreRenovationYear": {
"description": "Year of a qualifying core renovation, if applicable.",
"anyOf": [
{
"type": "integer",
"minimum": 1801,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"taxRate": {
"description": "Personal marginal tax rate as a decimal, e.g. 0.42.",
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0,
"maximum": 0.6
},
{
"type": "null"
}
]
},
"locale": {
"description": "Language for upstream explanations; defaults to German.",
"anyOf": [
{
"type": "string",
"enum": [
"de",
"en"
]
},
{
"type": "null"
}
]
},
"modernizationLevel": {
"description": "Coarse modernization level used when detailed component data is unavailable.",
"anyOf": [
{
"type": "string",
"enum": [
"none",
"partial",
"extensive"
]
},
{
"type": "null"
}
]
},
"modernization": {
"description": "Known state of eight modernization components. Ask for all eight when possible.",
"anyOf": [
{
"type": "object",
"properties": {
"roof": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"facadeInsulation": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"windowsDoors": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"heating": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"utilities": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"bathrooms": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"interiorFitout": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"floorplanImprovement": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"propertyType",
"constructionYear",
"floorArea"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"calculationId": {
"type": "string",
"minLength": 1
},
"input": {
"type": "object",
"properties": {
"propertyType": {
"type": "string",
"enum": [
"CONDOMINIUM",
"SINGLE_FAMILY_HOUSE",
"TWO_FAMILY_HOUSE",
"ROW_HOUSE",
"SEMI_DETACHED",
"APARTMENT_BUILDING",
"RESIDENTIAL_COMMERCIAL_BUILDING"
]
},
"constructionYear": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"floorArea": {
"type": "number"
},
"purchasePrice": {
"type": [
"number",
"null"
]
},
"landArea": {
"type": [
"number",
"null"
]
},
"standardLandValue": {
"type": [
"number",
"null"
]
},
"includedInventory": {
"type": [
"number",
"null"
]
},
"purchaseRelatedCosts": {
"type": [
"number",
"null"
]
},
"coreRenovationYear": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"taxRate": {
"type": "number"
},
"locale": {
"type": "string",
"enum": [
"de",
"en"
]
},
"modernization": {
"type": "object",
"properties": {
"roof": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"facadeInsulation": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"windowsDoors": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"heating": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"utilities": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"bathrooms": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"interiorFitout": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
},
"floorplanImprovement": {
"type": "string",
"enum": [
"NOT_MODERNIZED",
"SLIGHTLY_MODERNIZED",
"PARTIALLY_MODERNIZED",
"MOSTLY_MODERNIZED",
"FULLY_MODERNIZED"
]
}
},
"required": [
"roof",
"facadeInsulation",
"windowsDoors",
"heating",
"utilities",
"bathrooms",
"interiorFitout",
"floorplanImprovement"
],
"additionalProperties": false
}
},
"required": [
"propertyType",
"constructionYear",
"floorArea",
"purchasePrice",
"landArea",
"standardLandValue",
"includedInventory",
"purchaseRelatedCosts",
"coreRenovationYear",
"taxRate",
"locale",
"modernization"
],
"additionalProperties": false
},
"results": {
"type": "object",
"properties": {
"afaRatePerYear": {
"type": "number"
},
"defaultAfaRatePerYear": {
"type": "number"
},
"annualAfaAmount": {
"type": "number"
},
"defaultAfaAmount": {
"type": "number"
},
"monthlyAfaAmount": {
"type": "number"
},
"annualTaxSavings": {
"type": "number"
},
"appraisalWorthwhile": {
"type": "boolean"
},
"monthlyTaxSavings": {
"type": "number"
},
"buildingValue": {
"type": "number"
},
"buildingValueSource": {
"type": "string",
"enum": [
"actual",
"assumed"
]
},
"taxRate": {
"type": "number"
},
"remainingUsefulLifeYears": {
"type": "number"
},
"modernizationPointsUsed": {
"type": "number",
"minimum": 0,
"maximum": 20
},
"currency": {
"type": "string",
"const": "EUR"
}
},
"required": [
"afaRatePerYear",
"defaultAfaRatePerYear",
"annualAfaAmount",
"defaultAfaAmount",
"monthlyAfaAmount",
"annualTaxSavings",
"appraisalWorthwhile",
"monthlyTaxSavings",
"buildingValue",
"buildingValueSource",
"taxRate",
"remainingUsefulLifeYears",
"modernizationPointsUsed",
"currency"
],
"additionalProperties": false
},
"assumptions": {
"type": "object",
"properties": {
"modernizationAssumedNone": {
"type": "boolean"
},
"buildingValueAssumed": {
"type": "boolean"
},
"taxRateAssumed": {
"type": "boolean"
}
},
"required": [
"modernizationAssumedNone",
"buildingValueAssumed",
"taxRateAssumed"
],
"additionalProperties": false
},
"attribution": {
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"AfaMax",
"AfAMax"
]
},
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string"
}
},
"required": [
"provider",
"url",
"label"
],
"additionalProperties": false
},
"disclaimer": {
"type": "string"
},
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string"
},
"calculationMethod": {
"type": "string"
},
"calculatedAt": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"required": [
"apiVersion",
"calculationMethod",
"calculatedAt"
],
"additionalProperties": false
}
},
"required": [
"calculationId",
"input",
"results",
"assumptions",
"attribution",
"disclaimer",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢calculate_purchase_price_allocation(propertyType, totalPurchasePrice, purchaseRelatedCosts, includedInventory, purchaseDate, ...)
Calculate a free, non-binding German property purchase-price allocation (Kaufpreisaufteilung) through AfAMax using the BMF Arbeitshilfe. Use this to divide acquisition costs between non-depreciable land and the depreciable building. Inventory is deducted before allocation. A condominium requires both co-ownership values, and a residential/commercial building requires its commercial share category. Comparative valuation is unavailable because this public contract excludes surveyor-only factors. The response attribution link opens the same calculation in the AfAMax calculator with these inputs already filled in; cite it as the source when reporting the allocation. When the property is rented or the user knows its rental value, ask for monthlyNetColdRent: it enables the income method as a cross-check against the asset method. Ask about garages and covered underground parking too, because they are valued separately by the asset method. Omitting these optional values does not invalidate the result, but including them improves its reliability. The result does not replace tax or legal advice.
輸入結構描述
{
"type": "object",
"properties": {
"propertyType": {
"type": "string",
"enum": [
"CONDOMINIUM",
"SINGLE_FAMILY_HOUSE",
"TWO_FAMILY_HOUSE",
"ROW_HOUSE",
"SEMI_DETACHED",
"APARTMENT_BUILDING",
"RESIDENTIAL_COMMERCIAL_BUILDING"
],
"description": "German residential property category."
},
"totalPurchasePrice": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Total notarized purchase price in EUR."
},
"purchaseRelatedCosts": {
"description": "Land transfer tax, notary, land-register, and broker costs in EUR. Defaults to 0.",
"type": "number",
"minimum": 0
},
"includedInventory": {
"description": "Movable inventory included in the purchase price, in EUR. It is deducted before allocation.",
"type": "number",
"minimum": 0
},
"purchaseDate": {
"type": "string",
"description": "Date of the notarized purchase contract in YYYY-MM-DD format; must be from 1990-01-01 through today."
},
"constructionYear": {
"type": "integer",
"minimum": 1800,
"maximum": 9007199254740991,
"description": "Original construction year; it cannot be later than the purchase year."
},
"floorArea": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Living or usable floor area in square metres."
},
"landArea": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Plot area in square metres."
},
"standardLandValue": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Standard land value (Bodenrichtwert) in EUR per square metre."
},
"commercialShare": {
"description": "Required for RESIDENTIAL_COMMERCIAL_BUILDING: whether the commercial share is under or over 50%.",
"type": "string",
"enum": [
"under_50",
"over_50"
]
},
"coOwnershipNumerator": {
"description": "Co-ownership numerator (Miteigentumsanteil); required with the denominator for a condominium.",
"type": "number",
"exclusiveMinimum": 0
},
"coOwnershipDenominator": {
"description": "Co-ownership denominator; required with the numerator for a condominium.",
"type": "number",
"exclusiveMinimum": 0
},
"garages": {
"description": "Number of above-ground garages. Improves the asset-method allocation by valuing parking separately. Ask the user if the property includes garages.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"undergroundParkingSpaces": {
"description": "Number of covered underground parking spaces. Improves the asset-method allocation by valuing parking separately. Ask the user if the property includes underground parking.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"monthlyNetColdRent": {
"description": "Monthly net cold rent (base rent excluding utilities, in EUR). Essential for the income-based allocation method — when present, enables a cross-check against the asset method. Ask the user if the property is rented or if they know the rental value.",
"type": "number",
"minimum": 0
},
"locale": {
"description": "Language for the disclaimer and AfAMax attribution link. Defaults to German.",
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"required": [
"propertyType",
"totalPurchasePrice",
"purchaseDate",
"constructionYear",
"floorArea",
"landArea",
"standardLandValue"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"calculationId": {
"type": "string",
"minLength": 1
},
"input": {
"type": "object",
"properties": {
"propertyType": {
"type": "string",
"enum": [
"CONDOMINIUM",
"SINGLE_FAMILY_HOUSE",
"TWO_FAMILY_HOUSE",
"ROW_HOUSE",
"SEMI_DETACHED",
"APARTMENT_BUILDING",
"RESIDENTIAL_COMMERCIAL_BUILDING"
]
},
"totalPurchasePrice": {
"type": "number"
},
"purchasePrice": {
"type": "number",
"description": "Property price after deducting included inventory."
},
"purchaseRelatedCosts": {
"type": "number"
},
"includedInventory": {
"type": "number"
},
"purchaseDate": {
"type": "string"
},
"constructionYear": {
"type": "number"
},
"floorArea": {
"type": "number"
},
"landArea": {
"type": "number"
},
"standardLandValue": {
"type": "number"
},
"commercialShare": {
"anyOf": [
{
"type": "string",
"enum": [
"under_50",
"over_50"
]
},
{
"type": "null"
}
]
},
"coOwnershipNumerator": {
"type": [
"number",
"null"
]
},
"coOwnershipDenominator": {
"type": [
"number",
"null"
]
},
"garages": {
"type": "number"
},
"undergroundParkingSpaces": {
"type": "number"
},
"monthlyNetColdRent": {
"type": [
"number",
"null"
]
},
"locale": {
"type": "string",
"enum": [
"de",
"en"
]
}
},
"required": [
"propertyType",
"totalPurchasePrice",
"purchasePrice",
"purchaseRelatedCosts",
"includedInventory",
"purchaseDate",
"constructionYear",
"floorArea",
"landArea",
"standardLandValue",
"commercialShare",
"coOwnershipNumerator",
"coOwnershipDenominator",
"garages",
"undergroundParkingSpaces",
"monthlyNetColdRent",
"locale"
],
"additionalProperties": false
},
"applied": {
"type": "object",
"properties": {
"method": {
"type": "string",
"enum": [
"comparative",
"income",
"asset"
]
},
"landValue": {
"type": "number"
},
"buildingValue": {
"type": "number"
},
"totalValue": {
"type": "number"
},
"buildingShare": {
"type": "number"
},
"totalAcquisitionCost": {
"type": "number"
},
"depreciationBase": {
"type": "number"
},
"landAllocation": {
"type": "number"
},
"currency": {
"type": "string",
"const": "EUR"
}
},
"required": [
"method",
"landValue",
"buildingValue",
"totalValue",
"buildingShare",
"totalAcquisitionCost",
"depreciationBase",
"landAllocation",
"currency"
],
"additionalProperties": false
},
"methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"method": {
"type": "string",
"enum": [
"comparative",
"income",
"asset"
]
},
"landValue": {
"type": "number"
},
"buildingValue": {
"type": "number"
},
"totalValue": {
"type": "number"
},
"buildingShare": {
"type": "number"
},
"totalAcquisitionCost": {
"type": "number"
},
"depreciationBase": {
"type": "number"
},
"landAllocation": {
"type": "number"
},
"currency": {
"type": "string",
"const": "EUR"
}
},
"required": [
"method",
"landValue",
"buildingValue",
"totalValue",
"buildingShare",
"totalAcquisitionCost",
"depreciationBase",
"landAllocation",
"currency"
],
"additionalProperties": false
}
},
"skipped": {
"type": "array",
"items": {
"type": "object",
"properties": {
"method": {
"type": "string",
"enum": [
"comparative",
"income",
"asset"
]
},
"missing": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"method",
"missing"
],
"additionalProperties": false
}
},
"degenerate": {
"type": "array",
"items": {
"type": "object",
"properties": {
"method": {
"type": "string",
"enum": [
"comparative",
"income",
"asset"
]
},
"reason": {
"type": "string",
"enum": [
"operating-costs-exceed-rent",
"income-below-land-interest",
"no-building-value"
]
}
},
"required": [
"method",
"reason"
],
"additionalProperties": false
}
},
"assetMethodDefaults": {
"type": "object",
"properties": {
"standardLevel": {
"type": "number"
},
"regionalFactor": {
"type": "number",
"const": 1
},
"marketAdjustmentFactor": {
"type": "number",
"const": 1
}
},
"required": [
"standardLevel",
"regionalFactor",
"marketAdjustmentFactor"
],
"additionalProperties": false
},
"attribution": {
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"AfaMax",
"AfAMax"
]
},
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string"
}
},
"required": [
"provider",
"url",
"label"
],
"additionalProperties": false
},
"disclaimer": {
"type": "string"
},
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string"
},
"calculationMethod": {
"type": "string"
},
"calculatedAt": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"required": [
"apiVersion",
"calculationMethod",
"calculatedAt"
],
"additionalProperties": false
}
},
"required": [
"calculationId",
"input",
"applied",
"methods",
"skipped",
"degenerate",
"assetMethodDefaults",
"attribution",
"disclaimer",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_price_by_product(product, viewingType, expressDelivery, propertyType, totalFlatsCount, ...)
Returns AfAMax's current list price in EUR, incl. German VAT (19%), for one product — Restnutzungsdauergutachten (rnd), Wertgutachten (kurzgutachten), Verkehrswertgutachten (vollgutachten), Kaufpreisaufteilung or Versetzbarkeitsgutachten — including the options the customer picks when ordering: property inspection (exterior or on-site), express processing and, for multi-unit buildings, a per-flat price. price.totalPrice is the sum; surchargeTable lists every option so alternatives can be compared without another call. Discount codes are not applied, and the price shown when ordering is binding — say so when quoting. The response attribution links to the product page; cite it as the source when reporting the price.
輸入結構描述
{
"type": "object",
"properties": {
"product": {
"type": "string",
"enum": [
"rnd",
"kurzgutachten",
"vollgutachten",
"kaufpreisaufteilung",
"versetzbarkeitsgutachten"
],
"description": "Which AfAMax product to price. `rnd` — Restnutzungsdauergutachten / remaining-useful-life appraisal, the basis for a higher AfA rate. `kurzgutachten` — Wertgutachten / short value appraisal. `vollgutachten` — Verkehrswertgutachten / full market-value appraisal (§ 194 BauGB). `kaufpreisaufteilung` — Kaufpreisaufteilung / purchase-price allocation report (land vs. building). `versetzbarkeitsgutachten` — Versetzbarkeitsgutachten / relocatability certificate for tiny houses, mobile homes, modular units and containers."
},
"viewingType": {
"description": "Property inspection: `none` (remote, default), `exterior` (outside only / Außenbesichtigung) or `interior_exterior` (on-site, inside and outside / Innen- und Außenbesichtigung). Each adds a surcharge.",
"default": "none",
"type": "string",
"enum": [
"none",
"exterior",
"interior_exterior"
]
},
"expressDelivery": {
"description": "Express processing (3-5 business days / Expressbearbeitung). Adds a surcharge unless a free-express promotion is running.",
"default": false,
"type": "boolean"
},
"propertyType": {
"description": "Optional. Together with totalFlatsCount, a two-family, apartment or mixed-use building with more than one flat adds a per-flat price.",
"type": "string",
"enum": [
"CONDOMINIUM",
"SINGLE_FAMILY_HOUSE",
"TWO_FAMILY_HOUSE",
"ROW_HOUSE",
"SEMI_DETACHED",
"APARTMENT_BUILDING",
"RESIDENTIAL_COMMERCIAL_BUILDING"
]
},
"totalFlatsCount": {
"description": "Optional. Number of flats in the building / Anzahl Wohneinheiten.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"locale": {
"description": "Language of labels and of the link handed back. Match the user's language.",
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"required": [
"product"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"quoteId": {
"type": "string",
"minLength": 1
},
"product": {
"type": "string",
"enum": [
"rnd",
"kurzgutachten",
"vollgutachten",
"kaufpreisaufteilung",
"versetzbarkeitsgutachten"
]
},
"productLabel": {
"type": "string"
},
"currency": {
"type": "string",
"const": "EUR"
},
"input": {
"type": "object",
"properties": {
"viewingType": {
"type": "string",
"enum": [
"none",
"exterior",
"interior_exterior"
]
},
"expressDelivery": {
"type": "boolean"
},
"propertyType": {
"anyOf": [
{
"type": "string",
"enum": [
"CONDOMINIUM",
"SINGLE_FAMILY_HOUSE",
"TWO_FAMILY_HOUSE",
"ROW_HOUSE",
"SEMI_DETACHED",
"APARTMENT_BUILDING",
"RESIDENTIAL_COMMERCIAL_BUILDING"
]
},
{
"type": "null"
}
]
},
"totalFlatsCount": {
"type": [
"number",
"null"
]
}
},
"required": [
"viewingType",
"expressDelivery",
"propertyType",
"totalFlatsCount"
],
"additionalProperties": false
},
"price": {
"type": "object",
"properties": {
"basePrice": {
"type": "number"
},
"viewingSurcharge": {
"type": "number"
},
"expressSurcharge": {
"type": "number"
},
"freeExpressPromotionApplied": {
"type": "boolean"
},
"additionalPricePerUnit": {
"type": "number"
},
"additionalUnitsPrice": {
"type": "number"
},
"totalPrice": {
"type": "number",
"description": "Sum of all amounts above. Every amount in `price` is gross, incl. German VAT."
},
"vatIncluded": {
"type": "boolean",
"const": true
},
"vatRate": {
"type": "number",
"description": "The German VAT rate included in the amounts, in percent."
},
"totalNetPrice": {
"type": "number"
}
},
"required": [
"basePrice",
"viewingSurcharge",
"expressSurcharge",
"freeExpressPromotionApplied",
"additionalPricePerUnit",
"additionalUnitsPrice",
"totalPrice",
"vatIncluded",
"vatRate",
"totalNetPrice"
],
"additionalProperties": false
},
"surchargeTable": {
"type": "object",
"properties": {
"exteriorViewing": {
"type": "number"
},
"interiorExteriorViewing": {
"type": "number"
},
"express": {
"type": "number"
},
"perAdditionalFlat": {
"type": "number"
}
},
"required": [
"exteriorViewing",
"interiorExteriorViewing",
"express",
"perAdditionalFlat"
],
"additionalProperties": false
},
"attribution": {
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"AfaMax",
"AfAMax"
]
},
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string"
}
},
"required": [
"provider",
"url",
"label"
],
"additionalProperties": false
},
"disclaimer": {
"type": "string"
},
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string"
},
"generatedAt": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"required": [
"apiVersion",
"generatedAt"
],
"additionalProperties": false
}
},
"required": [
"quoteId",
"product",
"productLabel",
"currency",
"input",
"price",
"surchargeTable",
"attribution",
"disclaimer",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_available_appointments(from, days, maxSlotsPerDay, locale)
Lists open slots for a free, non-binding 15-minute initial phone call with the AfAMax team (Erstgespräch), on weekdays in the Europe/Berlin time zone, grouped by day. Each day lists a sample spread across the day (maxSlotsPerDay, default 8) and its freeSlotCount; for a specific time, call again for that day with days: 1 and maxSlotsPerDay: 32. Show the user the day and localTime; to book one, pass its startDateTime unchanged to book_appointment. Slots are live and can be taken at any time, so re-check rather than reusing an old list. The response attribution links to the contact page, where the user can also book directly.
輸入結構描述
{
"type": "object",
"properties": {
"from": {
"description": "ISO 8601 date-time to start looking from. Defaults to now. / Frühester Zeitpunkt.",
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"days": {
"description": "How many calendar days to look ahead (1-21, default 7). / Anzahl Tage.",
"type": "integer",
"minimum": 1,
"maximum": 21
},
"maxSlotsPerDay": {
"description": "How many slots to list per day (1-32, default 8), spread evenly across the day. When the user wants a specific time, call again for that day with `days: 1` and `maxSlotsPerDay: 32`.",
"type": "integer",
"minimum": 1,
"maximum": 32
},
"locale": {
"description": "Language of the link handed back and the response labels. Match the user's language (most users are German-speaking).",
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"requestId": {
"type": "string",
"minLength": 1
},
"appointmentType": {
"type": "string",
"const": "initial_call"
},
"description": {
"type": "string"
},
"days": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Date in Europe/Berlin, YYYY-MM-DD."
},
"weekday": {
"type": "string"
},
"freeSlotCount": {
"type": "number",
"description": "All free slots that day — can exceed `slots`, which is capped by maxSlotsPerDay."
},
"slots": {
"type": "array",
"items": {
"type": "object",
"properties": {
"startDateTime": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"description": "Slot start in UTC — pass this unchanged to book_appointment."
},
"localTime": {
"type": "string",
"description": "Start time in Europe/Berlin, HH:mm — show this to the user."
}
},
"required": [
"startDateTime",
"localTime"
],
"additionalProperties": false
}
}
},
"required": [
"date",
"weekday",
"freeSlotCount",
"slots"
],
"additionalProperties": false
}
},
"timeZone": {
"type": "string"
},
"durationMinutes": {
"type": "number"
},
"attribution": {
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"AfaMax",
"AfAMax"
]
},
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string"
}
},
"required": [
"provider",
"url",
"label"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string"
},
"generatedAt": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"required": [
"apiVersion",
"generatedAt"
],
"additionalProperties": false
}
},
"required": [
"requestId",
"appointmentType",
"description",
"days",
"timeZone",
"durationMinutes",
"attribution",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢book_appointment(startDateTime, name, email, phone, verificationId, ...)
Books a free 15-minute initial phone call with the AfAMax team, in two steps. STEP 1: after the user picked a slot from get_available_appointments, confirm the slot, their name and their own e-mail address with them, then call with startDateTime, name, email (and optionally phone, locale). AfAMax e-mails a 6-digit code to that address and returns status "verification_required" with a verificationId. STEP 2: ask the user for the code from that e-mail and call again with only verificationId and otp. The code proves the address belongs to the user: use only the code the user gives you — never guess, invent or repeatedly retry codes. On success status is "booked" and a calendar invitation goes to the user. Codes expire after 15 minutes and allow 5 attempts. If the slot was taken meanwhile, list slots again and offer another. If the e-mail belongs to an existing AfAMax account, the user must log in and book on the website (link in the error). Only book for the person you are talking to.
輸入結構描述
{
"type": "object",
"properties": {
"startDateTime": {
"description": "Step 1 — the chosen slot, copied exactly from get_available_appointments `startDateTime`.",
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"name": {
"description": "Step 1 — the user's full name. / Vor- und Nachname.",
"type": "string",
"minLength": 2,
"maxLength": 80
},
"email": {
"description": "Step 1 — the user's own e-mail address; the 6-digit confirmation code is sent there. Confirm it with the user before calling. / E-Mail-Adresse für den Bestätigungscode.",
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"phone": {
"description": "Step 1, optional — phone number for the call. / Telefonnummer für das Gespräch.",
"type": "string",
"maxLength": 40
},
"verificationId": {
"description": "Step 2 — the `verificationId` returned by step 1.",
"type": "string",
"minLength": 1,
"maxLength": 64
},
"otp": {
"description": "Step 2 — the 6-digit code the user received by e-mail. Only ever the code the user gives you; never guess or retry codes. / Der 6-stellige Code aus der E-Mail.",
"type": "string",
"pattern": "^\\d{6}$"
},
"locale": {
"description": "Step 1 — language of the confirmation e-mail, the appointment and the links (`de` if omitted); match the user's language. Step 2 keeps step 1's language unless set. / Sprache der E-Mails und des Termins.",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"requestId": {
"type": "string",
"minLength": 1
},
"status": {
"type": "string",
"enum": [
"verification_required",
"booked"
],
"description": "`verification_required`: ask the user for the code sent to `verification.maskedEmail`, then call again with verificationId + otp. `booked`: the appointment exists."
},
"verification": {
"anyOf": [
{
"type": "object",
"properties": {
"verificationId": {
"type": "string"
},
"maskedEmail": {
"type": "string"
},
"expiresAt": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"required": [
"verificationId",
"maskedEmail",
"expiresAt"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"appointment": {
"anyOf": [
{
"type": "object",
"properties": {
"startDateTime": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"endDateTime": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"localDate": {
"type": "string"
},
"localTime": {
"type": "string"
},
"timeZone": {
"type": "string"
},
"durationMinutes": {
"type": "number"
},
"customerInviteSent": {
"type": "boolean"
}
},
"required": [
"startDateTime",
"endDateTime",
"localDate",
"localTime",
"timeZone",
"durationMinutes",
"customerInviteSent"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"attribution": {
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"AfaMax",
"AfAMax"
]
},
"url": {
"type": "string",
"format": "uri"
},
"label": {
"type": "string"
}
},
"required": [
"provider",
"url",
"label"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string"
},
"generatedAt": {
"type": "string",
"format": "date-time",
"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])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"required": [
"apiVersion",
"generatedAt"
],
"additionalProperties": false
}
},
"required": [
"requestId",
"status",
"verification",
"appointment",
"attribution",
"meta"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}社群
證據
近期觀測
已驗證未記錄版本5 個工具
已驗證未記錄版本2 個工具
已驗證未記錄版本2 個工具