Human services in Japan for AI agents: phone calls, reservations, shopping and on-site checks.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
This tool takes no arguments.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http maru-japan-hands https://maru.senpinai.com/mcp
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.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Check whether a MARU Order restaurant is taking takeout orders now, its hours and whether it accepts JPYC with a discount.
| Argument | Type | Description |
|---|---|---|
| shop* | string |
{
"type": "object",
"required": [
"shop"
],
"properties": {
"shop": {
"type": "string"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| shop* | string | Shop slug, e.g. maru-demo |
{
"type": "object",
"required": [
"shop"
],
"properties": {
"shop": {
"type": "string",
"description": "Shop slug, e.g. maru-demo"
}
},
"additionalProperties": false
}Get the status of a request: received, quoted (price and how to pay), paid, in_progress, done (with result), cancelled or refunded.
| Argument | Type | Description |
|---|---|---|
| request_id* | string | The request_id returned by request_service |
{
"type": "object",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"description": "The request_id returned by request_service"
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| agent_name* | string | A short name the user will recognise in their app, e.g. 'Claude (work laptop)'. |
| pairing_code* | string | Code shown in the MARU app, like ABCD-2345. Valid for 10 minutes, usable once. |
{
"type": "object",
"required": [
"pairing_code",
"agent_name"
],
"properties": {
"agent_name": {
"type": "string",
"description": "A short name the user will recognise in their app, e.g. 'Claude (work laptop)'."
},
"pairing_code": {
"type": "string",
"description": "Code shown in the MARU app, like ABCD-2345. Valid for 10 minutes, usable once."
}
},
"additionalProperties": false
}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'.
| Argument | Type | Description |
|---|---|---|
| to* | string | Recipient address (0x…) |
| chain* | string | |
| title* | string | What this payment is for, in the user's language, max 80 characters |
| detail | string | |
| agent_token* | string | |
| amount_jpyc* | integer | Whole JPYC (1 JPYC = 1 JPY) |
{
"type": "object",
"required": [
"agent_token",
"chain",
"to",
"amount_jpyc",
"title"
],
"properties": {
"to": {
"type": "string",
"description": "Recipient address (0x…)"
},
"chain": {
"enum": [
"kaia",
"polygon"
],
"type": "string"
},
"title": {
"type": "string",
"description": "What this payment is for, in the user's language, max 80 characters"
},
"detail": {
"type": "string"
},
"agent_token": {
"type": "string"
},
"amount_jpyc": {
"type": "integer",
"minimum": 1,
"description": "Whole JPYC (1 JPYC = 1 JPY)"
}
},
"additionalProperties": false
}Status of a request made with maru_wallet_request_payment: pending (waiting for the owner), done (paid; includes the transaction link), rejected, or failed.
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| agent_token* | string |
{
"type": "object",
"required": [
"agent_token",
"request_id"
],
"properties": {
"request_id": {
"type": "string"
},
"agent_token": {
"type": "string"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name for the order |
| shop* | string | |
| items* | array | |
| contact | string | Phone or email for the shop to reach the customer |
| pickup_time* | string | Pickup time today in JST, HH:MM |
{
"type": "object",
"required": [
"shop",
"items",
"pickup_time",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name for the order"
},
"shop": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"qty"
],
"properties": {
"id": {
"type": "string",
"description": "Item id from get_menu"
},
"qty": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"options": {
"type": "object",
"description": "Group name -> list of chosen option names",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"additionalProperties": false
},
"maxItems": 30,
"minItems": 1
},
"contact": {
"type": "string",
"description": "Phone or email for the shop to reach the customer"
},
"pickup_time": {
"type": "string",
"description": "Pickup time today in JST, HH:MM"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| item_url | string | Product page URL in Japan (Rakuten, Amazon.co.jp, brand store, etc.) |
| quantity | integer | |
| item_name | string | Product name |
| item_price_jpy* | integer | Price per unit in JPY, tax included, as shown on the shop page |
| ship_to_country* | string | ISO 2-letter country code of the destination, e.g. US, TW, CN; JP for Japan |
| estimated_weight_kg | number | Item weight in kg if known (default 1.0) |
| seller_shipping_jpy | integer | Shop's shipping to our address in Japan, if any |
{
"type": "object",
"required": [
"item_price_jpy",
"ship_to_country"
],
"properties": {
"item_url": {
"type": "string",
"description": "Product page URL in Japan (Rakuten, Amazon.co.jp, brand store, etc.)"
},
"quantity": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"item_name": {
"type": "string",
"description": "Product name"
},
"item_price_jpy": {
"type": "integer",
"minimum": 1,
"description": "Price per unit in JPY, tax included, as shown on the shop page"
},
"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",
"maximum": 30,
"minimum": 0.01,
"description": "Item weight in kg if known (default 1.0)"
},
"seller_shipping_jpy": {
"type": "integer",
"minimum": 0,
"description": "Shop's shipping to our address in Japan, if any"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| details* | string | What, where, when, how many people, names, constraints |
| service* | string | Service id from list_services |
| language | string | Preferred language for replies, e.g. en, ja, zh |
| budget_jpy | integer | Optional budget in JPY |
| callback_url | string | Optional public https URL that receives status updates as JSON |
| contact_email | string | Optional email for the quote and result |
{
"type": "object",
"required": [
"service",
"details"
],
"properties": {
"details": {
"type": "string",
"maxLength": 4000,
"minLength": 5,
"description": "What, where, when, how many people, names, constraints"
},
"service": {
"enum": [
"ai_agent_integration",
"custom",
"interpreting",
"phone_call",
"photo_check",
"property_search",
"property_viewing",
"queue_pickup",
"restaurant_booking",
"software_development",
"stay_osaka",
"store_purchase"
],
"type": "string",
"description": "Service id from list_services"
},
"language": {
"type": "string",
"description": "Preferred language for replies, e.g. en, ja, zh"
},
"budget_jpy": {
"type": "integer",
"minimum": 0,
"description": "Optional budget in JPY"
},
"callback_url": {
"type": "string",
"description": "Optional public https URL that receives status updates as JSON"
},
"contact_email": {
"type": "string",
"description": "Optional email for the quote and result"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.