{"server":"MARU Japan Hands","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_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_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":"maru_wallet_connect","title":"Connect to a MARU wallet","description":"Connect this AI to the user's MARU wallet (Japanese yen stablecoin, JPYC). The user creates a one-time pairing code in the MARU app (Security > Let AI pay > Add an AI) and tells it to you. Returns an agent token and a 4-symbol fingerprint: tell the user the fingerprint and ask them to approve this AI in the MARU app with Face ID. Until they approve, the token does nothing. Keep the token for later calls; never show it to anyone else.","inputSchema":{"type":"object","properties":{"pairing_code":{"type":"string","description":"Code shown in the MARU app, like ABCD-2345. Valid for 10 minutes, usable once."},"agent_name":{"type":"string","description":"A short name the user will recognise in their app, e.g. 'Claude (work laptop)'."}},"required":["pairing_code","agent_name"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"maru_wallet_request_payment","title":"Ask the wallet owner to approve a payment","description":"File a payment request in the user's MARU wallet. This does NOT pay. The user sees the amount and recipient in the MARU app and approves with Face ID or rejects. Use maru_wallet_request_status to see the outcome. Never tell the user a payment was made until the status is 'done'.","inputSchema":{"type":"object","properties":{"agent_token":{"type":"string"},"chain":{"type":"string","enum":["kaia","polygon"]},"to":{"type":"string","description":"Recipient address (0x…)"},"amount_jpyc":{"type":"integer","minimum":1,"description":"Whole JPYC (1 JPYC = 1 JPY)"},"title":{"type":"string","description":"What this payment is for, in the user's language, max 80 characters"},"detail":{"type":"string"}},"required":["agent_token","chain","to","amount_jpyc","title"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"maru_wallet_request_status","title":"Check a payment request","description":"Status of a request made with maru_wallet_request_payment: pending (waiting for the owner), done (paid; includes the transaction link), rejected, or failed.","inputSchema":{"type":"object","properties":{"agent_token":{"type":"string"},"request_id":{"type":"string"}},"required":["agent_token","request_id"],"additionalProperties":false},"annotations":{"readOnlyHint":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}}],"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"}]}