Spann Stays

Read-only sample stays, booking constraints, and staged reservation actions for review.

Should I use this

Quality & Safety

B
Description quality
92%
Schema completeness
80%
Naming quality
90%
Poisoning risk
80%
Permission match
100%
Protocol compliance
100%

Findings (4)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool 'prepare_reservation_action' description contains placeholder textin prepare_reservation_action
  • LOWTool 'explain_booking_constraints' description lacks action verbin explain_booking_constraints
  • INFOTool description contains placeholder or incomplete textin prepare_reservation_action

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,121Tokens (tool definitions)
~1.5 KBTypical response size
Moderate attention impact (0.88% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "stays": {
      "url": "https://mcp.spannhq.com/mcp"
    }
  }
}

Remote endpoints

https://mcp.spannhq.com/mcpstreamable-http
https://mcp.persimmonhq.com/hospitality/mcpstreamable-http

What it can do

Tool inventory

Tools (6)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_availability(destination, property_id, stay, guest_count, language, ...)

Search deterministic sample stay options from the Spann Stays fixture; no live inventory or property availability is queried.

Input Schema

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "country",
        "prefecture"
      ],
      "properties": {
        "country": {
          "type": "string",
          "const": "JP"
        },
        "prefecture": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "area": {
          "type": "string"
        }
      }
    },
    "property_id": {
      "type": "string"
    },
    "stay": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "check_in",
        "check_out"
      ],
      "properties": {
        "check_in": {
          "type": "string"
        },
        "check_out": {
          "type": "string"
        }
      }
    },
    "guest_count": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "adults",
        "children",
        "rooms"
      ],
      "properties": {
        "adults": {
          "type": "integer",
          "minimum": 1
        },
        "children": {
          "type": "integer",
          "minimum": 0
        },
        "rooms": {
          "type": "integer",
          "minimum": 1
        }
      }
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ]
    },
    "required_constraints": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "stay",
    "guest_count",
    "language"
  ],
  "additionalProperties": false,
  "oneOf": [
    {
      "required": [
        "destination"
      ]
    },
    {
      "required": [
        "property_id"
      ]
    }
  ]
}
🟢explain_booking_constraints(property_id, room_rate_id, language, traveler_constraints)

Explain fixture-backed booking constraints for a sample property and rate; no property authority or live policy decision is provided.

Input Schema

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string"
    },
    "room_rate_id": {
      "type": "string"
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ]
    },
    "traveler_constraints": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "constraint_type",
          "value"
        ],
        "properties": {
          "constraint_type": {
            "type": "string"
          },
          "value": {
            "type": [
              "string",
              "number",
              "boolean",
              "null"
            ]
          },
          "notes": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  },
  "required": [
    "property_id",
    "room_rate_id",
    "language"
  ],
  "additionalProperties": false
}
🟢prepare_reservation_action(option_id, room_rate_id, traveler_packet, special_requests, confirmation_language, ...)

Prepare a fixture-only reservation action for review; never holds a room, books, pays, sends, or contacts a property. Use sample traveler placeholders only.

Input Schema

{
  "type": "object",
  "properties": {
    "option_id": {
      "type": "string"
    },
    "room_rate_id": {
      "type": "string"
    },
    "traveler_packet": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "lead_traveler_name",
        "party",
        "contact",
        "language",
        "consent_source"
      ],
      "properties": {
        "lead_traveler_name": {
          "type": "string"
        },
        "party": {
          "type": "object"
        },
        "contact": {
          "type": "object"
        },
        "language": {
          "type": "string",
          "enum": [
            "en",
            "ja"
          ]
        },
        "consent_source": {
          "type": "string"
        }
      }
    },
    "special_requests": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "confirmation_language": {
      "type": "string",
      "enum": [
        "en",
        "ja"
      ]
    },
    "desired_action_mode": {
      "type": "string",
      "enum": [
        "stage_only"
      ]
    }
  },
  "required": [
    "option_id",
    "room_rate_id",
    "traveler_packet",
    "desired_action_mode"
  ],
  "additionalProperties": false
}
🟢get_customer_property(property_id)

Read a published customer property record with public provenance and an official handoff route; unpublished records fail closed.

Input Schema

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string",
      "enum": [
        "kumihimo-kobe",
        "elevenvillage",
        "asagiya-takayama",
        "big-island-base",
        "halo"
      ]
    }
  },
  "required": [
    "property_id"
  ],
  "additionalProperties": false
}
🟢resolve_customer_route(property_id, stay)

Resolve a published customer's official booking or inquiry URL from stay length; never checks inventory or sends an inquiry.

Input Schema

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string",
      "enum": [
        "kumihimo-kobe",
        "elevenvillage",
        "asagiya-takayama",
        "big-island-base",
        "halo"
      ]
    },
    "stay": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "check_in",
        "check_out"
      ],
      "properties": {
        "check_in": {
          "type": "string"
        },
        "check_out": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "property_id",
    "stay"
  ],
  "additionalProperties": false
}
🟢get_guest_observations(property_id, preference)

Read moderated guest observations separately from property facts; no review collection or submission.

Input Schema

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "string",
      "enum": [
        "kumihimo-kobe",
        "elevenvillage",
        "asagiya-takayama",
        "big-island-base",
        "halo"
      ]
    },
    "preference": {
      "type": "string",
      "enum": [
        "quiet",
        "shade",
        "spaciousness",
        "sleep_comfort",
        "atmosphere"
      ]
    }
  },
  "required": [
    "property_id"
  ],
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded6 tools
verifiedversion not recorded6 tools
verifiedversion not recorded6 tools
verifiedversion not recorded6 tools
verifiedversion not recorded3 tools
verifiedversion not recorded3 tools
verifiedversion not recorded3 tools
verifiedversion not recorded3 tools
verifiedversion not recorded3 tools
verifiedversion not recorded3 tools