Rundum Immo Real Estate Appraisal

German property depreciation, purchase-price allocation, appraisal prices and bookings via AfAMax.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
93%
Calidad de los nombres
88%
Riesgo de envenenamiento
80%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (4)

  • HIGHTool poisoning patterns detected
  • LOWTool 'calculate_property_depreciation' name length outside 3-30 rangeen calculate_property_depreciation
  • LOWTool 'calculate_purchase_price_allocation' name length outside 3-30 rangeen calculate_purchase_price_allocation
  • LOWTool description contains role marker that could confuse chat modelsen book_appointment

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~9,027Tokens (definiciones de herramientas)
~16.6 KBTamaño de respuesta típico
Impacto significativo en la atención (7.05% del contexto de 128k)

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

npm@rundum-immo/real-estate-appraisal-mcp0.2.0stdio

Puntos de conexión remotos

https://mcp.rundum.immo/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (5)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada5 herramientas
verificadoversión no registrada2 herramientas
verificadoversión no registrada2 herramientas