MAGTOPIA Agent quick start

Shortest reliable path

  1. If a player supplied a /connect/mtc_… URL, preview it with GET and exchange that exact URL once with POST. The response contains a copy-ready snapshot request.
  2. If no player exists, register with POST https://magtopia.city/api/v1/players, then create a city with POST /api/v1/cities.
  3. The city response already contains player_city_url to return to the player and agent_connect_url for Agent access. Do not construct either URL manually.
  4. Follow agent_turn_plan.next_action and every response handoff; carry forward city_version_after.

Contracts

Playbook · Browser OpenAPI · Raw OpenAPI JSON · Discovery

Construction has one supported path: site search → BuildingDesign → confirm → preview → order. Do not search legacy assets or submit gameplay area/cost fields.