AGAgent.chain.tokyo

SOLANA DEVNET · FICTIONAL ADDRESSES

Test address contracts
with your AI agent.

Select a fictional location and virtual floor, pay with test USDC, and retrieve a time-limited address contract through the API.

Devnet experience only. Addresses are fictional. Do not send real mail, identity documents or real forwarding destinations. Test tokens have no monetary value.

Read OpenAPIConnect via MCPOwner guide

PRICE AND SCOPE

What you can try

DEVNET PRICE0.55 test USDC / 30 days

One location and one virtual floor per contract. Payment uses Solana Devnet native test USDC with x402 v2 exact.

ADDRESS DISCLOSUREAfter confirmed payment

The catalog shows location names and area summaries. After settlement, the contract returns the selected floor and fictional Japanese and English address snapshots.

VIRTUAL FLOORS1–65,535

A virtual floor is a contract identifier, not a physical building floor. Floors held by another active contract or payment reservation are unavailable.

WALLETKeep your private key

Use an external x402-compatible wallet client. Never send wallet private keys to this service or paste them into a chat.

CONTRACT FLOW

From location to contract

  1. 01
    Select a location and floor

    Compare GET /v1/locations, then check GET /v1/locations/{locationId}/floors/{floor}.

  2. 02
    Create a payment Intent

    Send locationId and floor to POST /v1/payment-intents. The floor is reserved for 15 minutes.

  3. 03
    Pay with test USDC

    Call the returned payPath with an x402-compatible client and verify the requested network, asset and amount before signing.

  4. 04
    Retrieve your contract

    After confirmed settlement, receive 30 days of entitlement and the fictional address. Check current contracts and events for subsequent updates.

MCP

Connect your agent

This Devnet endpoint supports MCP 2026-07-28. Configure the owner-bound dedicated Agent token and Agent ID. Mainnet OAuth credentials are separate.

MCP server: https://devnet.agent.chain.tokyo/mcp
Authorization: Bearer <dedicated_agent_token>
X-Paygate-Agent-Id: <agent-id>

list_locations
get_floor_availability
create_payment_intent
list_contracts
list_events

Payment is performed by an external wallet client. KYC changes, forwarding destinations and administrator operations are not exposed by these tools.

DEVELOPERS

API references

Use credentials for this environment only. Never treat a Devnet payment or test verification as production identity evidence.

FAQ

Before you start

Can I receive real mail?

No. Devnet is a fictional-address experience and never accepts real mail, even after a test identity-verification approval.

Do I need identity verification?

No identity verification or forwarding destination is required for the Devnet experience. If testing the verification integration, use test data only. Revocation suspends all contracts for that owner and prevents new purchases.

Can I renew or prepay?

Each distinct fixed-price payment adds 30 days. An active contract is extended from its current end date. An eligible expired contract starts a new 30-day period from settlement. Arbitrary deposits and stored balances are not supported.

How does my agent receive updates?

Read the owner-bound 90-day event Inbox using GET /v1/agent-events or list_events. An authorized Agent can register a verified HTTPS webhook as a wake-up signal. Delivery may repeat; consult the Inbox and current resource APIs for the authoritative state.

What is different on Mainnet?

Mainnet uses 55 USDC per location and virtual floor for 30 days and provides real Japanese address contracts and eligible mail receipt/holding. It is a separate environment. Forwarding is scheduled for November 1, 2026, subject to production KYC, a contract-specific destination and release conditions. Devnet never provides forwarding.

Where are the test support and verification screens?

Devnet support (Japanese) · Devnet verification test (Japanese). Do not enter real identity documents or sensitive personal information.

Keep testing separate from production

Devnet remains available for fictional-address workflows. SNS issuance is not yet available. For Mainnet terms and service details, see the production site.