{
  "meta": {
    "attribution": "Anchor Terminal (https://www.anchorterminal.com)",
    "attributionRequired": true,
    "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)",
    "docs": "https://www.anchorterminal.com/docs/",
    "generatedAt": "2026-11-16",
    "license": "CC-BY-4.0",
    "method": "https://www.anchorterminal.com/benchmark/",
    "methodology": "0.8",
    "openapi": "https://www.anchorterminal.com/openapi.json",
    "preview": false,
    "run": "2026-10-01",
    "runLabel": "October 2026 research run",
    "terms": "https://www.anchorterminal.com/terms/#data"
  },
  "tool": {
    "category": "",
    "endpoint": "https://flatin.pt/mcp",
    "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/flatin-property-taxes.json",
    "kind": "mcp",
    "listed": "indexed",
    "liveUrl": "https://www.anchorterminal.com/api/v1/live/flatin-property-taxes.json",
    "markdownUrl": "https://www.anchorterminal.com/tools/flatin-property-taxes.md",
    "mcpTools": {
      "check": {
        "checker": "anchor-check/1.0",
        "totalTokens": 12827,
        "counts": {
          "error": 0,
          "note": 0,
          "warn": 0
        },
        "findings": []
      },
      "checkedAt": "2026-11-16T04:05:49Z",
      "count": 15,
      "schemaTokens": 12827,
      "status": "ok",
      "tools": [
        {
          "name": "imt_calculate",
          "title": "Calculate IMT and stamp duty on a home purchase",
          "description": "Use this when asked what a home purchase in Portugal costs on top of the price: IMT, stamp duty and Casa Pronta registration, by the 2026 tables. Do not use it for the yearly property tax (`imi_annual_cost`) or to define a term such as VPT (`glossary_lookup`). Both taxes are charged on the higher of `value` and `vpt`: pass the VPT when known. `tax_haven_company` takes precedence over `non_resident`. `buyer_is_young` applies only when `primary_home` is true. For a non-resident buyer the answer says what the Tax Authority annuls later on request.",
          "inputSchema": {
            "properties": {
              "buyer_is_young": {
                "default": false,
                "description": "The buyer is 35 or under on the date of the deed, is buying their first own permanent home, is not an IRS dependant and has owned no residential property in the previous three years. Applies the reduced IMT table and the stamp duty deduction (art. 7.º-A Código do Imposto do Selo; not applied above the second band of the young buyers' table). Only applies when primary_home is true; with primary_home false it is ignored",
                "type": "boolean"
              },
              "non_resident": {
                "default": false,
                "description": "The buyer is not and has never been tax resident in Portugal. IMT is then a flat rate with no exemption or reduction — no zero band, no young buyers' table, no stamp duty deduction (CIMT art. 17.º n.º 10); the result says what the Tax Authority annuls on request if the buyer becomes tax resident or lets the home at a moderate rent. A buyer who has already been treated as tax resident pays by the tables: leave it false",
                "type": "boolean"
              },
              "primary_home": {
                "default": true,
                "description": "The buyer's own permanent home (habitação própria e permanente); false for a second home or an investment, which has no zero band",
                "type": "boolean"
              },
              "tax_haven_company": {
                "default": false,
                "description": "The buyer is a company or other entity with its tax domicile in a country, territory or region on the Portuguese list of more favourable tax regimes, or controlled directly or indirectly by such an entity. IMT is then 10 % with no exemption or reduction (CIMT art. 17.º n.º 4), whether or not it is resident, and it overrides non_resident. Never true for an individual (n.º 7)",
                "type": "boolean"
              },
              "territory": {
                "default": "continente",
                "description": "Mainland Portugal (continente) or the Azores and Madeira (regioes_autonomas), which have their own IMT tables",
                "enum": [
                  "continente",
                  "regioes_autonomas"
                ],
                "type": "string"
              },
              "value": {
                "description": "Purchase price as written in the contract, in euros; a dot or a space may group thousands (250.000)",
                "examples": [
                  "250000",
                  "250000.50",
                  "250.000"
                ],
                "type": "string"
              },
              "vpt": {
                "description": "Optional. The VPT (valor patrimonial tributário) from the caderneta predial, in euros. IMT and stamp duty are charged on the higher of the price and the VPT (CIMT art. 12.º n.º 1), so pass it when it is known",
                "examples": [
                  "180000"
                ],
                "type": "string"
              }
            },
            "required": [
              "value"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "properties": {
                  "annullable": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "attribution": {
                    "type": "object"
                  },
                  "deed_source": {
                    "type": "object"
                  },
                  "formatted": {
                    "type": "object"
                  },
                  "imt_cents": {
                    "description": "Euro cents (integer)",
                    "type": "integer"
                  },
                  "imt_regime": {
                    "description": "Which IMT rule was applied",
                    "type": "string"
                  },
                  "input": {
                    "type": "object"
                  },
                  "notary_estimate_cents": {
                    "description": "Euro cents: Casa Pronta registration price",
                    "type": "integer"
                  },
                  "notes": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "stamp_duty_cents": {
                    "description": "Euro cents, after relief",
                    "type": "integer"
                  },
                  "stamp_duty_relief_cents": {
                    "description": "Euro cents (integer)",
                    "type": "integer"
                  },
                  "taxable_base": {
                    "type": "string"
                  },
                  "taxable_value_cents": {
                    "description": "Euro cents: the higher of price and VPT",
                    "type": "integer"
                  },
                  "total_cents": {
                    "description": "Euro cents on top of the price",
                    "type": "integer"
                  }
                },
                "required": [
                  "input",
                  "imt_regime",
                  "annullable",
                  "taxable_value_cents",
                  "taxable_base",
                  "imt_cents",
                  "stamp_duty_cents",
                  "stamp_duty_relief_cents",
                  "notary_estimate_cents",
                  "total_cents",
                  "formatted",
                  "notes",
                  "attribution",
                  "deed_source"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "error": {
                    "type": "string"
                  },
                  "field": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": "string"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Calculate IMT and stamp duty on a home purchase"
          }
        },
        {
          "name": "required_income",
          "title": "Income and savings needed to buy a home at a price",
          "description": "Use this when asked what net monthly income and savings it takes to buy a home in Portugal at a given price, under the Banco de Portugal rules. Do not use it for the purchase taxes alone (`imt_calculate`).",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {
              "price": {
                "description": "Price of the home in euros; a dot or a space may group thousands (250.000). Fixed scenario: buyer aged 30, own permanent home, 40-year loan, 10 % deposit, IMT Jovem, market rate",
                "examples": [
                  "250000",
                  "385000.50"
                ],
                "type": "string"
              },
              "territory": {
                "default": "continente",
                "description": "Mainland Portugal (continente) or the Azores and Madeira (regioes_autonomas), which have their own IMT tables",
                "enum": [
                  "continente",
                  "regioes_autonomas"
                ],
                "type": "string"
              }
            },
            "required": [
              "price"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "formatted": {
                    "type": "object"
                  },
                  "min_net_monthly_income_cents": {
                    "description": "Euro cents: minimum NET monthly income of the borrowers",
                    "type": "integer"
                  },
                  "monthly_cents": {
                    "description": "Euro cents: monthly payment",
                    "type": "integer"
                  },
                  "price_cents": {
                    "description": "Euro cents (integer)",
                    "type": "integer"
                  },
                  "rate": {
                    "type": "object"
                  },
                  "rules_provenance": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "savings_needed_cents": {
                    "description": "Euro cents: deposit, taxes, registration, loan stamp",
                    "type": "integer"
                  },
                  "scenario": {
                    "type": "object"
                  },
                  "territory": {
                    "type": "string"
                  }
                },
                "required": [
                  "price_cents",
                  "territory",
                  "min_net_monthly_income_cents",
                  "savings_needed_cents",
                  "monthly_cents",
                  "scenario",
                  "rate",
                  "rules_provenance",
                  "formatted",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "error": {
                    "type": "string"
                  },
                  "field": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": "string"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Income and savings needed to buy a home at a price"
          }
        },
        {
          "name": "imi_rate",
          "title": "Look up the IMI rate of a municipality",
          "description": "Use this when only the yearly IMI (municipal property tax) rate of one Portuguese municipality is needed, by name or code, with its history by year. Do not use it for the yearly amount on a VPT (`imi_annual_cost`) or for several municipalities side by side (`compare_municipalities`). Rates: Autoridade Tributária portal, all 308 municipalities. Where the rate is set per parish, the answer says so instead of giving a number.",
          "inputSchema": {
            "properties": {
              "municipality": {
                "description": "Municipality name (Porto, Lisboa or Lisbon, Vila Nova de Gaia) or its four-digit code (1312)",
                "examples": [
                  "Porto",
                  "Lisbon",
                  "1312"
                ],
                "type": "string"
              }
            },
            "required": [
              "municipality"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "codigo": {
                    "description": "Four-digit Tax Authority code",
                    "type": "string"
                  },
                  "distrito": {
                    "type": "string"
                  },
                  "history": {
                    "type": "object"
                  },
                  "municipality": {
                    "type": "string"
                  },
                  "rural": {
                    "type": "object"
                  },
                  "urban": {
                    "type": "object"
                  },
                  "year": {
                    "type": "integer"
                  }
                },
                "required": [
                  "codigo",
                  "municipality",
                  "distrito",
                  "urban",
                  "rural",
                  "year",
                  "history",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "description": "Refusal (isError: true). `error` is a machine code (not_found, bad_*, tool_failed…), `message` says what to fix.",
                "properties": {
                  "error": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Look up the IMI rate of a municipality"
          }
        },
        {
          "name": "imi_annual_cost",
          "title": "Calculate the yearly IMI from the taxable value",
          "description": "Use this when the yearly IMI amount on an urban property (prédio urbano) is needed, from its taxable value (VPT) and its municipality's urban rate. Do not use it for the rate alone (`imi_rate`) or for the one-off purchase taxes (`imt_calculate`). The VPT is the Tax Authority's valuation on the caderneta predial, not the price: ask the user for it. Only the urban rate is applied; rural property, AIMI and surcharges on vacant homes are not calculated. A municipality whose rate is set per parish is refused (rate_by_freguesia).",
          "inputSchema": {
            "properties": {
              "municipality": {
                "description": "Municipality name (Porto, Lisboa or Lisbon, Vila Nova de Gaia) or its four-digit code (1312)",
                "examples": [
                  "Porto",
                  "Lisbon",
                  "1312"
                ],
                "type": "string"
              },
              "vpt": {
                "description": "Valor Patrimonial Tributário — the taxable value of the property in euros, from the caderneta predial. Not the purchase price",
                "examples": [
                  "150000",
                  "92.540,37"
                ],
                "type": "string"
              }
            },
            "required": [
              "municipality",
              "vpt"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "properties": {
                  "annual_cents": {
                    "description": "Euro cents: yearly IMI",
                    "type": "integer"
                  },
                  "attribution": {
                    "type": "object"
                  },
                  "codigo": {
                    "description": "Four-digit Tax Authority code",
                    "type": "string"
                  },
                  "distrito": {
                    "type": "string"
                  },
                  "history": {
                    "type": "object"
                  },
                  "municipality": {
                    "type": "string"
                  },
                  "rural": {
                    "type": "object"
                  },
                  "urban": {
                    "type": "object"
                  },
                  "vpt_cents": {
                    "description": "Euro cents: the VPT given",
                    "type": "integer"
                  },
                  "year": {
                    "type": "integer"
                  }
                },
                "required": [
                  "codigo",
                  "municipality",
                  "distrito",
                  "urban",
                  "rural",
                  "year",
                  "history",
                  "attribution",
                  "vpt_cents",
                  "annual_cents"
                ],
                "type": "object"
              },
              {
                "description": "Refusal rate_by_freguesia: the municipality's rate row, no yearly sum.",
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "codigo": {
                    "description": "Four-digit Tax Authority code",
                    "type": "string"
                  },
                  "distrito": {
                    "type": "string"
                  },
                  "error": {
                    "type": "string"
                  },
                  "history": {
                    "type": "object"
                  },
                  "municipality": {
                    "type": "string"
                  },
                  "rural": {
                    "type": "object"
                  },
                  "urban": {
                    "type": "object"
                  },
                  "year": {
                    "type": "integer"
                  }
                },
                "required": [
                  "codigo",
                  "municipality",
                  "distrito",
                  "urban",
                  "rural",
                  "year",
                  "history",
                  "attribution",
                  "error"
                ],
                "type": "object"
              },
              {
                "description": "Refusal (isError: true). `error` is a machine code (not_found, bad_*, tool_failed…), `message` says what to fix.",
                "properties": {
                  "error": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Calculate the yearly IMI from the taxable value"
          }
        },
        {
          "name": "request_consultation",
          "title": "Prepare a request to flatin.pt, a licensed estate agency",
          "description": "Use this when the person wants flatin.pt (licensed estate agency, AMI 28163) to contact them about buying a new-build apartment in Portugal. Do not use it to send the request (`submit_consultation`) or for emails about new projects (`subscribe_digest`). mode=link returns the form link and the consent text; mode=prepare checks the details and returns a summary, the GDPR (RGPD) consent text and a confirmation_token. Nothing is sent.",
          "inputSchema": {
            "properties": {
              "budget": {
                "deprecated": true,
                "description": "Deprecated: use budget_max. Read as budget_max when budget_min and budget_max are both empty",
                "type": "integer"
              },
              "budget_band": {
                "deprecated": true,
                "description": "Deprecated: use budget_min and budget_max. An old band (0-250k, 250-400k, 400-600k, 600k+), read as its range when both are empty",
                "examples": [
                  "250-400k"
                ],
                "type": "string"
              },
              "budget_max": {
                "description": "Optional. Upper end of the budget in whole euros; if lower than budget_min, the two are swapped",
                "examples": [
                  400000
                ],
                "type": "integer"
              },
              "budget_min": {
                "description": "Optional. Lower end of the budget in whole euros",
                "examples": [
                  250000
                ],
                "type": "integer"
              },
              "channel": {
                "description": "How the person wants to be contacted on that phone",
                "enum": [
                  "whatsapp",
                  "telegram",
                  "call"
                ],
                "type": "string"
              },
              "city": {
                "description": "Older name for places: one place. Merged with places, city first",
                "examples": [
                  "Porto"
                ],
                "type": "string"
              },
              "client": {
                "description": "Optional. Your app's host or name: recorded as the request's source",
                "examples": [
                  "claude.ai",
                  "chatgpt.com"
                ],
                "type": "string"
              },
              "deal_type": {
                "deprecated": true,
                "description": "Deprecated and ignored: every request is to buy",
                "examples": [
                  "buy"
                ],
                "type": "string"
              },
              "email": {
                "description": "Only if the person gives no phone",
                "examples": [
                  "maria@example.com"
                ],
                "format": "email",
                "type": "string"
              },
              "intent": {
                "description": "Optional. visit and reserve only with a project on sale, notify only with a project not yet on sale",
                "enum": [
                  "info",
                  "callback",
                  "visit",
                  "reserve",
                  "notify"
                ],
                "type": "string"
              },
              "language": {
                "default": "en",
                "description": "The person's language: the consent text, the emails and the page links come in it. Another value is refused, except in mode=link, which falls back to English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "message": {
                "description": "Optional. The person's own words",
                "examples": [
                  "Close to the metro, with a balcony"
                ],
                "maxLength": 2000,
                "type": "string"
              },
              "mode": {
                "default": "link",
                "description": "link: only the form link and the consent text. prepare: check the details, get a summary, the consent text and a confirmation_token for submit_consultation; nothing is sent",
                "enum": [
                  "link",
                  "prepare"
                ],
                "type": "string"
              },
              "name": {
                "description": "The person's name",
                "examples": [
                  "Maria Silva"
                ],
                "maxLength": 120,
                "type": "string"
              },
              "phone": {
                "description": "Phone in international format. Preferred over email",
                "examples": [
                  "+351 912 345 678"
                ],
                "type": "string"
              },
              "places": {
                "description": "Where the person wants to buy: municipalities in Portugal (Lisboa or Lisbon) or districts, most important first. At least one place, unless project is given (the project's municipality comes first then)",
                "examples": [
                  [
                    "Porto",
                    "Matosinhos"
                  ]
                ],
                "items": {
                  "type": "string"
                },
                "maxItems": 20,
                "type": "array"
              },
              "preferred_time": {
                "description": "Optional, with intent=visit: when suits the person",
                "examples": [
                  "weekday mornings"
                ],
                "maxLength": 120,
                "type": "string"
              },
              "project": {
                "description": "Optional. Slug of the development the request is about: the slug field of search_newbuilds",
                "type": "string"
              },
              "property_type": {
                "deprecated": true,
                "description": "Deprecated and ignored: every request is for a new-build apartment",
                "examples": [
                  "apartment"
                ],
                "type": "string"
              },
              "typology": {
                "description": "Optional. Bedroom counts wanted (T2 = two bedrooms)",
                "items": {
                  "enum": [
                    "T0",
                    "T1",
                    "T2",
                    "T3",
                    "T4+"
                  ],
                  "type": "string"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "description": "mode=link: the form link and the consent text; nothing is sent.",
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "consent_language": {
                    "type": "string"
                  },
                  "consent_text": {
                    "type": "string"
                  },
                  "consent_text_version": {
                    "type": "string"
                  },
                  "consent_version": {
                    "description": "Same as consent_text_version",
                    "type": "string"
                  },
                  "form_url": {
                    "description": "Absolute URL",
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string"
                  },
                  "what_happens_next": {
                    "type": "string"
                  }
                },
                "required": [
                  "mode",
                  "form_url",
                  "consent_text",
                  "consent_text_version",
                  "consent_language",
                  "consent_version",
                  "what_happens_next",
                  "language",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "description": "mode=prepare: summary, consent text and token; nothing is sent.",
                "properties": {
                  "confirmation_token": {
                    "type": "string"
                  },
                  "consent_language": {
                    "type": "string"
                  },
                  "consent_text": {
                    "type": "string"
                  },
                  "consent_text_version": {
                    "type": "string"
                  },
                  "expires_in_seconds": {
                    "type": "integer"
                  },
                  "mode": {
                    "type": "string"
                  },
                  "summary": {
                    "type": "object"
                  },
                  "what_happens_next": {
                    "type": "string"
                  }
                },
                "required": [
                  "mode",
                  "summary",
                  "consent_text",
                  "consent_text_version",
                  "consent_language",
                  "confirmation_token",
                  "expires_in_seconds",
                  "what_happens_next"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "consent_language": {
                    "type": "string"
                  },
                  "consent_text": {
                    "type": "string"
                  },
                  "consent_text_version": {
                    "type": "string"
                  },
                  "error": {
                    "type": "string"
                  },
                  "field": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "problems": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "retry_after_seconds": {
                    "type": "integer"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Prepare a request to flatin.pt, a licensed estate agency"
          }
        },
        {
          "name": "submit_consultation",
          "title": "Send a prepared request to flatin.pt",
          "description": "Use this when the person has read the summary and consent text from `request_consultation` mode=prepare and explicitly agreed to send the request. Do not use it before that (`request_consultation`). Pass the same details, the token, consent=true and consent_text_version; never set consent=true on your own. Changed details, a token under 5 seconds or over 30 minutes old, or an outdated consent version are refused.",
          "inputSchema": {
            "properties": {
              "budget": {
                "deprecated": true,
                "description": "As in prepare",
                "type": "integer"
              },
              "budget_band": {
                "deprecated": true,
                "description": "As in prepare",
                "type": "string"
              },
              "budget_max": {
                "description": "As in prepare",
                "type": "integer"
              },
              "budget_min": {
                "description": "As in prepare",
                "type": "integer"
              },
              "channel": {
                "description": "As in prepare",
                "enum": [
                  "whatsapp",
                  "telegram",
                  "call"
                ],
                "type": "string"
              },
              "city": {
                "description": "As in prepare",
                "type": "string"
              },
              "client": {
                "description": "As in prepare",
                "type": "string"
              },
              "confirmation_token": {
                "description": "The token returned by request_consultation mode=prepare",
                "type": "string"
              },
              "consent": {
                "description": "true once the person has read the consent text returned by mode=prepare and explicitly agreed",
                "type": "boolean"
              },
              "consent_text_version": {
                "description": "consent_text_version returned by mode=prepare",
                "type": "string"
              },
              "deal_type": {
                "deprecated": true,
                "description": "As in prepare",
                "type": "string"
              },
              "email": {
                "description": "As in prepare",
                "format": "email",
                "type": "string"
              },
              "intent": {
                "description": "As in prepare",
                "enum": [
                  "info",
                  "callback",
                  "visit",
                  "reserve",
                  "notify"
                ],
                "type": "string"
              },
              "language": {
                "default": "en",
                "description": "As in prepare",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "message": {
                "description": "As in prepare",
                "type": "string"
              },
              "name": {
                "description": "As in prepare",
                "type": "string"
              },
              "phone": {
                "description": "As in prepare",
                "type": "string"
              },
              "places": {
                "description": "As in prepare",
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "preferred_time": {
                "description": "As in prepare",
                "type": "string"
              },
              "project": {
                "description": "As in prepare",
                "type": "string"
              },
              "property_type": {
                "deprecated": true,
                "description": "As in prepare",
                "type": "string"
              },
              "typology": {
                "description": "As in prepare",
                "items": {
                  "enum": [
                    "T0",
                    "T1",
                    "T2",
                    "T3",
                    "T4+"
                  ],
                  "type": "string"
                },
                "type": "array"
              }
            },
            "required": [
              "confirmation_token",
              "consent",
              "consent_text_version"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "description": "submit_consultation: the request was received; flatin.pt answers it.",
                "properties": {
                  "mode": {
                    "type": "string"
                  },
                  "privacy_policy": {
                    "description": "Absolute URL",
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "what_happens_next": {
                    "type": "string"
                  }
                },
                "required": [
                  "mode",
                  "status",
                  "what_happens_next",
                  "privacy_policy"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "consent_language": {
                    "type": "string"
                  },
                  "consent_text": {
                    "type": "string"
                  },
                  "consent_text_version": {
                    "type": "string"
                  },
                  "error": {
                    "type": "string"
                  },
                  "field": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "problems": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "retry_after_seconds": {
                    "type": "integer"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": false,
            "title": "Send a prepared request to flatin.pt"
          }
        },
        {
          "name": "subscribe_digest",
          "title": "Subscribe an email to new developments or construction",
          "description": "Use this when the person asks to be emailed about new-build projects matching a filter (daily) or new construction licensed in one municipality (weekly). Do not use it to have flatin.pt contact them (`request_consultation`) or to see what is on sale now (`search_newbuilds`). Ask the person first; nothing is active until they click the confirmation email. `city` is required for construction and `parish` works only there; `typology`, the prices and `on_sale` work only with new_developments. The answer is the same whether or not the address was already subscribed: never say it was.",
          "inputSchema": {
            "properties": {
              "city": {
                "description": "Municipality (Lisboa or Lisbon). Required for construction; empty means all of Portugal for new_developments",
                "examples": [
                  "Porto",
                  "Vila Nova de Gaia"
                ],
                "type": "string"
              },
              "client": {
                "description": "Optional. Your app's host or name: recorded as the request's source",
                "examples": [
                  "claude.ai",
                  "chatgpt.com"
                ],
                "type": "string"
              },
              "email": {
                "description": "The person's email address",
                "examples": [
                  "maria@example.com"
                ],
                "format": "email",
                "type": "string"
              },
              "language": {
                "default": "en",
                "description": "The person's language: the consent text and the emails come in it. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "on_sale": {
                "description": "Optional, new_developments: only developments on sale",
                "type": "boolean"
              },
              "parish": {
                "description": "Optional, construction only: a parish (freguesia) of that municipality",
                "examples": [
                  "Paranhos"
                ],
                "type": "string"
              },
              "price_max": {
                "description": "Optional, new_developments: maximum price in euros",
                "type": "integer"
              },
              "price_min": {
                "description": "Optional, new_developments: minimum price in euros",
                "type": "integer"
              },
              "typology": {
                "description": "Optional. Bedroom counts wanted (T2 = two bedrooms)",
                "items": {
                  "enum": [
                    "T0",
                    "T1",
                    "T2",
                    "T3",
                    "T4+"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "what": {
                "default": "new_developments",
                "description": "new_developments: new-build developments matching the filter, daily email when something new appears. construction: newly licensed construction in a municipality (\"what is being built\"), weekly",
                "enum": [
                  "new_developments",
                  "construction"
                ],
                "type": "string"
              }
            },
            "required": [
              "email"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "description": "Always the same, whatever the address's state: a confirmation email was requested; nothing is active until the person clicks it.",
                "properties": {
                  "confirm_within_days": {
                    "type": "integer"
                  },
                  "consent_text": {
                    "type": "string"
                  },
                  "consent_text_version": {
                    "type": "string"
                  },
                  "frequency": {
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "scope": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "what": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "what",
                  "scope",
                  "frequency",
                  "confirm_within_days",
                  "consent_text",
                  "consent_text_version",
                  "language"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "error": {
                    "type": "string"
                  },
                  "field": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "problems": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "retry_after_seconds": {
                    "type": "integer"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": false,
            "title": "Subscribe an email to new developments or construction"
          }
        },
        {
          "name": "where_to_live",
          "title": "Where to live in a Portuguese city, area by area",
          "description": "Use this when the person is choosing a neighbourhood: a flatin.pt city guide's verdict area by area, with the reason, who each area suits and the sources. Do not use it for one municipality's figures (`municipality_stats`) or for new homes there (`search_newbuilds`). Without `city` it lists the cities and regions that have a guide. `profile` narrows the areas but never hides the ones we advise against. Noise and safety come as dated, sourced facts: a place's reputation, never a claim about its people. Show the guide's link to the user.",
          "inputSchema": {
            "properties": {
              "city": {
                "description": "City or region with a guide, in any site language (Porto, Lisbon, Lisboa, Greater Porto, Algarve, Coimbra) or a municipality inside a guide (Gaia, Cascais, Faro). Omit to list the guides",
                "examples": [
                  "Porto",
                  "Lisbon",
                  "Gaia"
                ],
                "type": "string"
              },
              "include": {
                "default": [
                  "areas",
                  "noise",
                  "safety"
                ],
                "description": "Parts of the guide to return; all returns every section",
                "items": {
                  "enum": [
                    "areas",
                    "noise",
                    "safety",
                    "prices",
                    "municipal_housing",
                    "checks",
                    "climate",
                    "transport",
                    "other",
                    "all"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "language": {
                "default": "en",
                "description": "Language of the answer: the guide or the definition, the text summary and the page links. Field names stay English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "profile": {
                "description": "Keep the areas that suit this profile; profile never removes the areas we advise against",
                "enum": [
                  "family",
                  "car_free",
                  "retirees",
                  "remote",
                  "budget",
                  "nightlife"
                ],
                "type": "string"
              },
              "verdict": {
                "description": "Keep only areas with this verdict: live (good to live), depends (depends on you), avoid (we advise against)",
                "enum": [
                  "live",
                  "depends",
                  "avoid"
                ],
                "type": "string"
              }
            },
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "description": "Without city: the guides that exist.",
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "guides": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "language": {
                    "type": "string"
                  },
                  "profiles": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "language",
                  "guides",
                  "profiles",
                  "url",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "description": "With city: one guide's verdict area by area.",
                "properties": {
                  "areas": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "attribution": {
                    "type": "object"
                  },
                  "filters": {
                    "type": "object"
                  },
                  "guide": {
                    "type": "object"
                  },
                  "hub_url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "language": {
                    "type": "string"
                  },
                  "language_requested": {
                    "type": "string"
                  },
                  "lede": {
                    "type": "string"
                  },
                  "published_on": {
                    "description": "Date, YYYY-MM-DD",
                    "type": "string"
                  },
                  "sections": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "sources": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "title": {
                    "type": "string"
                  },
                  "updated_on": {
                    "description": "Date, YYYY-MM-DD",
                    "type": "string"
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "verdict_scale": {
                    "type": "object"
                  }
                },
                "required": [
                  "guide",
                  "language",
                  "language_requested",
                  "title",
                  "lede",
                  "filters",
                  "verdict_scale",
                  "areas",
                  "sections",
                  "url",
                  "hub_url",
                  "published_on",
                  "updated_on",
                  "sources",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "error": {
                    "type": "string"
                  },
                  "guides": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "message": {
                    "type": "string"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Where to live in a Portuguese city, area by area"
          }
        },
        {
          "name": "municipality_stats",
          "title": "Key figures for one Portuguese municipality",
          "description": "Use this when the key figures of one of Portugal's 308 municipalities are needed, each with its source and date. They are the IMI rate and history, INE sale price per m² (actual sales), purchasing power, population, licensed dwellings, building cases, new builds. Do not use it to compare places (`compare_municipalities`), inside a city (`where_to_live`) or for monthly building (`construction_barometer`). A figure that is not published is null, not estimated. A name matching two municipalities is refused with candidates.",
          "inputSchema": {
            "properties": {
              "language": {
                "default": "en",
                "description": "Language of the page links and labels; the text summary and field names stay English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "municipality": {
                "description": "Municipality name in any case, accents optional (Porto, Lisboa, Vila Nova de Gaia, Matosinhos; Lisbon and Oporto are accepted) or its four-digit code (1312). Close spellings are found; two matches return an `ambiguous` error with candidates",
                "examples": [
                  "Porto",
                  "Vila Nova de Gaia",
                  "1312"
                ],
                "type": "string"
              }
            },
            "required": [
              "municipality"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "properties": {
                  "affordability": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "attribution": {
                    "type": "object"
                  },
                  "construction_barometer": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "imi": {
                    "type": "object"
                  },
                  "language": {
                    "type": "string"
                  },
                  "licensed_buildings_all_works": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "licensed_new_buildings": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "licensed_new_dwellings": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "municipal_cases": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "municipality": {
                    "type": "object"
                  },
                  "new_builds": {
                    "type": "object"
                  },
                  "population": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "purchasing_power": {
                    "description": "Index, Portugal = 100",
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "sale_prices": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "where_to_live": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "municipality",
                  "url",
                  "imi",
                  "sale_prices",
                  "purchasing_power",
                  "population",
                  "licensed_new_dwellings",
                  "licensed_new_buildings",
                  "licensed_buildings_all_works",
                  "municipal_cases",
                  "construction_barometer",
                  "new_builds",
                  "where_to_live",
                  "attribution",
                  "language"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "candidates": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "error": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "suggestions": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Key figures for one Portuguese municipality"
          }
        },
        {
          "name": "compare_municipalities",
          "title": "Compare 2 to 5 Portuguese municipalities",
          "description": "Use this when the person is choosing between two to five Portuguese municipalities, with the same figures for each as `municipality_stats`. Do not use it for a single municipality (`municipality_stats`) or for the areas inside one city (`where_to_live`). Names that point at the same municipality count once, and fewer than two distinct ones are refused (bad_count). One unknown or ambiguous name refuses the whole comparison.",
          "inputSchema": {
            "properties": {
              "language": {
                "default": "en",
                "description": "Language of the page links and labels; the text summary and field names stay English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "municipalities": {
                "description": "Two to five municipality names or codes",
                "examples": [
                  [
                    "Porto",
                    "Matosinhos",
                    "Vila Nova de Gaia"
                  ]
                ],
                "items": {
                  "type": "string"
                },
                "maxItems": 5,
                "minItems": 2,
                "type": "array"
              }
            },
            "required": [
              "municipalities"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "language": {
                    "type": "string"
                  },
                  "municipalities": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "language",
                  "municipalities",
                  "url",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "candidates": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "error": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "suggestions": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Compare 2 to 5 Portuguese municipalities"
          }
        },
        {
          "name": "construction_barometer",
          "title": "Construction activity by municipality (barometer)",
          "description": "Use this when the question is how much is being built in Portuguese municipalities. It gives our monthly count of building-works cases entering licensing, where we collect them, and INE's yearly licensed buildings and new dwellings for all 308. Do not use it for other figures (`municipality_stats`). Without `municipality` it returns every municipality we collect and the panel index. `measure` and `granularity` change only our own series. A case is not a granted licence or a building.",
          "inputSchema": {
            "properties": {
              "granularity": {
                "default": "month",
                "description": "Period of our own series; the INE series is yearly either way",
                "enum": [
                  "month",
                  "year"
                ],
                "type": "string"
              },
              "language": {
                "default": "en",
                "description": "Language of the page links and labels; the text summary and field names stay English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "measure": {
                "default": "total_works",
                "description": "Kind of works counted in our own series: all works, new buildings, or alterations and extensions",
                "enum": [
                  "total_works",
                  "new_build",
                  "alter_extend"
                ],
                "type": "string"
              },
              "municipality": {
                "description": "Optional. Municipality name in any case, accents optional (Porto, Lisboa, Vila Nova de Gaia, Matosinhos; Lisbon and Oporto are accepted) or its four-digit code (1312). Close spellings are found; two matches return an `ambiguous` error with candidates. Omit for the summary of every municipality we collect",
                "examples": [
                  "Porto",
                  "Vila Nova de Gaia",
                  "1312"
                ],
                "type": "string"
              }
            },
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "description": "Without municipality: every municipality we collect, and the index.",
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "caveat": {
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "measure": {
                    "type": "string"
                  },
                  "method_url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "municipalities": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "panel_index": {
                    "type": "object"
                  },
                  "snapshot": {
                    "description": "Date, YYYY-MM-DD, or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "window": {
                    "type": "object"
                  }
                },
                "required": [
                  "language",
                  "measure",
                  "snapshot",
                  "window",
                  "municipalities",
                  "panel_index",
                  "caveat",
                  "url",
                  "method_url",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "description": "With municipality: our series (if collected) and INE's yearly series.",
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "caveat": {
                    "type": "string"
                  },
                  "covered_municipalities": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "granularity": {
                    "type": "string"
                  },
                  "in_own_series": {
                    "type": "boolean"
                  },
                  "ine_official": {
                    "type": "object"
                  },
                  "language": {
                    "type": "string"
                  },
                  "measure": {
                    "type": "string"
                  },
                  "method_url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "municipality": {
                    "type": "object"
                  },
                  "municipality_url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "own_series": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "snapshot": {
                    "description": "Date, YYYY-MM-DD, or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "summary": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "language",
                  "municipality",
                  "measure",
                  "granularity",
                  "snapshot",
                  "in_own_series",
                  "own_series",
                  "summary",
                  "ine_official",
                  "covered_municipalities",
                  "caveat",
                  "url",
                  "method_url",
                  "municipality_url",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "candidates": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "error": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "suggestions": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Construction activity by municipality (barometer)"
          }
        },
        {
          "name": "municipality_housing_pipeline",
          "title": "Housing pipeline of one municipality: cases to completions",
          "description": "Use this when one municipality's housing pipeline from licence to completion is needed: cases, INE licences and completions, units for sale. Do not use it for monthly building activity (`construction_barometer`). Periods differ by stage; unknown is null, not 0.",
          "inputSchema": {
            "properties": {
              "language": {
                "default": "en",
                "description": "Language of the page links and labels; the text summary and field names stay English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "municipality": {
                "description": "Municipality name in any case, accents optional (Porto, Lisboa, Vila Nova de Gaia, Matosinhos; Lisbon and Oporto are accepted) or its four-digit code (1312). Close spellings are found; two matches return an `ambiguous` error with candidates",
                "examples": [
                  "Porto",
                  "Vila Nova de Gaia",
                  "1312"
                ],
                "type": "string"
              }
            },
            "required": [
              "municipality"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "description": "One municipality: every stage with its own period and source.",
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "caveat": {
                    "type": "string"
                  },
                  "coverage": {
                    "type": "object"
                  },
                  "durations": {
                    "description": "Age of licensing cases in progress (an age, not a processing time).",
                    "type": "object"
                  },
                  "language": {
                    "type": "string"
                  },
                  "method_url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "municipality": {
                    "type": "object"
                  },
                  "municipality_url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "ratio_completed_licensed": {
                    "type": "object"
                  },
                  "stages": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "language",
                  "municipality",
                  "coverage",
                  "stages",
                  "ratio_completed_licensed",
                  "durations",
                  "caveat",
                  "url",
                  "method_url",
                  "municipality_url",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "candidates": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "error": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "suggestions": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Housing pipeline of one municipality: cases to completions"
          }
        },
        {
          "name": "glossary_lookup",
          "title": "Explain a Portuguese home-buying term",
          "description": "Use this when asked what a Portuguese home-buying or tax term means (CPCV, escritura, VPT…), with where it comes up and the article of law with a link. Do not use it to calculate anything: purchase taxes are `imt_calculate`, the yearly tax `imi_annual_cost`. Without `term` it lists all terms. A term without a translation comes in English; an unknown one is refused with close spellings, if any.",
          "inputSchema": {
            "properties": {
              "language": {
                "default": "en",
                "description": "Language of the answer: the guide or the definition, the text summary and the page links. Field names stay English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "term": {
                "description": "The term: Portuguese or English name, a name in any site language or an abbreviation (CPCV, IMT, VPT, caderneta predial, escritura). Omit to list all terms",
                "examples": [
                  "CPCV",
                  "caderneta predial",
                  "escritura"
                ],
                "type": "string"
              }
            },
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "description": "Without term: every term.",
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "count": {
                    "type": "integer"
                  },
                  "language": {
                    "type": "string"
                  },
                  "terms": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "language",
                  "count",
                  "terms",
                  "url",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "description": "With term: the definition and the law.",
                "properties": {
                  "abbreviation": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "attribution": {
                    "type": "object"
                  },
                  "checked_on": {
                    "description": "Date, YYYY-MM-DD",
                    "type": "string"
                  },
                  "definition": {
                    "type": "string"
                  },
                  "en_name": {
                    "type": "string"
                  },
                  "in_practice": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "key": {
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "language_requested": {
                    "type": "string"
                  },
                  "legal_refs": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "name": {
                    "type": "string"
                  },
                  "pt_name": {
                    "type": "string"
                  },
                  "questions": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "see_also": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "sources": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "updated_on": {
                    "description": "Date, YYYY-MM-DD",
                    "type": "string"
                  },
                  "url": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "key",
                  "name",
                  "pt_name",
                  "en_name",
                  "abbreviation",
                  "url",
                  "language",
                  "language_requested",
                  "definition",
                  "in_practice",
                  "questions",
                  "legal_refs",
                  "see_also",
                  "updated_on",
                  "checked_on",
                  "sources",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "error": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  },
                  "suggestions": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Explain a Portuguese home-buying term"
          }
        },
        {
          "name": "search_newbuilds",
          "title": "Search new-build projects in Portugal",
          "description": "Use this when the person wants to find published new-build projects (empreendimentos) in Portugal on flatin.pt. Do not use it for one project's details (`get_newbuild` with its slug) or for how much is being built (`construction_barometer`). With `typology`, the budget applies to those typologies' prices; projects without a published price drop out when a budget is given. Pass next_offset as `offset` for the next page. A misspelt filter is refused, not ignored. Prices are as checked on developers' pages or agency listings, dated.",
          "inputSchema": {
            "additionalProperties": false,
            "examples": [
              {
                "municipality": "Porto",
                "price_max": 400000,
                "typology": [
                  "T2"
                ]
              },
              {
                "language": "pt",
                "municipality": "Lisboa",
                "stage": [
                  "building"
                ]
              }
            ],
            "properties": {
              "delivery_by": {
                "description": "Completed, or promised for this year or earlier (overdue promises included), e.g. 2027; at most five years back. Projects with no announced date are left out",
                "maximum": 2100,
                "type": "integer"
              },
              "energy_class": {
                "description": "Energy certificate class of at least one unit, as stated by the source. Often not published: filter only when asked",
                "items": {
                  "enum": [
                    "A+",
                    "A",
                    "B",
                    "B-",
                    "C",
                    "D",
                    "E",
                    "F"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "language": {
                "default": "en",
                "description": "Language of the page URLs and of the labels (stage, typology, nearby places); the text summary shows the typology labels in it. Field names stay English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "limit": {
                "default": 10,
                "description": "Results per call",
                "maximum": 50,
                "minimum": 1,
                "type": "integer"
              },
              "municipality": {
                "description": "City / municipality (concelho): name, slug or four-digit code, e.g. Porto, Lisboa, Vila Nova de Gaia, Matosinhos, 1312. English names (Lisbon) and accents-free spelling are understood; an ambiguous name (Lagoa) is refused with candidates",
                "examples": [
                  "Porto",
                  "Vila Nova de Gaia",
                  "1312"
                ],
                "type": "string"
              },
              "offset": {
                "default": 0,
                "description": "Skip this many results: pass next_offset from the previous answer",
                "maximum": 5000,
                "minimum": 0,
                "type": "integer"
              },
              "on_sale": {
                "default": false,
                "description": "Only projects with a published price",
                "type": "boolean"
              },
              "parish": {
                "description": "Parish (freguesia) name. Exact name, accents optional",
                "examples": [
                  "Paranhos"
                ],
                "type": "string"
              },
              "price_max": {
                "description": "Budget upper bound in euros, e.g. 350000. With typology, the budget applies to those typologies' prices. Projects with no published price are left out when a budget is given",
                "maximum": 999999999,
                "minimum": 0,
                "type": "integer"
              },
              "price_min": {
                "description": "Budget lower bound in euros",
                "maximum": 999999999,
                "minimum": 0,
                "type": "integer"
              },
              "sort": {
                "default": "price",
                "description": "price: cheapest first; delivery: soonest first; new: recently added first. Projects with a price always come before those without",
                "enum": [
                  "price",
                  "name",
                  "delivery",
                  "new"
                ],
                "type": "string"
              },
              "stage": {
                "description": "Construction stage: planned, licensed, building (under construction), selling (on sale), delivered (completed)",
                "items": {
                  "enum": [
                    "planned",
                    "licensed",
                    "building",
                    "selling",
                    "delivered"
                  ],
                  "type": "string"
                },
                "type": "array"
              },
              "typology": {
                "description": "Bedrooms: T0 studio … T5 (five or more). Any of the listed matches",
                "items": {
                  "enum": [
                    "T0",
                    "T1",
                    "T2",
                    "T3",
                    "T4",
                    "T5"
                  ],
                  "type": "string"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "properties": {
                  "attribution": {
                    "type": "object"
                  },
                  "catalog_url": {
                    "description": "Absolute URL",
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "limit": {
                    "type": "integer"
                  },
                  "next_offset": {
                    "description": "Pass as offset for the next page; null = last",
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "offset": {
                    "type": "integer"
                  },
                  "results": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "total": {
                    "type": "integer"
                  }
                },
                "required": [
                  "total",
                  "offset",
                  "limit",
                  "next_offset",
                  "language",
                  "catalog_url",
                  "results",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "candidates": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "error": {
                    "type": "string"
                  },
                  "field": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "suggestions": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Search new-build projects in Portugal"
          }
        },
        {
          "name": "get_newbuild",
          "title": "Get one new-build project: prices, cost, nearby",
          "description": "Use this when one new-build project in Portugal is needed in detail, by slug (from `search_newbuilds`) or page URL. It gives units and prices per typology, price history, delivery promises and how often they moved, building permits, the developer, the purchase cost and what is nearby. Do not use it to search (`search_newbuilds`) or for taxes at another price or for a non-resident (`imt_calculate`). The purchase cost is at the cheapest available unit or the developer's from-price, for a buyer tax resident in Portugal. `primary_home` and `buyer_is_young` change only the purchase cost. An unknown slug is refused (not_found). Cite the page URL, given in all seven site languages.",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {
              "buyer_is_young": {
                "default": false,
                "description": "For the purchase cost only: buyer aged 35 or under, first own home (reduced IMT and stamp duty relief); applies only with primary_home",
                "type": "boolean"
              },
              "language": {
                "default": "en",
                "description": "Language of the page URLs and of the labels (stage, typology, nearby places); the text summary shows the typology labels in it. Field names stay English. uk is accepted as ua.",
                "enum": [
                  "pt",
                  "en",
                  "ru",
                  "ua",
                  "de",
                  "fr",
                  "nl",
                  "uk"
                ],
                "type": "string"
              },
              "primary_home": {
                "default": true,
                "description": "For the purchase cost only: the buyer's own permanent home (habitação própria e permanente)",
                "type": "boolean"
              },
              "slug": {
                "description": "The project's slug from search_newbuilds (field slug), or its flatin.pt page URL",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "slug"
            ],
            "type": "object"
          },
          "outputSchema": {
            "anyOf": [
              {
                "properties": {
                  "area": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "attribution": {
                    "type": "object"
                  },
                  "checked_on": {
                    "description": "Date, YYYY-MM-DD",
                    "type": "string"
                  },
                  "delivery": {
                    "type": "object"
                  },
                  "developer": {
                    "description": "null when the developer is not confirmed",
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "image": {
                    "description": "Absolute URL or null",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "language": {
                    "type": "string"
                  },
                  "location": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "location_precision": {
                    "type": "string"
                  },
                  "municipality": {
                    "type": "object"
                  },
                  "name": {
                    "type": "string"
                  },
                  "nearby": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "parish": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "permits": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "price": {
                    "type": "object"
                  },
                  "purchase_cost": {
                    "type": [
                      "object",
                      "null"
                    ]
                  },
                  "slug": {
                    "type": "string"
                  },
                  "stage": {
                    "type": "object"
                  },
                  "summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "typologies": {
                    "items": {
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "updated_on": {
                    "description": "Date, YYYY-MM-DD",
                    "type": "string"
                  },
                  "url": {
                    "description": "Absolute URL",
                    "type": "string"
                  },
                  "urls": {
                    "type": "object"
                  }
                },
                "required": [
                  "slug",
                  "name",
                  "url",
                  "urls",
                  "language",
                  "summary",
                  "developer",
                  "municipality",
                  "parish",
                  "stage",
                  "delivery",
                  "price",
                  "typologies",
                  "purchase_cost",
                  "permits",
                  "location",
                  "location_precision",
                  "area",
                  "nearby",
                  "image",
                  "checked_on",
                  "updated_on",
                  "attribution"
                ],
                "type": "object"
              },
              {
                "properties": {
                  "error": {
                    "type": "string"
                  },
                  "field": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": "string"
                  }
                },
                "required": [
                  "error",
                  "message"
                ],
                "type": "object"
              }
            ],
            "description": "Success, or a refusal with an error code. Units: *_cents euro cents, *_eur euros, *_eur_m2 euros per m², *_pct and percent in percent.",
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false,
            "readOnlyHint": true,
            "title": "Get one new-build project: prices, cost, nearby"
          }
        }
      ]
    },
    "name": "flatin.pt — Portuguese homes: new-builds, places, taxes",
    "note": "Indexed from the official MCP registry: facts and our own checks, not reviewed, so no score, grade or rank.",
    "packages": [
      {
        "registryType": "npm",
        "identifier": "flatin-mcp",
        "version": "1.1.0",
        "transport": "stdio"
      }
    ],
    "pageJsonUrl": "https://www.anchorterminal.com/tools/flatin-property-taxes.json",
    "popularity": {
      "npmWeekly": 422
    },
    "registryName": "pt.flatin/property-taxes",
    "remotes": [
      {
        "type": "streamable-http",
        "url": "https://flatin.pt/mcp"
      }
    ],
    "repository": "https://gitlab.com/flatin-pt-group/mcp",
    "reviewed": false,
    "slug": "flatin-property-taxes",
    "source": "the official MCP registry",
    "sourceUrl": "https://registry.modelcontextprotocol.io/v0.1/servers?search=pt.flatin/property-taxes",
    "summary": "Portugal home buying: new-build search, where-to-live guides, municipality data, IMT/IMI taxes",
    "updatedAt": "2026-11-08T12:42:13Z",
    "url": "https://www.anchorterminal.com/tools/flatin-property-taxes",
    "vendor": "flatin.pt",
    "vendorUrl": "https://flatin.pt/en/tools/api-and-data/",
    "version": "3.0.0",
    "websiteUrl": "https://flatin.pt/en/tools/api-and-data/",
    "where": "both",
    "why": [
      "vendor"
    ]
  }
}
