Koskamo

Flatio MCP

An official MCP server provided by Flatio that allows AI assistants to search for furnished monthly rentals across Europe and retrieve listing details such as photos, house rules, and pricing. It enables agents to find apartments, houses, or rooms based on location, dates, budget, and other criteria, but explicitly cannot book, pay, or send messages.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Flatio MCP logo, by FlatioVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-19Operated by Flatio
MCP endpoint (Streamable HTTP)
https://www.flatio.com/mcp
Vendor documentation

What its tools do

4 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

4 of 4 have a description · 4 of 4 declare behavior hints · 4 of 4 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to flatio.com ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search for furnished apartments in a specific city and date range
  • Retrieve detailed listing information including photos and house rules
  • Find housing options for specific requirements like pet-friendly stays

Source and maintenance

Vendor evidenceRegistry 0.1.0

Protocol and capabilities

Server
flatio-search 0.1.0
MCP protocol negotiated in check
2025-11-25
Tools
4 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Give the guest every listing link exactly as the url field returns it, with all its query parameters. Never shorten a link or build one yourself. When a call had exact dates, the from and to parameters open the listing with those dates selected, so the page shows the price for those dates. Without them the page opens without dates and may show a different price. When you quote a price, give the url from the call that returned that price. None of the utm_source, utm_medium and utm_content parameters names the guest: utm_content is a random value that marks the call. They are how Flatio counts the guests that assistant answers bring, so it can tell whether this server helps them.

Tools

4 advertised

flatio_search_listings — Search Flatio listings
Advertised by the server during the last successful anonymous check.
Advertised read-only

Use this when someone wants to rent a furnished flat, house or room for a month or longer and names a city or country, with or without dates, budget, size or pets. It returns up to 10 listings per page with the monthly price and a link to the listing on flatio.com, where the guest books. It takes dates, a budget, a size and pets as filters. Not for nightly or holiday stays, and not for buying property. Give the guest each listing's url exactly as returned, with all its query parameters.

flatio_search_listings input schema
{
  "type": "object",
  "required": [
    "location"
  ],
  "properties": {
    "pets": {
      "type": "boolean",
      "description": "true when a pet moves in."
    },
    "sort": {
      "enum": [
        "recommended",
        "cheapest",
        "newest",
        "best_rated"
      ],
      "type": "string",
      "default": "recommended",
      "description": "Order of the listings, the same as on flatio.com."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 10,
      "minimum": 1,
      "description": "Listings per page, 1 to 10."
    },
    "cursor": {
      "type": "string",
      "maxLength": 100,
      "description": "next_cursor of the previous page, sent with the same filters."
    },
    "guests": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "People moving in, e.g. 2."
    },
    "months": {
      "type": "integer",
      "maximum": 24,
      "minimum": 1,
      "description": "Stay length in months when there are no dates, e.g. 6. Not together with move_in."
    },
    "move_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Move-in date as YYYY-MM-DD, e.g. \"2027-02-01\". Leave out when the dates are not known."
    },
    "currency": {
      "enum": [
        "CZK",
        "EUR",
        "GBP",
        "HUF",
        "PLN",
        "THB",
        "USD"
      ],
      "type": "string",
      "description": "Currency of max_monthly_price and of every price in the result, e.g. \"EUR\". Defaults to the currency of the response language's Flatio site."
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "description": "Language of titles, texts and links, e.g. \"en\", \"cs\", \"de\", \"es\", \"pt\". Defaults to the language the client reports, else English."
    },
    "location": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "City or country name in any language, e.g. \"Lisbon\", \"Praha\", \"Portugal\". A neighbourhood or an address is not accepted."
    },
    "move_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Move-out date as YYYY-MM-DD, after move_in, e.g. \"2027-08-01\". Needs move_in."
    },
    "bedrooms_min": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Fewest rooms with a bed, e.g. 2, the same as the bedrooms filter on flatio.com. A living room with a sofa bed counts, so a listing can show fewer bedrooms."
    },
    "property_type": {
      "enum": [
        "apartment",
        "house",
        "room"
      ],
      "type": "string",
      "description": "apartment is a whole flat, house a whole house, room a private room in a shared flat."
    },
    "max_monthly_price": {
      "type": "number",
      "maximum": 100000000,
      "description": "Highest monthly rent in the given currency, e.g. 1500.",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}
flatio_search_listings output schema
{
  "type": "object",
  "required": [
    "listings",
    "total",
    "next_cursor",
    "message"
  ],
  "properties": {
    "total": {
      "type": "integer",
      "description": "All listings matching the filters, of which at most 100 can be paged."
    },
    "message": {
      "type": [
        "string",
        "null"
      ]
    },
    "listings": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "title",
          "property_type",
          "monthly_price",
          "currency",
          "guests",
          "review_count",
          "url"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "url": {
            "type": "string"
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "guests": {
            "type": "integer"
          },
          "rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "bedrooms": {
            "type": [
              "integer",
              "null"
            ]
          },
          "currency": {
            "type": "string"
          },
          "district": {
            "type": [
              "string",
              "null"
            ]
          },
          "photo_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "review_count": {
            "type": "integer"
          },
          "floor_size_m2": {
            "type": [
              "number",
              "null"
            ]
          },
          "monthly_price": {
            "type": "integer"
          },
          "property_type": {
            "enum": [
              "apartment",
              "house",
              "room"
            ],
            "type": "string"
          }
        }
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
flatio_search_listings annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
flatio_get_listing — Get one Flatio listing
Advertised by the server during the last successful anonymous check.
Advertised read-only

Use this when someone asks about one listing whose id flatio_search_listings returned: its description, amenities, house rules, stay limits, availability, rating and price. With move_in and move_out it prices exactly those dates, broken into rent, service fee and deposit, and without them it gives the monthly rent. Not for finding listings. Give the guest each listing's url exactly as returned, with all its query parameters.

flatio_get_listing input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 1,
      "description": "Listing id from flatio_search_listings, e.g. 95507."
    },
    "move_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Move-in date as YYYY-MM-DD, e.g. \"2027-02-01\". Send together with move_out."
    },
    "currency": {
      "enum": [
        "CZK",
        "EUR",
        "GBP",
        "HUF",
        "PLN",
        "THB",
        "USD"
      ],
      "type": "string",
      "description": "Currency of every price in the result, e.g. \"EUR\". Send the currency of the search the id came from. Defaults to the currency of the response language's Flatio site."
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "description": "Language of titles, texts and links, e.g. \"en\", \"cs\", \"de\", \"es\", \"pt\". Defaults to the language the client reports, else English."
    },
    "move_out": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Move-out date as YYYY-MM-DD, after move_in, e.g. \"2027-08-01\"."
    }
  },
  "additionalProperties": false
}
flatio_get_listing output schema
{
  "type": "object",
  "required": [
    "id",
    "title",
    "description",
    "property_type",
    "guests",
    "amenities",
    "house_rules",
    "min_stay_days",
    "availability",
    "review_count",
    "photos",
    "price",
    "url"
  ],
  "properties": {
    "id": {
      "type": "integer"
    },
    "url": {
      "type": "string"
    },
    "city": {
      "type": [
        "string",
        "null"
      ]
    },
    "price": {
      "type": "object",
      "required": [
        "currency",
        "monthly_rent",
        "stay"
      ],
      "properties": {
        "stay": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "days": {
              "type": "integer"
            },
            "rent": {
              "type": "integer"
            },
            "total": {
              "type": "integer",
              "description": "Rent and service fee, without the refundable deposit."
            },
            "deposit": {
              "type": [
                "integer",
                "null"
              ]
            },
            "move_in": {
              "type": "string"
            },
            "move_out": {
              "type": "string"
            },
            "service_fee": {
              "type": "integer"
            }
          }
        },
        "currency": {
          "type": "string"
        },
        "monthly_rent": {
          "type": [
            "integer",
            "null"
          ]
        }
      }
    },
    "title": {
      "type": "string"
    },
    "guests": {
      "type": "integer"
    },
    "photos": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 5
    },
    "rating": {
      "type": [
        "number",
        "null"
      ]
    },
    "bedrooms": {
      "type": [
        "integer",
        "null"
      ]
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "district": {
      "type": [
        "string",
        "null"
      ]
    },
    "amenities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "bathrooms": {
      "type": [
        "integer",
        "null"
      ]
    },
    "description": {
      "type": "string"
    },
    "house_rules": {
      "type": "object",
      "required": [
        "pets",
        "smoking",
        "parties",
        "children"
      ],
      "properties": {
        "pets": {
          "enum": [
            "yes",
            "on_request",
            "no"
          ],
          "type": "string"
        },
        "parties": {
          "type": "boolean"
        },
        "smoking": {
          "type": "boolean"
        },
        "children": {
          "type": "boolean"
        }
      }
    },
    "availability": {
      "enum": [
        "available",
        "limited",
        "unavailable"
      ],
      "type": "string"
    },
    "review_count": {
      "type": "integer"
    },
    "floor_size_m2": {
      "type": [
        "integer",
        "null"
      ]
    },
    "max_stay_days": {
      "type": [
        "integer",
        "null"
      ]
    },
    "min_stay_days": {
      "type": "integer"
    },
    "property_type": {
      "enum": [
        "apartment",
        "house",
        "room"
      ],
      "type": "string"
    },
    "available_from": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
flatio_get_listing annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
search — Search Flatio for deep research
Advertised by the server during the last successful anonymous check.
Advertised read-only

Use this for deep research that works with a search and fetch pair. It takes one query, either a sentence naming a Flatio city or country or a JSON object with the guest's filters, and returns up to 10 listings as id, title and URL. A query that names no Flatio city or country gives an empty list. Give the guest each listing's url exactly as returned, with all its query parameters.

search input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1,
      "description": "A sentence naming a city or country, e.g. \"furnished flat in Lisbon for three months\", or a JSON object of the guest's filters where only location is required, e.g. {\"location\": \"Lisbon\", \"move_in\": \"2027-02-01\", \"move_out\": \"2027-04-30\", \"max_monthly_price\": 1500, \"currency\": \"EUR\", \"property_type\": \"apartment\", \"bedrooms_min\": 2, \"guests\": 2, \"pets\": true, \"sort\": \"cheapest\"}. Without dates, \"months\": 3 gives the stay length instead. property_type is apartment, house or room. sort is recommended, cheapest, newest or best_rated. currency is CZK, EUR, GBP, HUF, PLN, THB or USD."
    }
  },
  "additionalProperties": false
}
search output schema
{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "title",
          "url"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        }
      }
    }
  }
}
search annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
fetch — Fetch one Flatio listing for deep research
Advertised by the server during the last successful anonymous check.
Advertised read-only

Use this for deep research after search. It takes one id that search returned and gives that listing's facts as text, with the monthly rent and its URL on flatio.com. flatio_get_listing returns the same listing as fields and prices exact dates. Give the guest each listing's url exactly as returned, with all its query parameters.

fetch input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 10,
      "minLength": 1,
      "description": "An id from the results of search, e.g. \"95507\"."
    }
  },
  "additionalProperties": false
}
fetch output schema
{
  "type": "object",
  "required": [
    "id",
    "title",
    "text",
    "url",
    "metadata"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "properties": {
        "city": {
          "type": [
            "string",
            "null"
          ]
        },
        "currency": {
          "type": "string"
        },
        "monthly_rent": {
          "type": [
            "integer",
            "null"
          ]
        },
        "property_type": {
          "type": "string"
        }
      }
    }
  }
}
fetch annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (9 of 9 answered).

  1. 2026-11-19: 1 of 1 checks answered
  2. 2026-11-20: 3 of 3 checks answered
  3. 2026-11-21: 4 of 4 checks answered
  4. 2026-11-22: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
2160 ms
95th percentile latency
2160 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 2160 ms · metadata changed · 4 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http flatio-mcp https://www.flatio.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add flatio-mcp --url https://www.flatio.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable flatio-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "flatio-mcp": {
      "url": "https://www.flatio.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "flatio-mcp": {
      "type": "streamableHttp",
      "url": "https://www.flatio.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start flatio-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "flatio-mcp": {
      "type": "http",
      "url": "https://www.flatio.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http flatio-mcp https://www.flatio.com/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://www.flatio.com/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "flatio-mcp": {
      "serverUrl": "https://www.flatio.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Flatio MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run Flatio MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing