# Agent.chain.tokyo

> Preview API and MCP server for AI agents to purchase a 30-day Japanese mailbox Location-and-floor contract with x402 v2 exact on Solana Devnet.

## Verified facts

- Price: 0.55 USDC (550,000 base units) per Location and floor for one 30-day period.
- Prepayment: the current owner may create and settle new fixed 0.55 USDC Intents sequentially before expiry. Every distinct settlement adds 30 days from the existing future period end, with no application-defined period-count cap. Partial amounts and remainder balances are not supported. Paid periods are non-refundable.
- Floors: select one integer floor from 1 through 65535. A floor reserved by another active Payment Intent or occupied by another active contract is unavailable; the current contract owner may renew the same floor.
- Intent reservation: creating a Payment Intent reserves the selected floor for the intent's 15-minute lifetime.
- Environment: preview only; Solana Devnet USDC has no monetary value.
- Authentication: REST and MCP accept the preview Bearer token with X-Paygate-Owner-Id or an administrator-provisioned owner-bound Agent Bearer token with X-Paygate-Agent-Id. Dedicated credentials have explicit scopes and expiry, support rotation and immediate revocation, and are required to manage Webhook destinations. Protected-resource metadata: https://agent.chain.tokyo/.well-known/oauth-protected-resource/mcp.
- MCP: stateless HTTP at https://agent.chain.tokyo/mcp using protocol revision 2026-07-28. Tools are list_locations, get_floor_availability, create_payment_intent, list_contracts and list_events.
- Agent follow-up: poll the durable 90-day event inbox at REST /v1/agent-events or MCP list_events. Optional Ed25519-signed Webhooks are wake-up signals and may be duplicated; consumers fetch the durable event and current resource state after notification.
- Deadline manager: deterministic hourly reconciliation emits 30-, 7- and 1-day expiry reminders, records expiration, and uses the existing inbox/Webhook path. The LLM cannot mutate a contract.
- Support: authenticated owners and owner-bound Agents may queue a question at REST /v1/support/requests. The private manager retrieves approved Firestore knowledge and a sanitized owner context, then uses OrcaRouter only to draft the answer. Do not send secrets, identity documents, forwarding addresses or payment proofs.
- Webhook key: https://agent.chain.tokyo/.well-known/paygate89-webhook-key.
- Discovery: Location summaries never contain exact mailbox addresses.
- Settlement: the API persists the Pay.sh PAYMENT-RESPONSE transaction signature and independently verifies the Solana network, native USDC mint, exact amount, recipient, and confirmed/finalized status before extending the contract or returning the exact address.
- KYC ordering: purchase may occur before KYC; physical mail handling requires owner KYC approval and a per-Location-and-floor forwarding destination.
- Wallet safety: callers use an external wallet; Agent.chain.tokyo does not receive payer seed phrases or private keys.

## Machine-readable resources

- OpenAPI: https://agent.chain.tokyo/openapi.json
- API catalog: https://agent.chain.tokyo/.well-known/api-catalog
- MCP server: https://agent.chain.tokyo/mcp
- Health: https://agent.chain.tokyo/health

## Human entry points

- Agent service guide: https://agent.chain.tokyo/
- Account Owner guide: https://agent.chain.tokyo/owner
- Account Owner KYC: https://agent.chain.tokyo/owner/kyc
- Account Owner support: https://agent.chain.tokyo/owner/support

Do not infer production readiness, mainnet support, public exact addresses, or authorization for physical mail handling from this preview.