Rundum Immo Real Estate Appraisal
German property depreciation, purchase-price allocation, appraisal prices and bookings via AfAMax.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (4)
- HIGH
- LOWen calculate_property_depreciation
- LOWen calculate_purchase_price_allocation
- LOWen book_appointment
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"real-estate-appraisal": {
"command": "npx",
"args": [
"@rundum-immo/real-estate-appraisal-mcp"
]
}
}
}Paquetes ejecutables
0.2.0stdioPuntos de conexión remotos
https://mcp.rundum.immo/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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
}Comunidad
Evidencia