Directory / Commerce, travel & logistics
MARU Japan Hands
Human services in Japan for AI agents: Japanese phone calls, reservations, shopping and on-site checks. Human services are paid.
Live Answered an MCP handshake without credentials and listed 11 tools.
- Category
- Commerce, travel & logistics
- Transport
http- Source
- https://github.com/ihouse-corp/maru-japan-hands
- Endpoint
https://maru.senpinai.com/mcp- MCP Registry
io.github.ihouse-corp/maru-japan-hands- Reports itself as
- maru-japan-hands 0.1.0
- Protocol
- 2025-06-18
- Tools
- 11
- Context cost
- about 1,874 tokens for the tool definitions (estimated at four characters per token)
- Tool definitions last changed
- no change seen since first check
- Handshake time
- 597 ms
- Repository
- 0 stars · last push 2026-11-17
- Last checked
- 2026-11-22 11:27:40 UTC
- Listed since
- 2026-11-18
Health and compatibility
| Endpoint reachable | Verified | Responded in 597 ms |
|---|---|---|
| MCP handshake (initialize) | Verified | Completed without credentials |
| Tool discovery (tools/list) | Verified | 11 tools listed |
| Authentication | Verified | None needed to connect |
| Protocol version | Verified | 2025-06-18 |
| Transport | Verified | Streamable HTTP |
| Capabilities declared | Verified | resources, tools |
Last checked . Verified means the check saw it happen; it says nothing about whether the server is safe.
Recent history
5 daily checks so far; median response 578 ms. Green answered, violet asked for auth, red did not answer.
Set up in your client
Claude Code
Run this in a terminal:
claude mcp add --transport http maru-japan-hands https://maru.senpinai.com/mcpClaude Desktop
Open Settings → Connectors → Add custom connector and paste this URL:
https://maru.senpinai.com/mcpOr bridge it through mcp-remote in claude_desktop_config.json (needs Node.js):
{
"mcpServers": {
"maru-japan-hands": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maru.senpinai.com/mcp"
]
}
}
}Cursor
Or add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"maru-japan-hands": {
"url": "https://maru.senpinai.com/mcp"
}
}
}VS Code
Or add it to .vscode/mcp.json:
{
"servers": {
"maru-japan-hands": {
"type": "http",
"url": "https://maru.senpinai.com/mcp"
}
}
}Or from a terminal:
code --add-mcp '{"name": "maru-japan-hands", "type": "http", "url": "https://maru.senpinai.com/mcp"}'Windsurf
Add it to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"maru-japan-hands": {
"serverUrl": "https://maru.senpinai.com/mcp"
}
}
}Other clients
Most clients accept this shape. The endpoint is:
https://maru.senpinai.com/mcp{
"mcpServers": {
"maru-japan-hands": {
"type": "http",
"url": "https://maru.senpinai.com/mcp"
}
}
}If it does not connect
- Restart the client after editing a config file, and keep keys out of files you commit.
- If the tools do not appear, open the client's MCP log: a 401 means the credentials were not accepted, and a timeout means the server did not answer.
Tools 11
Names, descriptions and input schemas exactly as the server returned them on 2026-11-22. This is the server author's own text. Nothing is run from this page. Labels such as read-only are declared by the server and are not verified. Raw JSON
check_availabilityread-onlyCheck whether a new request can be taken now. Remote work (calls, online reservations) has a daily limit; …
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.
Takes no parameters.
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "check_availability",
"arguments": {}
}
}check_openread-onlyCheck whether a MARU Order restaurant is taking takeout orders now, its hours and whether it accepts JPYC …
Check whether a MARU Order restaurant is taking takeout orders now, its hours and whether it accepts JPYC with a discount.
| Parameter | Type | Description | |
|---|---|---|---|
shop | string | required |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "check_open",
"arguments": {
"shop": "..."
}
}
}get_menuread-onlyGet a MARU Order restaurant's menu: categories, items with tax-included JPY prices, options (size, toppings), …
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.
| Parameter | Type | Description | |
|---|---|---|---|
shop | string | required | Shop slug, e.g. maru-demo |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_menu",
"arguments": {
"shop": "..."
}
}
}get_request_statusread-onlyGet the status of a request: received, quoted (price and how to pay), paid, in_progress, done (with result), …
Get the status of a request: received, quoted (price and how to pay), paid, in_progress, done (with result), cancelled or refunded.
| Parameter | Type | Description | |
|---|---|---|---|
request_id | string | required | The request_id returned by request_service |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_request_status",
"arguments": {
"request_id": "..."
}
}
}list_servicesread-onlyList the services MARU Japan Hands provides in Japan (Japanese phone calls, restaurant and golf reservations, …
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.
Takes no parameters.
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "list_services",
"arguments": {}
}
}maru_wallet_connectcan modifyConnect this AI to the user's MARU wallet (Japanese yen stablecoin, JPYC). The user creates a one-time …
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.
| Parameter | Type | Description | |
|---|---|---|---|
pairing_code | string | required | Code shown in the MARU app, like ABCD-2345. Valid for 10 minutes, usable once. |
agent_name | string | required | A short name the user will recognise in their app, e.g. 'Claude (work laptop)'. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "maru_wallet_connect",
"arguments": {
"pairing_code": "...",
"agent_name": "..."
}
}
}maru_wallet_request_paymentcan modifyFile a payment request in the user's MARU wallet. This does NOT pay. The user sees the amount and recipient …
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'.
| Parameter | Type | Description | |
|---|---|---|---|
agent_token | string | required | |
chain | string | required | One of: kaia, polygon |
to | string | required | Recipient address (0x…) |
amount_jpyc | integer | required | Whole JPYC (1 JPYC = 1 JPY) |
title | string | required | What this payment is for, in the user's language, max 80 characters |
detail | string | optional |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "maru_wallet_request_payment",
"arguments": {
"agent_token": "...",
"chain": "kaia",
"to": "...",
"amount_jpyc": 0,
"title": "..."
}
}
}maru_wallet_request_statusread-onlyStatus of a request made with maru_wallet_request_payment: pending (waiting for the owner), done (paid; …
Status of a request made with maru_wallet_request_payment: pending (waiting for the owner), done (paid; includes the transaction link), rejected, or failed.
| Parameter | Type | Description | |
|---|---|---|---|
agent_token | string | required | |
request_id | string | required |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "maru_wallet_request_status",
"arguments": {
"agent_token": "...",
"request_id": "..."
}
}
}place_takeout_ordercan modifyexternal accessPlace a takeout order. Returns an order number and a link. The customer pays at pickup at the counter, or …
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.
| Parameter | Type | Description | |
|---|---|---|---|
shop | string | required | |
items | object[] | required | |
pickup_time | string | required | Pickup time today in JST, HH:MM |
name | string | required | Name for the order |
contact | string | optional | Phone or email for the shop to reach the customer |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "place_takeout_order",
"arguments": {
"shop": "...",
"items": [],
"pickup_time": "...",
"name": "..."
}
}
}quote_purchaseread-onlyInstant cost estimate to buy an item sold in Japan and ship it: item price (from the shop page the user or …
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.
| Parameter | Type | Description | |
|---|---|---|---|
item_name | string | optional | Product name |
item_url | string | optional | Product page URL in Japan (Rakuten, Amazon.co.jp, brand store, etc.) |
item_price_jpy | integer | required | Price per unit in JPY, tax included, as shown on the shop page |
quantity | integer | optional | |
seller_shipping_jpy | integer | optional | Shop's shipping to our address in Japan, if any |
ship_to_country | string | required | ISO 2-letter country code of the destination, e.g. US, TW, CN; JP for Japan |
estimated_weight_kg | number | optional | Item weight in kg if known (default 1.0) |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "quote_purchase",
"arguments": {
"item_price_jpy": 0,
"ship_to_country": "..."
}
}
}request_servicecan modifyexternal accessSend a request for a service in Japan. Fixed-price services (phone_call JPY 1,500, restaurant_booking JPY …
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.
| Parameter | Type | Description | |
|---|---|---|---|
service | string | required | Service id from list_services One of: ai_agent_integration, custom, interpreting, phone_call, photo_check, property_search, property_viewing, queue_pickup … |
details | string | required | What, where, when, how many people, names, constraints |
contact_email | string | optional | Optional email for the quote and result |
callback_url | string | optional | Optional public https URL that receives status updates as JSON |
language | string | optional | Preferred language for replies, e.g. en, ja, zh |
budget_jpy | integer | optional | Optional budget in JPY |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "request_service",
"arguments": {
"service": "ai_agent_integration",
"details": "..."
}
}
}Resources 1
MARU Order shopsRestaurants that take orders through MARU Order
Badge
Maintain this server? Put its live status in your README:
[](https://mcp.aianytime.net/s/maru-japan-hands/)Edit this entry · Report a problem
More in Commerce, travel & logistics
Checks record what a server answered, not whether it is safe. A listing is not a security audit; read a server's source and permissions before you connect it. Add a server · JSON · llms.txt · llms-full.txt
Browse: Agents, IDEs & developer tools · Search & discovery · Knowledge, memory & context · Media & generation · Security · Finance & markets · Marketing, content & social · Cloud, ops & data · Commerce, travel & logistics · Work & productivity · No account needed · Local servers