Property Setup

Take a property from "not in GSC Wizard" (or half configured) to ready for the analysis skills, and hand back a checklist of what was done and what still needs the user. The user's request may contain the property (a GSC site URL or a recognizable site name), a client name to use as a tag, brand terms, sitemap URLs, folder paths to create as separate properties, filter presets to save, or a request to remove a property; honor what is given and ask for the rest only when a step needs it.

Workflow

1. Check the account first. Call get_account_info (no arguments) and read:

   • googleAccounts (email, scopes, isPrimary): an empty list with emptyBecause means no Google account is connected, so send the user to tool.gscwizard.com/account unless they only use properties shared with them.
   • subscription (plan, status, currentPeriodEnd, cancelAtPeriodEnd) and access.level: paid means the property tools will run. A payment_required refusal on this first call means there is no running trial or active paid plan (the free tier serves only the GSC Wizard mobile app, so from an MCP client every tool refuses): tell the user to start or renew a plan at tool.gscwizard.com/settings/subscription, mark every step as blocked, and stop. unknown, or a warning saying a read failed, means retry before acting on those fields.
   • apiKey.scope: read means every write below needs write access, so report those steps as "needs write access" instead of attempting them.

2. Inventory what is registered. Call list_sites (no arguments) and show a compact table of siteUrl, tags, permissionLevel, readable, activated, gscScope and, on shared rows, sharedBy and accessLevel. Read the flags like this:

   Flag	Meaning	What to do
   readable: false	Listed in Search Console but not verified (permissionLevel is siteUnverifiedUser); Google refuses every data request	The user verifies it at search.google.com/search-console; no tool here can fix it
   activated: false	Registered but hidden from the dashboard and not synced; every other property-scoped tool refuses it	Show it in step 5
   gscScope: "readonly"	The Google connection behind it has read-only Search Console access; Google refuses submit_sitemap and create_gsc_property	The user reconnects that Google account with full access in the app
   sharedBy present	Someone else's property; accessLevel READ_ONLY refuses every write in this skill, FULL allows update_site and presets	Only the owner can delete it or create properties under it