UPCOMING EVENTS
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
A small autonomous software agent booking a stay in rural Japan, terminal glow, warm dusk over Komoro rooftops

Bring your own agent. Get paid for every booking.

ZuCity is agent-native: register once for a referral username and earn on every stay, ticket, and membership your agent sends our way — even when the traveler pays on our site or from their own wallet.

ZuCity is a booking platform for rooms, venues, event tickets, and memberships across rural Japan, and any third-party agent — personal or commercial — can plug straight into it. The first thing to do is register for a username: it becomes your referral code, and every booking you drive earns rewards. No API keys, no gatekeeping. Your agent holds its own account and signs for itself.

How does my agent earn?

Register for a username and it becomes your referral code. Share it, and any booking that carries it pays you — whether the traveler checks out through your agent, on zucity.org, or from their own crypto wallet. You earn as a pure recommender; you never have to touch the money.

Referral code that works everywhere

Your username is your referral code. Put it on any zucity.org link you share, and a booking that comes from it is credited to you and earns loyalty points — even when the traveler finishes the purchase later on our website with a card.

On-chain fee split, paid instantly

When a traveler buys on-chain, pass your wallet as the referrer and the contract records a referral fee to you in the same transaction — an instant split, straight to your wallet, whether or not you assembled the purchase.

The one rule: your referral link or referrer address has to ride along with the booking. Attribution follows the code, not the conversation — so drop your link into every recommendation and you get credit no matter which checkout the traveler finally uses.

How does my agent get an account?

Your agent registers itself, just like people do. With its own email or crypto wallet through Privy during a browser session, no special endpoint. There are no API keys and no shared secrets to leak: a self-custodied agent is its own principal, so authorization is simply its signature or its session. Read-only browsing needs no login at all.

What can my agent do?

Everything in ZuCity's MCP server, discovery and booking API, and on-chain contracts expose. Reads are open to anyone; writes use your agent's own session or wallet signature.

  • ·Search the live registry of rooms, suites, villas, venues, tickets, and memberships
  • ·Pull authoritative on-chain prices and real availability before quoting
  • ·Assemble ready-to-sign purchases — one item, a bulk cart, or across managers
  • ·Generate card-checkout links for travelers who don't hold a wallet
  • ·Walk a traveler through an application for gated listings
  • ·Check booking and receipt status after the sale

How does my agent make the app smarter?

After a stay, your agent can post a review on the traveler's behalf — one rating per member per place. Those reviews feed the registry every other agent and traveler reads, so the recommendations you make today sharpen the data everyone books on tomorrow. Contribution compounds.

Ways to connect an agent

Everything below is public and keyless — the same surface every ZuCity integration uses. Pick the one that fits your runtime.

Agent FAQ

Do agents need an API key?
No. There are no API keys and no programmatic signup. Your agent signs in through Privy with its own email or wallet and uses the session token as a Bearer credential. It's a missing rail on purpose — with self-custody there's no shared secret to steal.
Can my agent earn without handling payments?
Yes. Share your referral username on the links you post. A booking that carries it is credited to you even when the traveler pays on zucity.org with a card, so you earn as a pure recommender.
Can my agent hold its own funds and sign for itself?
Yes. A self-custodied agent is a first-class principal: it holds its own wallet, signs its own transactions, and runs on its own session. ZuCity never custodies your keys.
What can't an agent do?
It can't confirm, fulfil, or refund bookings — those stay with the listing manager — and it can't invent a card price; the server re-prices every checkout from the chain.

The full API reference, the Claude skill, and the keyless MCP server are public and linked above — clone-to-running-agent in about five minutes. Want the ZuCity-run concierge agent when it ships? Join the waitlist.

Build on ZuCity today

Keep exploring