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 rangecalculate_property_depreciation 内
- LOWTool 'calculate_purchase_price_allocation' name length outside 3-30 rangecalculate_purchase_price_allocation 内
- LOWTool description contains role marker that could confuse chat modelsbook_appointment 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~9,027トークン数（ツール定義）
~16.6 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 7.05%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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 件