UniAffitti Room Finder

Search rooms

search_rooms

Read-onlyIdempotent

Search approved, available student rooms by budget, type, university, optional campus, distance, and features. Results include public listing content submitted by UniAffitti users.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`city`	No	Optional city filter selected from the assisted location search.
`limit`	No
`query`	No	Free text search over title, description, university, location, and campus.
`offset`	No
`features`	No
`order_by`	No		newest
`campus_id`	No
`max_price`	No
`min_price`	No
`room_type`	No
`country_code`	No	Optional ISO 3166-1 alpha-2 country filter.
`university_id`	No
`available_from`	No	YYYY-MM-DD.
`max_distance_km`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`limit`	Yes
`rooms`	Yes
`offset`	Yes
`has_more`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 7, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "has_more": {
+      "type": "boolean"
+    },
+    "limit": {
+      "type": "integer"
+    },
+    "offset": {
+      "type": "integer"
+    },
+    "rooms": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "available_from": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "campus_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "cover_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "deposit_amount": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "distance_km": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "id": {
+            "type": "integer"
+          },
+          "landlord_avatar_url": {
+            "type": "string"
+          },
+          "landlord_is_verified": {
+            "type": "boolean"
+          },
+          "landlord_name": {
+            "type": "string"
+          },
+          "landlord_rating_average": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "landlord_rating_count": {
+            "type": "integer"
+          },
+          "landlord_role": {
+            "type": "string"
+          },
+          "location_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "location_name": {
+            "type": "string"
+          },
+          "min_stay_months": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "occupancy_status": {
+            "type": "string"
+          },
+          "price_currency": {
+            "type": "string"
+          },
+          "price_monthly": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "public_url": {
+            "type": "string"
+          },
+          "room_city": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "room_country_code": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "room_type": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "title": {
+            "type": "string"
+          },
+          "university_city": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "university_country_code": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "university_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "zone_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "title",
+          "price_monthly",
+          "price_currency",
+          "room_type",
+          "location_name",
+          "public_url"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "rooms",
+    "limit",
+    "offset",
+    "has_more"
+  ],
+  "type": "object"
+}

Changed2 schema fields changedAug 30, 2026

addedInput schema / properties / city

Added value: +{
+  "description": "Optional city filter selected from the assisted location search.",
+  "type": "string"
+}

addedInput schema / properties / country_code

Added value: +{
+  "description": "Optional ISO 3166-1 alpha-2 country filter.",
+  "type": "string"
+}

Changed3 schema fields changedAug 28, 2026

changedInput schema / properties / query / description

Previous value: -"Free text search over title, description, zone, and campus."New value: +"Free text search over title, description, university, location, and campus."

addedInput schema / properties / university_id

Added value: +{
+  "minimum": 1,
+  "type": "integer"
+}

removedInput schema / properties / zone_id

Removed value: -{
-  "minimum": 1,
-  "type": "integer"
-}

First observedAug 5, 2026

TDQS

B3.3/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is covered. The description adds real value by scoping results to 'approved, available' rooms and disclosing that content is user-submitted ('public listing content submitted by UniAffitti users'), but it says nothing about pagination behavior despite limit/offset parameters.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences with zero waste. The filterable dimensions are front-loaded and the provenance note about user-submitted content follows immediately. Nothing is padded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value detail is not required, and the read-only annotations cover the safety dimension. However, for a 14-parameter tool with only 29% schema coverage and no usage guidance, the description leaves meaningful gaps in how to drive the filters correctly, making it only adequate rather than complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is low (29%), with only city, query, country_code, and available_from documented in the schema. The description partially compensates by grouping the filterable dimensions (budget, type, university, campus, distance, features), which maps to max/min_price, room_type, university_id, campus_id, max_distance_km, and features, but it adds no format or syntax detail, leaving the baseline 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb (Search) and resource (student rooms) and enumerates the filterable dimensions: budget, type, university, campus, distance, and features. It is clear on its own, but it never names or contrasts itself with close siblings like rank_room_matches, compare_rooms, or get_room_details, so an agent cannot tell from the description alone which one to reach for.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use or when-not-to-use guidance. The description implies a general browse/search entry point, but it does not mention alternatives (rank_room_matches, compare_rooms, get_room_details) or prerequisites, leaving the agent to infer routing from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All UniAffitti Room Finder tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?