{"server":"Ask Japan","checked":"2026-11-22","tools":[{"name":"check_availability","title":"Check availability","description":"Check whether a new request can be taken now. Remote work (calls, online reservations) has a daily limit; on-the-ground work takes one job at a time. Returns open or full and when it reopens.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"check_invoice","title":"Check Japanese invoice registration","description":"Check whether a Japanese corporation is a registered Qualified Invoice Issuer (needed for consumption-tax credit). Accepts T + 13 digits or the 13-digit corporate number.","inputSchema":{"type":"object","properties":{"number":{"type":"string","description":"Invoice registration number (T1234567890123) or corporate number"}},"required":["number"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"check_open","title":"Check if a restaurant is open","description":"Check whether a MARU Order restaurant is taking takeout orders now, its hours and whether it accepts JPYC with a discount.","inputSchema":{"type":"object","properties":{"shop":{"type":"string"}},"required":["shop"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_company_profile","title":"Japanese company profile","description":"One profile for a Japanese corporation from its 13-digit corporate number: registered name and address, invoice (tax) registration status, and listing, industry and capital if it files with EDINET.","inputSchema":{"type":"object","properties":{"corporate_number":{"type":"string","description":"13-digit corporate number"}},"required":["corporate_number"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_menu","title":"Get a restaurant menu","description":"Get a MARU Order restaurant's menu: categories, items with tax-included JPY prices, options (size, toppings), allergens and sold-out flags. Use list shop slugs from the maru://order/shops resource.","inputSchema":{"type":"object","properties":{"shop":{"type":"string","description":"Shop slug, e.g. maru-demo"}},"required":["shop"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_request_status","title":"Get request status","description":"Get the status of a request: received, quoted (price and how to pay), paid, in_progress, done (with result), cancelled or refunded.","inputSchema":{"type":"object","properties":{"request_id":{"type":"string","description":"The request_id returned by request_service"}},"required":["request_id"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_services","title":"List services in Japan","description":"List the services MARU Japan Hands provides in Japan (Japanese phone calls, restaurant and golf reservations, shopping proxy, on-site checks, interpreting, Osaka stays, home search and property viewings, app development), with prices in JPY, limits and what is not offered.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"lookup_postcode","title":"Look up a Japanese postcode","description":"Get the address for a 7-digit Japanese postcode, including large offices that have their own postcode.","inputSchema":{"type":"object","properties":{"postcode":{"type":"string","description":"7 digits, hyphen optional, e.g. 530-0001"}},"required":["postcode"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"place_takeout_order","title":"Place a takeout order","description":"Place a takeout order. Returns an order number and a link. The customer pays at pickup at the counter, or opens the link to pay with JPYC (discounted). This tool never charges or moves money.","inputSchema":{"type":"object","properties":{"shop":{"type":"string"},"items":{"type":"array","minItems":1,"maxItems":30,"items":{"type":"object","properties":{"id":{"type":"string","description":"Item id from get_menu"},"qty":{"type":"integer","minimum":1,"maximum":20},"options":{"type":"object","description":"Group name -> list of chosen option names","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","qty"],"additionalProperties":false}},"pickup_time":{"type":"string","description":"Pickup time today in JST, HH:MM"},"name":{"type":"string","description":"Name for the order"},"contact":{"type":"string","description":"Phone or email for the shop to reach the customer"}},"required":["shop","items","pickup_time","name"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"quote_purchase","title":"Instant quote for buying in Japan","description":"Instant cost estimate to buy an item sold in Japan and ship it: item price (from the shop page the user or agent found), our fee (10%, minimum JPY 2,000) and shipping estimated from Japan Post's official EMS table. Read-only: it does not order or charge anything.","inputSchema":{"type":"object","properties":{"item_name":{"type":"string","description":"Product name"},"item_url":{"type":"string","description":"Product page URL in Japan (Rakuten, Amazon.co.jp, brand store, etc.)"},"item_price_jpy":{"type":"integer","minimum":1,"description":"Price per unit in JPY, tax included, as shown on the shop page"},"quantity":{"type":"integer","minimum":1,"maximum":50},"seller_shipping_jpy":{"type":"integer","minimum":0,"description":"Shop's shipping to our address in Japan, if any"},"ship_to_country":{"type":"string","description":"ISO 2-letter country code of the destination, e.g. US, TW, CN; JP for Japan"},"estimated_weight_kg":{"type":"number","minimum":0.01,"maximum":30,"description":"Item weight in kg if known (default 1.0)"}},"required":["item_price_jpy","ship_to_country"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"request_service","title":"Request a service in Japan","description":"Send a request for a service in Japan. Fixed-price services (phone_call JPY 1,500, restaurant_booking JPY 3,000, interpreting JPY 5,000 per 30 min) return the quote and payment details immediately. Other services get a fixed quote from a person within 2 hours (JST 09:00-21:00); requests sent outside hours are handled from 09:00. No email is needed: follow up with get_request_status. Creating a request is free and does not move any money. Full refund if we cannot do the task or you cancel before work starts.","inputSchema":{"type":"object","properties":{"service":{"type":"string","enum":["ai_agent_integration","custom","interpreting","phone_call","photo_check","property_search","property_viewing","queue_pickup","restaurant_booking","software_development","stay_osaka","store_purchase"],"description":"Service id from list_services"},"details":{"type":"string","minLength":5,"maxLength":4000,"description":"What, where, when, how many people, names, constraints"},"contact_email":{"type":"string","description":"Optional email for the quote and result"},"callback_url":{"type":"string","description":"Optional public https URL that receives status updates as JSON"},"language":{"type":"string","description":"Preferred language for replies, e.g. en, ja, zh"},"budget_jpy":{"type":"integer","minimum":0,"description":"Optional budget in JPY"}},"required":["service","details"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"search_address","title":"Find a Japanese postcode by address","description":"Find postcodes by part of a Japanese address or an office name, e.g. 大阪市北区梅田.","inputSchema":{"type":"object","properties":{"text":{"type":"string","description":"Part of the address in Japanese"}},"required":["text"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"search_company","title":"Search Japanese companies","description":"Search all ~5.8 million corporations registered in Japan by name (Japanese, partial match). Returns corporate number, address, type and whether it is closed. Use the corporate number with get_company_profile.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Company name or part of it, in Japanese, e.g. トヨタ自動車"},"prefecture":{"type":"string","description":"Optional prefecture filter in Japanese, e.g. 大阪府"},"include_closed":{"type":"boolean","description":"Include closed corporations (default false)"},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["name"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"search_listed_companies","title":"Find listed Japanese companies","description":"Filter companies that file securities reports in Japan (EDINET) by industry (Japanese name, e.g. 不動産業, 輸送用機器) and minimum capital. Returns securities code and capital.","inputSchema":{"type":"object","properties":{"industry":{"type":"string","description":"EDINET industry name in Japanese"},"min_capital_million_yen":{"type":"number","minimum":0},"listed_only":{"type":"boolean","description":"Only listed companies (default true)"},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":[],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"search_osaka_stays","description":"查大阪民宿及房型，无需凭证。参考起价不是最终报价。Search Osaka stays and room types; prices indicative.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":200},"guests":{"type":"integer","minimum":1,"maximum":100},"locale":{"type":"string","enum":["zh-CN","zh-TW","en","ja","ko"]},"limit":{"type":"integer","minimum":1,"maximum":50}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false}},{"name":"submit_osaka_booking_request","description":"这是申请不是订成，不锁房、不收费。Home-booking 人工报价及代订。请把返回的专属链接私下交给客人保存，客人本人在该页确认报价后去 Home-booking 刷卡；邮件送达未核实，不可承诺一定收到邮件。绝不在工具里收款或收集卡号、护照。 Only after explicit guest consent to saving contact details and contacting the property. Reuse idempotencyKey on retries. No quote acceptance or checkout in this tool.","inputSchema":{"type":"object","properties":{"propertyId":{"type":"string"},"roomId":{"type":"string"},"checkIn":{"type":"string"},"checkOut":{"type":"string"},"guestName":{"type":"string"},"email":{"type":"string"},"idempotencyKey":{"type":"string"},"guests":{"type":"integer","minimum":1,"maximum":100},"consentToContact":{"type":"boolean","const":true},"locale":{"type":"string","enum":["zh-CN","zh-TW","en","ja","ko"]}},"required":["propertyId","roomId","checkIn","checkOut","guests","guestName","email","idempotencyKey","consentToContact"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}],"resources":[{"uri":"maru://order/shops","name":"MARU Order shops","title":"MARU Order shop list","description":"Restaurants that take orders through MARU Order","mimeType":"application/json"}]}