Public catalog endpoint (no sign-in)
Endpoint: https://mcp.office.ihousejapan.net/catalog/mcp. Add this URL as a remote MCP connector in an AI assistant such as Claude. No account, credential or Authorization header is required. Use Streamable HTTP POST; the service is stateless.
This endpoint is read-only. It searches and compares Osaka accommodation and room types, and returns property details, photos, access information, check-in/out times and house rules in en, zh-CN, zh-TW, ja or ko. It cannot create bookings, read orders, check live availability or take payments, and it does not collect contact or payment details.
Starting prices are indicative, shown in integer JPY including the Home-booking service fee, and are not quotes for specific dates. Responses include customerPortalUrl; to request a booking, continue on the Home-booking customer site, where staff verify dates, total price and cancellation terms before any payment.
Example prompts: “Compare family-friendly rooms near Namba in Osaka for four guests.” · “帮我推荐大阪交通方便、适合两个人的住宿。” · “What are the check-in and check-out times for this property?”
Current inventory: 5 read-only tools.
| Tool / effect | Documentation |
| get_service_capabilities Read | 分别查看门店数、房型数、来源配置客房总数，以及数据来源和实际可用功能。首次使用或判断能否真实预订时调用。 Inspect supported languages, actual capabilities, catalog counts and source timestamps. Call before deciding whether a booking can be completed. |
| search_properties Read | 按门店分组搜索大阪住宿设施，筛选人数、设施和展示起价。total 是门店数，不是客房数；要逐个房型比较请用 search_room_types。结果不代表指定日期可订。 Search facilities by keyword, guests, amenities and advertised starting price. total counts facilities. Results do not confirm availability for specific dates. |
| search_room_types Read | 逐个房型列出可比较的住宿选项，可限定 propertyId 查看一家门店的全部房型。返回所属门店和来源配置客房数。total 为房型数；declaredUnitCount 不是实时余房。支持人数、设施、展示起价和分页。 Compare individual room types, optionally within one property. total counts room types; declaredUnitCount is not live availability. Supports pagination. |
| get_property Read | 使用搜索返回的 propertyId 获取地址、交通、图片链接、房型、设施及资料采集时间。 Use a propertyId from search to retrieve localized descriptions, address, access, photos, room types, facilities and collection timestamp. |
| get_property_policies Read | 查看来源网站展示的入住退房时间、房屋规则、儿童政策及取消提前天数。取消规则不等于所选价格计划的最终条件。 Retrieve published check-in/out times and house rules. Source cancellation information is not the verified cancellation terms of a quote. |
Errors: invalid input returns a tool error with details; an unknown propertyId returns PROPERTY_NOT_FOUND. HTTP 405 is returned for GET. Requests are rate limited per client IP; HTTP 429 includes a Retry-After header, so wait before retrying.
Authenticated endpoint: connection and authentication
Endpoint: https://mcp.office.ihousejapan.net/mcp. Use an MCP client and Streamable HTTP POST. The service is stateless; protocol GET/DELETE are not supported. Opening the endpoint as a browser page is not a protocol test.
Authenticate through the Authorization request header using a securely issued Bearer credential. A service-level catalog credential does not grant a customer identity or access to private orders. Private order tools require a separate verified customer credential with orders:read and, for writes, orders:write. Customer identifiers supplied as tool arguments do not establish identity. Credentials may expire or be revoked. Do not put secrets in URLs, public docs or prompts.
Current credentials are customer-scoped static development credentials, not implemented Muse OAuth or Doubao account linking. Dedicated reviewer credentials and environment must be arranged separately through an approved secure channel; the production administrator account is not a reviewer account.
Current scope and languages
Osaka accommodation catalog, room-type comparison, house rules and authenticated agency requests. English (en), Traditional Chinese (zh-TW), Simplified Chinese (zh-CN), Japanese (ja) and Korean (ko) are supported via locale; the default is zh-CN. Missing source text can fall back to English, Japanese or another available source language. Monetary records use integer JPY; advertised starting prices are indicative, not date-specific totals. Check-in/out dates are Japan-local YYYY-MM-DD.
get_service_capabilities exposes current feature flags and counts. Live inventory/quotes, online checkout and automatic supplier booking are not connected. check_availability returns unknown with LIVE_INVENTORY_NOT_CONNECTED; do not infer availability from the total number of units. Standard SDK tests are not official client approval.
Tools and exact input schemas
The machine-readable tool list contains the actual SDK tool names, descriptions, input schemas, annotations and resource inventory. Current inventory: 11 tools, 8 read and 3 write. Responses include JSON text and structuredContent; business failures set isError and expose a stable code where available. These are MCP annotations, not platform-approved sensitive-action classifications.
| Tool / effect | Documentation |
| get_service_capabilities Read | 分别查看门店数、房型数、来源配置客房总数，以及数据来源和实际可用功能。首次使用或判断能否真实预订时调用。 Inspect supported languages, actual capabilities, catalog counts and source timestamps. Call before deciding whether a booking can be completed. |
| search_properties Read | 按门店分组搜索大阪住宿设施，筛选人数、设施和展示起价。total 是门店数，不是客房数；要逐个房型比较请用 search_room_types。结果不代表指定日期可订。 Search facilities by keyword, guests, amenities and advertised starting price. total counts facilities. Results do not confirm availability for specific dates. |
| search_room_types Read | 逐个房型列出可比较的住宿选项，可限定 propertyId 查看一家门店的全部房型。返回所属门店和来源配置客房数。total 为房型数；declaredUnitCount 不是实时余房。支持人数、设施、展示起价和分页。 Compare individual room types, optionally within one property. total counts room types; declaredUnitCount is not live availability. Supports pagination. |
| get_property Read | 使用搜索返回的 propertyId 获取地址、交通、图片链接、房型、设施及资料采集时间。 Use a propertyId from search to retrieve localized descriptions, address, access, photos, room types, facilities and collection timestamp. |
| get_property_policies Read | 查看来源网站展示的入住退房时间、房屋规则、儿童政策及取消提前天数。取消规则不等于所选价格计划的最终条件。 Retrieve published check-in/out times and house rules. Source cancellation information is not the verified cancellation terms of a quote. |
| check_availability Read | 核验日期和房型容量并查询库存适配器。目前未连接实时库存，明确返回 unknown，不能据此确认可订。 Validate dates and per-room capacity, then consult the inventory adapter. Currently returns unknown because live inventory is not connected. Do not claim availability. |
| submit_booking_request Write | 获得用户同意后记录入住日期、房型、姓名和联系邮箱，建立我们代订的申请。不会收费、锁房或向酒店下单。需客户身份；同一申请重复调用必须沿用 idempotencyKey。不要收集卡号或护照。 After explicit user consent, record dates, room type, guest name and contact email. Requires customer authentication. Does not charge, hold a room or book with the property. Reuse idempotencyKey for retries. Never request card or passport details. |
| get_booking_order Read | 查看自己的申请状态、报价、收款退款进度及酒店确认号。requested/quoted/supplier_pending 均不是预订成功。 Read only the authenticated customer’s order, quote, recorded payments/refunds and property reference. Pending or quoted orders are not confirmed bookings. |
| list_my_booking_orders Read | 仅列出当前已认证客户自己的订单记录。 List only the authenticated customer’s own order records. |
| accept_booking_quote Write | 先展示所选房型、日期、日元总价及取消条款，获得用户明确同意后接受指定 quoteId。仅进入等待向我们付款的状态，不扣款，不代表酒店确认。报价变化或过期必须重新取得用户同意。 Show room, dates, full JPY total, expiry and original cancellation terms. Obtain explicit user approval for this quoteId. Accepting a quote only moves to awaiting payment; it does not charge or confirm a booking. Changed or expired quotes require fresh approval. |
| request_booking_cancellation Write | 用户明确要求后申请取消自己的订单。已收款或已向酒店下单时需核实酒店取消及退款，不会立即退款，也不能声称酒店已取消。 Only after the customer explicitly asks, request cancellation of their own order. Property cancellation and refunds must be verified separately; do not claim an immediate refund or property cancellation. |
Limits, errors and recovery
- HTTP JSON body limit: 256 KiB. Host and Origin validation apply to protected service routes.
- Search limits: 1–50 results per call, offset 0–100000. Filters for capacity, amenities and starting price match the same room type.
- Stay dates must be valid, not in the past in Japan, and checkout must follow check-in; maximum stay is 365 nights. Per-room capacity is checked.
- HTTP 401 indicates missing/invalid access; 403 may indicate Host/Origin denial; oversized or invalid JSON returns 413/400. Protocol GET normally returns 405.
- Business errors include CUSTOMER_AUTH_REQUIRED, INSUFFICIENT_SCOPE, ORDER_NOT_FOUND, INVALID_STAY, QUOTE_EXPIRED and QUOTE_CHANGED. Review the returned code, preserve the original request identifier, and do not blindly retry a transaction.
- There is no contractual public API rate quota yet. General MCP rate limiting is not represented as implemented. Production traffic limits and reviewer test arrangements require scope alignment.
Approvals, side effects and status
submit_booking_request stores an agency request only after the customer's consent to the stated details/contact. It does not hold a room, charge or submit to a supplier. Reuse the same idempotencyKey for a retry of the same request; changing locale does not create another order.
Before accept_booking_quote, show the exact room, dates, full JPY total, expiry and original cancellation terms and obtain fresh explicit approval for that quoteId. Acceptance records approval and moves to awaiting_payment; it does not execute a payment. A changed/expired quote requires a new approval.
requested, quoted, awaiting_payment, supplier_pending and supplier_outcome_unknown are not confirmed bookings. Only actual supplier confirmation can produce confirmed. Cancellation request, supplier cancellation and refund completion are distinct. Payment and refund facts require trusted operator evidence or verified signed provider events. Provider callbacks are implemented and sandbox-tested; live Stripe payments remain disabled pending merchant verification. Supplier confirmations require operator evidence. A chat assertion cannot record these facts.
All personal order reads/writes remain scoped to the authenticated customer. Operator financial records and supplier confirmation functions are not public MCP tools. The private workflow and actual platform user authorization require dedicated client testing before a full transactional review.
Public resources include home-booking://capabilities and five home-booking://service-guide/<locale> JSON guides. Legal policies: Privacy Notice and Service Terms, version 1.1 effective 2026-11-06.