io.github.akihidem/japan-hands
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Japan Hands — app
日本、東京で唯一のエージェント向けサービス The only service in Tokyo, Japan designed exclusively for AI agents.
AI エージェントが日本国内の物理タスク(買い物代行・在庫確認・現地撮影・レストランの電話予約・並び代行・荷物の受け取り転送)を人間に依頼できる、エージェント専用の窓口です。人間向け店舗サイトは作りません。仕様の正本は ../SPEC.md。
ランディング:
public/index.html(最小限。人間が読んでも分かる体裁)機械可読カタログ:
GET /api/services(別名/catalog)、GET /llms.txt、GET /server.jsonMCP サーバ:
POST /mcp(streamable HTTP、ステートレス JSON-RPC)REST:
POST /api/quote/GET /api/quotes/{id}/POST /api/quotes/{id}/accept/POST /api/quotes/{id}/decline/GET /api/tasks/{id}/evidence/GET /api/health
ゼロ依存(Node 標準のみ)。Vercel プロジェクトとして完結します。
運営コンソール
タスクの確認・却下、状態遷移、証拠の添付、依頼者への返信は運営側 CLI で行います(HTTP には公開しません)。
vercel env pull .env.local # 本番 KV の認証情報を取得(.env.local は gitignore 済み)
node scripts/ops.mjs list
node scripts/ops.mjs confirm <task_id> --note "..."
node scripts/ops.mjs decline <task_id> --reason "..."
node scripts/ops.mjs status <task_id> in_progress|completed|failed
node scripts/ops.mjs evidence <task_id> --type photo --url <url> --label "..."
node scripts/ops.mjs reply <id> --message "..."Related MCP server: ProofStream MCP Server
セキュリティと支払いゲート
レート制限: IP 単位で見積もり 20件/時、書き込み系 60件/時、MCP 呼び出し 300件/時(環境変数で調整可)。超過は 429。
リクエスト上限: JSON ボディは 64KB まで。
アクセストークン: 見積もりごとに発行し、ハッシュ化して保存。タスクの読み書きには必須。
支払いゲート: Stripe の Webhook(
POST /api/stripe/webhook、署名検証必須・失敗時は閉じる)で入金を確認して初めてタスクがpaidになり、運営コンソールのconfirmは未払いタスクを拒否します。手作業で入金を記録する場合のみops.mjs paidを使います。つまり 入金確認が取れるまで仕事は始まりません。秘密情報はコードに入れません: 鍵類はすべて環境変数。公開リポジトリに秘密は含まれません。
ローンチ形の決定(2026-11-16)の反映
見積もりは即時。ただし accept しても実行は確定しません。タスクは
pending_review(担当者の確認待ち)になり、担当者が1件ずつ確認して可否を返します。エージェント向け文面のどこにも、即実行・即日完了の約束はありません。秋葉原の平日デイリー便・銀座プレミアムは「確認のうえ可否を返す」範囲でのみ触れています。
カタログに宿の予約は入れていません(電話予約はレストランのみ。旅行業法対応)。CAPTCHA 突破・本人確認の肩代わり等は
not_offeredとして明示しています。決済(Stripe)の実連携は含みません。料金表示と見積もりロジックまでです。
料金
lib/catalog.js が唯一の正本です(見積もり手数料 ¥2,200/着手手数料はサービス別下限〜/最低着手料 ¥5,500/総額=商品代金+手数料+送料)。USD は見積もり時にレートを固定して明記します(HFA_USDJPY_RATE、未設定時は 150)。
開発・検証
npm run dev # http://localhost:8787(Vercel と同じハンドラをマウント)
npm test # スモークテスト(カタログ・見積もり計算・pending_review・宿拒否・MCP)デプロイ(Vercel)
前提: Vercel コネクタの OAuth 接続(vercel status が not_connected の間はデプロイ不可)。
本人(または接続済みの窓口)が Vercel に接続する: 接続 URL は
https://agent.meta.ai/connectors/connect/vercel接続後、この
app/をプロジェクトとしてデプロイする(カスタムドメインは付けない。*.vercel.appの URL を使う)デプロイ URL が確定したら、次を差し替える:
server.jsonとpublic/server.jsonのremotes[0].url(https://<deployment>/mcp)public/index.htmlの curl 例のYOUR-DEPLOYMENT
本番では必ず KV を設定する(下記)。未設定だと台帳は
/tmpの一時ファイルになり、再デプロイで消えます。
環境変数
変数 | 用途 |
| Vercel KV / Upstash Redis の REST 接続。台帳(quotes/tasks)の保存先。未設定時はローカルファイルにフォールバック( |
|
|
| 通知メール送信(Resend API) |
| 通知先。運営者のメールアドレス(必須・環境変数で指定) |
| 通知元。既定は Resend の onboarding アドレス(本番では独自ドメイン推奨) |
| USD 見積もりの固定レート(円/ドル)。未設定時は 150 |
通知(受付 → 運営者のメール)の設定方法
Resend(https://resend.com)で API キーを発行する
Vercel のプロジェクト環境変数に
HFA_NOTIFY_ENABLED=1、RESEND_API_KEY=...、HFA_NOTIFY_TO=<運営者のメールアドレス>を設定して再デプロイrequest_quoteとaccept_quoteのたびに、依頼内容の JSON がメールで届く。通知の失敗は依頼フロー自体を止めません(レスポンスのnotificationフィールドで成否が分かります)届いた依頼は台帳(KV / ローカルファイル)にも必ず残ります。担当者はメールを起点に、本人へ1件ずつ相談してから可否を返します
MCP レジストリ登録
server.json(ルートと public/ の2か所、同内容)が公式 MCP レジストリ用のマニフェストです。
デプロイ URL を確定し、
server.jsonのremotes[0].urlを差し替える名前
ai.handsforagents/hands-for-agentsはドメイン(handsforagents.ai)の所有確認が前提です。ドメイン取得は本人の担当範囲なので、取得までは登録を進めません。ドメインなしで先に試す場合は GitHub 方式の名前(io.github.<owner>/hands-for-agents)に差し替えてください登録手順(公式レジストリ https://registry.modelcontextprotocol.io):
# mcp-publisher を取得(https://github.com/modelcontextprotocol/registry の Releases) ./mcp-publisher login dns --domain handsforagents.ai # または login github ./mcp-publisher publish # server.json のある場所で実行登録後は
GET https://registry.modelcontextprotocol.io/v0/servers?search=hands-for-agentsで掲載を確認する
構成
api/ Vercel Functions(mcp / services / quote / quotes / tasks / health)
lib/ catalog.js(料金・カタログの正本)/ pricing.js / tools.js(MCP・REST 共通実装)
store.js(KV ⇄ ファイルのアダプタ)/ notify.js(メール通知フック)/ http.js
public/ index.html(ランディング)/ llms.txt / server.json
server.json MCP レジストリ用マニフェスト
dev-server.js ローカル開発用(Vercel と同じハンドラ)
test/smoke.mjs スモークテストTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Human services in Japan for AI agents: phone calls, reservations, shopping and on-site checks.
Human task execution in Tokyo, Japan, exclusively for AI agents: shopping, checks, photos, bookings.
Hire a real person for your AI agent: real-world tasks done with photo or video proof.
Pickup orders at Japanese restaurants for AI agents: find stores, read menus, place orders. No auth.
Related MCP Servers
- AlicenseBqualityDmaintenancePay-per-use API tools and LLM gateway for AI agents. 15 services (DART, Tabelog, Google Maps, Brave Search, Firecrawl, DeepL, ElevenLabs, and more) + smart LLM routing. No API keys needed, pay with USDC on Base.2574 npm2MIT
- AlicenseAqualityCmaintenanceEnables AI agents to dispatch human verifiers for physical world tasks like product authentication, property inspection, and document verification, returning timestamped evidence reports.347 npmMIT
- AlicenseAqualityCmaintenanceJapan Operations OS for AI agents — 14 knowledge domains covering regulations, protocols, calendar, travel, food culture, language, disaster safety, daily life, and persistent memory. 31 MCP tools via REST + Streamable HTTP.31MIT

humanforaiofficial
AlicenseAqualityCmaintenanceEnables AI agents to hire verified human operators for tasks requiring physical presence, human perception, or judgment, such as real-world verification, product testing, and data collection.6MIT