AGAgent.chain.tokyo

X402 LOCATION CONTRACT API · JAPAN · PREVIEW

AIエージェントが、
日本の住所契約を完了する。

Agent.chain.tokyoは、AIエージェントが日本国内の拠点と1〜65535階の仮想フロアを選び、x402 v2で支払い、30日間の郵便受取住所契約を取得するAPIです。

OpenAPIを読むMCPを接続API catalog

Preview: Solana Devnet上のテスト環境です。Devnet USDCに金銭価値はなく、実際の郵便取扱いを開始するにはオーナーのKYCと転送先登録が必要です。

VERIFIED SERVICE FACTS

判断に必要な情報

PRICE0.55 USDC

1拠点・1フロア・30日間。新しい固定額Intentを順番に決済すれば、期限前でも1回ごとに30日を先払いできます。

PAYMENTx402 v2 exact

Solana Devnet。外部ウォレットを使い、秘密鍵をAgent.chain.tokyoへ渡しません。

DISCLOSURE決済後のみ

決済前はエリア概要だけを公開し、正確な日英住所はsettlement後に返します。

FLOORS1〜65535階

未契約の階を選択します。Intent予約中または他者が契約中の階は選択できません。

CONTRACT FLOW

エージェントの実行手順

  1. 01
    拠点と階を選ぶ

    GET /v1/locationsで候補を比較し、GET /v1/locations/{locationId}/floors/{floor}で1〜65535階の選択可否を確認します。

  2. 02
    Payment Intentを作成

    POST /v1/payment-intentsへlocationIdとfloorを送ります。選択階は15分間予約されます。

  3. 03
    x402で支払う

    返されたpayPathをx402対応clientで呼び、challengeを検証して決済します。

  4. 04
    住所と階の契約を受け取る

    settlement後、30日間の権利、選択階、スナップショットされた日本語・英語住所を受け取ります。同じ契約へ新しい0.55 USDC Intentを順番に決済すると、その時点の終了日から30日ずつ加算されます。

  5. 05
    オーナーが利用準備

    オーナー専用KYC画面で本人確認と転送先登録を完了します。

MODEL CONTEXT PROTOCOL

MCPから直接操作できる

https://agent.chain.tokyo/mcpでMCP 2026-07-28のstateless HTTP endpointを提供します。RESTと同じPreview Bearer tokenとowner IDをheaderへ設定します。

MCP server: https://agent.chain.tokyo/mcp
Authorization: Bearer <preview_agent_token>
X-Paygate-Owner-Id: <owner-id>

tools:
  list_locations
  get_floor_availability
  create_payment_intent
  list_contracts

Payment Intent作成は階を15分間予約しますが、MCPサーバーはウォレット署名を行いません。返されたx402 payment URLを外部ウォレット対応clientで支払います。同じ契約の先払いも1回0.55 USDCの新しいIntentを順番に作成・決済します。KYC、転送先変更、admin操作はAgent向けMCP toolではありません。

MACHINE DISCOVERY

APIとして発見できる

OpenAPI 3.1、IETF RFC 9727 API catalog、MCP endpointを公開しています。すべての業務requestにはPreview Bearer tokenとowner IDが必要です。

Authorization: Bearer <preview_agent_token>
X-Paygate-Owner-Id: <owner-id>

GET  /v1/locations
GET  /v1/locations/{locationId}/floors/{floor}
POST /v1/payment-intents  { locationId, floor }

DIRECT ANSWERS

よくある質問

0.55 USDCで何を購入できますか？

選択した日本国内の1拠点・1フロアについて、30日間の住所契約を購入できます。PreviewのDevnet USDCには金銭価値がありません。

どの階を選べますか？

1〜65535の整数階を選べます。他のPayment Intentが予約中の階、または他の有効な契約が使用中の階は選択できません。現在の契約者は同じ階を更新できます。

支払い前にKYCは必要ですか？

必要ありません。ただし、実際の郵便取扱いを始める前に、Account OwnerのKYC承認と拠点ごとの転送先登録が必要です。

正確な住所は公開されていますか？

公開されません。決済前の拠点一覧にはエリア概要のみを載せ、正確な日本語・英語住所はsettlement後のresponseだけで開示します。

MCPから契約できますか？

Location一覧、階の空き確認、Payment Intent作成、契約一覧をMCP toolとして利用できます。実際のx402支払いは返されたURLを外部ウォレット対応clientで実行します。

何期間分でも先払いできますか？

できます。現在の契約者が同じ拠点・階について新しい0.55 USDCのPayment Intentを順番に決済すると、1回ごとに現在の終了日から30日加算します。任意額や端数残高は扱わず、支払い済み期間の返金はありません。

あとからAIエージェントへ連絡できますか？

はい。90日保持のAgent event inboxをGET /v1/agent-eventsまたはMCPのlist_eventsで取得できます。専用Agent credentialがあれば署名付きHTTPS Webhookも登録できます。Webhookは再送・重複し得る起床通知なので、受信後はinboxと現在の契約状態を取得してください。

契約期限の通知や顧客サポートはありますか？

はい。決定的なコードが30日・7日・1日前の期限イベントを作成し、オーナーまたはowner-bound Agentは非同期サポートAPIを利用できます。サポート回答は承認済みFirestoreナレッジとOrcaRouterを使いますが、LLMは契約、決済、KYC、転送先を変更できません。

本番サービスですか？

いいえ。現時点ではSolana Devnetと共有Preview tokenを使う検証環境です。実資金や本番データには使用できません。

ENGLISH SUMMARY

Japanese mailbox Location contracts for AI agents

Agent.chain.tokyo lets an authenticated AI agent select a Japanese Location and one virtual floor from 1 through 65535, create a server-bound Payment Intent, settle a fixed 0.55 USDC x402 v2 payment on Solana Devnet, and receive a 30-day entitlement with the exact address, floor, and Japanese and English address text. The current owner can prepay sequentially: every new settled 0.55 USDC Intent adds 30 days from the existing future period end. Partial balances and refunds are not supported. Floors held by another active contract or intent reservation are unavailable. Payment is not identity evidence. The Account Owner must complete KYC and register a per-contract forwarding destination before physical mail handling. Later changes are retained in a durable Agent event inbox available through REST or MCP. Optional signed Webhooks are wake-up signals only. Deterministic deadline reconciliation creates 30-, 7- and 1-day reminders. Owner-bound support retrieves approved Firestore knowledge and sanitized account state, while OrcaRouter drafts text without state-changing authority.