Skip to main content
Glama

Get a property passport

get_passport
Read-onlyIdempotent

Full passport of one property: attributes stated by the operator (provenance says who states them and when they changed; they are not checked by Ospitario), the pool's stated facets (null: not stated), tier and date, registration status, direct contact, blocked dates, liability insurance and safety equipment as declared by the operator, priceFrom (indicative, negotiated directly, no booking), and the page link to hand to the traveler. No booking through Ospitario; an inquiry can be sent to the operator with send_inquiry, or the traveler uses the direct contact on the passport. Insurance status and safety equipment are host-declared, not verified: Ospitario has seen no policy and no device. Availability is a hint, never a booking commitment: a night not blocked in the operator's synced calendar may already be taken, since the calendar is a copy that can lag behind; only the operator confirms availability, and Ospitario holds or books nothing. Prices are indicative, stated by the host (on an unclaimed passport: taken from the official website), negotiated directly with the host; there is no booking through Ospitario. Every result is a property with a proven listing (L2/L2c), a verified operator (L3), a right to manage verified by document review (LA) or, marked L0 and unclaimed, facts from the operator's official website with nothing proven; the result names the tier and the date it was reached, and whether the registration number (Italy: CIN) was checked against the public register. Contact is direct with the operator and commission-free, so the traveler pays no platform fee. No result means nothing proven matches; nothing is inferred, estimated or filled in.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "slug": "<slug>"
    },
    "name": "get_passport"
  }
}

Input Schema

NameRequiredDescriptionDefault
langNoLanguage of labels in the result; defaults to en
slugYesPassport slug from a search or lookup result

Output Schema

NameRequiredDescriptionDefault
foundYes
jsonLdNoschema.org VacationRental of the passport
reasonNonot_found: no public passport has this slug
propertyNo
contactPageUrlNoPage with the passport and the operator's direct contact; give this link to the traveler

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed14 schema fields changed
    • addedOutput schema / properties / property / properties / facilities / properties / balcony
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / bbq
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "A barbecue or outdoor grill"
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / crib
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "A cot for a baby"
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / elevator
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / fireplace
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / hotTub
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / kitchen
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / microwave
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / tv
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / washingMachine
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / property / properties / facilities / properties / wifi
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / property / properties / facilities / required
      Previous value: -[
      -  "parking",
      -  "workspace",
      -  "airConditioning",
      -  "heating"
      -]New value: +[
      +  "parking",
      +  "workspace",
      +  "airConditioning",
      +  "heating",
      +  "wifi",
      +  "kitchen",
      +  "washingMachine",
      +  "tv",
      +  "bbq",
      +  "crib",
      +  "elevator",
      +  "hotTub",
      +  "fireplace",
      +  "balcony",
      +  "microwave"
      +]
    • addedOutput schema / properties / property / properties / floorArea
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Living area in square metres as the operator states it; null: not stated"
      +}
    • changedOutput schema / properties / property / required
      Previous value: -[
      -  "slug",
      -  "name",
      -  "municipality",
      -  "province",
      -  "country",
      -  "type",
      -  "capacity",
      -  "bedrooms",
      -  "amenities",
      -  "pool",
      -  "placeKind",
      -  "bathrooms",
      -  "petsAllowed",
      -  "checkinFrom",
      -  "checkoutUntil",
      -  "location",
      -  "minNights",
      -  "beds",
      -  "extraCosts",
      -  "childrenAllowed",
      -  "stepFreeAccess",
      -  "unitCount",
      -  "propertyKind",
      -  "smokingAllowed",
      -  "eventsAllowed",
      -  "cleaningFee",
      -  "securityDeposit",
      -  "facilities",
      -  "description",
      -  "locationNotes",
      -  "houseRules",
      -  "cancellation",
      -  "contact",
      -  "verification",
      -  "registration",
      -  "references",
      -  "availability",
      -  "blocked",
      -  "liabilityInsurance",
      -  "priceFrom",
      -  "unclaimed",
      -  "summary",
      -  "languages",
      -  "safety",
      -  "safetyStated",
      -  "trust",
      -  "provenance",
      -  "booking"
      -]New value: +[
      +  "slug",
      +  "name",
      +  "municipality",
      +  "province",
      +  "country",
      +  "type",
      +  "capacity",
      +  "bedrooms",
      +  "amenities",
      +  "pool",
      +  "placeKind",
      +  "bathrooms",
      +  "floorArea",
      +  "petsAllowed",
      +  "checkinFrom",
      +  "checkoutUntil",
      +  "location",
      +  "minNights",
      +  "beds",
      +  "extraCosts",
      +  "childrenAllowed",
      +  "stepFreeAccess",
      +  "unitCount",
      +  "propertyKind",
      +  "smokingAllowed",
      +  "eventsAllowed",
      +  "cleaningFee",
      +  "securityDeposit",
      +  "facilities",
      +  "description",
      +  "locationNotes",
      +  "houseRules",
      +  "cancellation",
      +  "contact",
      +  "verification",
      +  "registration",
      +  "references",
      +  "availability",
      +  "blocked",
      +  "liabilityInsurance",
      +  "priceFrom",
      +  "unclaimed",
      +  "summary",
      +  "languages",
      +  "safety",
      +  "safetyStated",
      +  "trust",
      +  "provenance",
      +  "booking"
      +]
  2. Changed1 schema field changed
    • changedOutput schema / properties / property / properties / verification / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "date": {
      -        "description": "Date the tier was reached, YYYY-MM-DD",
      -        "type": "string"
      -      },
      -      "label": {
      -        "description": "Human-readable name of the tier",
      -        "type": "string"
      -      },
      -      "tier": {
      -        "description": "Verification tier (docs: ADR 0012, 0017, 0024, 0025). L0 unclaimed: facts read from the operator's official website, nothing proven, the operator has not claimed the page; contact only through send_inquiry. L2 listing verified: the operator proved control of the platform listing (calendar export link with the listing id, platform email with a valid DKIM signature, or channel manager); since 2026-11-07 also their right to manage the property (LA or L3), and earlier L2 stands as it was reached. L2c listing calendar proven (Booking, Vrbo): the operator blocked a random date Ospitario named in that platform's calendar export within 48 hours; no new L2c since 2026-11-07. LA right to manage verified (document review): Ospitario's admin checked documents tying the operator to this property (registration record, deed, lease, mandate or company register); a person found them consistent, without eID, so it does not prove who holds the account and never proves a platform listing. L3 operator verified: the operator's eID identity (SPID/CIE) matches the CIN holder in the national register's PDF. L4 document verified (automated check): an ownership, lease or mandate document is consistent with that identity and the property; it states consistency, not authenticity. L5 manually verified: a reviewer checked the document (an optional upgrade; it does not affect search order).",
      -        "enum": [
      -          "L0",
      -          "L2",
      -          "L2c",
      -          "LA",
      -          "L3",
      -          "L4",
      -          "L5"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "tier",
      -      "label",
      -      "date"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "date": {
      +        "description": "Date the tier was reached, YYYY-MM-DD",
      +        "type": "string"
      +      },
      +      "label": {
      +        "description": "Human-readable name of the tier",
      +        "type": "string"
      +      },
      +      "tier": {
      +        "description": "Verification tier (docs: ADR 0012, 0017, 0024, 0025). L0 unclaimed: facts read from the operator's official website, nothing proven, the operator has not claimed the page; contact only through send_inquiry. L2 listing verified: the operator proved control of the platform listing (calendar export link with the listing id, platform email with a valid DKIM signature, or channel manager); since 2026-11-07 also their right to manage the property (LA or L3), and earlier L2 stands as it was reached. L2c listing calendar proven (Booking, Vrbo): the operator blocked a random date Ospitario named in that platform's calendar export within 48 hours; no new L2c since 2026-11-07. LA right-to-manage documents reviewed: Ospitario's admin checked documents tying the operator to this property (registration record, deed, lease, mandate or company register); a person found them consistent, without eID, so it does not prove who holds the account and never proves a platform listing. L3 operator verified: the operator's eID identity (SPID/CIE) matches the CIN holder in the national register's PDF. L4 document verified (automated check): an ownership, lease or mandate document is consistent with that identity and the property; it states consistency, not authenticity. L5 manually verified: a reviewer checked the document (an optional upgrade; it does not affect search order).",
      +        "enum": [
      +          "L0",
      +          "L2",
      +          "L2c",
      +          "LA",
      +          "L3",
      +          "L4",
      +          "L5"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "tier",
      +      "label",
      +      "date"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. Changed2 schema fields changed
    • changedOutput schema / properties / property / properties / checkoutUntil / description
      Previous value: -"Checkout until, HH:MM local time; null: not stated"New value: +"Checkout until, HH:MM local time; null: not stated (a stated 00:00, usually 12:00 AM typed for noon, counts as not stated)"
    • changedOutput schema / properties / property / properties / extraCosts / description
      Previous value: -"Costs beyond the nightly price in the operator's words (cleaning, tourist tax, linen, energy); null: not stated, which is not the same as none"New value: +"Costs beyond the nightly price in the operator's words (cleaning, tourist tax, linen, energy); null: not stated, which is not the same as none (a bare number without what or currency counts as not stated)"
  4. First observed

TDQS

A4.1/5.0
Behavior5/5

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

Annotations only cover the safety profile (readOnly, idempotent, non-destructive, closed-world); the description adds the substantive caveats an agent needs: insurance and safety equipment are host-declared and never verified, availability is a synced-calendar copy that can lag, prices are indicative and negotiated off-platform, and an empty result means nothing proven matched. It also explains the L0/L2/L3/LA tier semantics that determine how much of the returned data is actually verified.

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

Conciseness2/5

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

It is front-loaded and accurate, but heavily redundant: 'no booking through Ospitario' is asserted three separate times, the direct-negotiation point twice, and the host-declared/not-verified point twice. The dense comma-chained first sentence packs a dozen distinct concepts into one breath, which makes the genuinely important caveats (unverified insurance, lagging availability) harder to extract than they should be.

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

Completeness4/5

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

There is an output schema, so the description did not need to justify return values — yet most of its length is spent disclaiming the meaning of fields rather than helping the agent invoke the tool. The caveats are real value the output schema cannot carry, so the definition is complete, just misallocated in emphasis.

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 coverage is 100%, so slug (pattern-constrained) and lang (six-value enum, default en) are already fully documented in the schema. The description adds no format or behavior detail for either parameter; its only parameter-adjacent statement is that a non-matching slug yields nothing, which duplicates the schema's 'from a search or lookup result' note.

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

Purpose5/5

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

The opening clause names a specific resource (one property passport) and enumerates exactly what it returns: operator attributes with provenance, pool facets, tier and date, registration status, direct contact, blocked dates, insurance, safety equipment, priceFrom and the page link. An agent can distinguish this from search_properties or lookup_by_name immediately, and the named sibling send_inquiry is explicitly positioned as the different action.

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

Usage Guidelines4/5

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

It clearly states what the tool is not for — no booking, no availability commitment, no platform fee — and routes the agent to send_inquiry or the passport's direct contact for the follow-up action. What it does not say is when to reach for this tool versus search_properties or lookup_by_name; it relies on the schema hint that the slug comes from a search or lookup result.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources