{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text query, e.g. \"data centers in Northern Virginia\" or \"Ashburn hyperscale power\""
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A facility id/slug from a prior `search` result, e.g. equinix-dc1-ashburn"
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "intent": {
      "type": "string",
      "description": "The user's infrastructure question, passed through UNCHANGED. Examples: \"rank markets for a 200 MW AI campus\" · \"evaluate 100 MW power headroom for a GPU training cluster in PJM\" · \"compare Dallas vs Phoenix for a hyperscale campus\" · \"find 100 MW of buildable capacity near Ashburn\" · \"where do fiber density and grid headroom overlap in Atlanta\""
    },
    "context": {
      "description": "Optional structured hints AND step-arg overrides: {lat, lon, iso, market, capacity_mw, candidate_id, state, since} — user-supplied values beat minted ones. The typed top-level params below are merged into this and WIN on conflict."
    },
    "market": {
      "description": "Metro slug or name to pin the analysis to, e.g. \"ashburn\". Beats any market the planner would mint.",
      "type": "string"
    },
    "capacity_mw": {
      "description": "Target capacity in MW, e.g. 100.",
      "type": "number"
    },
    "iso": {
      "description": "ISO/RTO code to pin geography, e.g. \"PJM\", \"ERCOT\".",
      "type": "string"
    },
    "state": {
      "description": "US state code, e.g. \"VA\".",
      "type": "string"
    },
    "lat": {
      "description": "Latitude for a specific site.",
      "type": "number"
    },
    "lon": {
      "description": "Longitude for a specific site.",
      "type": "number"
    },
    "max_steps": {
      "description": "Max plan steps to execute, 1-8 (default 6)"
    },
    "max_fanout": {
      "description": "Max per-finalist fan-out calls for one step, 1-3 (default 2)"
    },
    "cohort": {
      "description": "Optional experiment tag for adoption/retention measurement, e.g. \"cohort.front_door\". Has NO effect on routing, planning, geography or results — it is recorded only. Put your user's question in `intent` and the tag HERE; never inside the intent string, which would break classification. Max 64 chars, [a-z0-9._-]; a malformed tag is ignored, never an error."
    }
  },
  "required": [
    "intent"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search over facility name/operator/location (mapped to the backend `q` param), e.g. \"hyperscale Ashburn\"",
      "type": "string"
    },
    "country": {
      "description": "ISO 3166-1 alpha-2 country code, e.g. US, GB, SG",
      "type": "string"
    },
    "state": {
      "description": "US state abbreviation or region, e.g. VA, TX",
      "type": "string"
    },
    "city": {
      "description": "City name to filter facilities, e.g. Ashburn, Dallas",
      "type": "string"
    },
    "operator": {
      "description": "Operator/provider company name, e.g. Equinix, Digital Realty",
      "type": "string"
    },
    "min_capacity_mw": {
      "description": "Minimum power capacity filter in megawatts (MW)",
      "type": "number"
    },
    "max_capacity_mw": {
      "description": "Maximum power capacity filter in megawatts (MW)",
      "type": "number"
    },
    "tier": {
      "description": "Uptime Institute tier filter (1-4)",
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Pagination offset, 0-based (skip this many results)",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "facility_id": {
      "description": "Facility id from a prior search_facilities/search result (numeric or string), e.g. equinix-dc1-ashburn",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "slug": {
      "description": "Facility slug from a prior search result, e.g. digital-realty-iad8",
      "type": "string"
    },
    "id": {
      "description": "Alias for facility_id — a facility id/slug from a prior search result",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "name": {
      "description": "Facility name as a fallback lookup when no id/slug is known, e.g. \"QTS Ashburn\"",
      "type": "string"
    },
    "include_nearby": {
      "description": "Include peer facilities near this one in the response (default true)",
      "type": "boolean"
    },
    "include_power": {
      "description": "Include power capacity detail (total/used MW) in the response (default true)",
      "type": "boolean"
    }
  },
  "anyOf": [
    {
      "properties": {
        "facility_id": {}
      },
      "required": [
        "facility_id"
      ]
    },
    {
      "properties": {
        "id": {}
      },
      "required": [
        "id"
      ]
    },
    {
      "properties": {
        "slug": {}
      },
      "required": [
        "slug"
      ]
    },
    {
      "properties": {
        "name": {}
      },
      "required": [
        "name"
      ]
    }
  ]
}

{
  "type": "object",
  "properties": {
    "market": {
      "description": "Market slug (metro), e.g. northern-virginia, dallas, frankfurt, singapore — valid slugs come from rank_markets / get_market_dcpi_rank",
      "type": "string"
    },
    "metric": {
      "description": "Optional single metric to focus on, e.g. vacancy, pricing, absorption, pipeline",
      "type": "string"
    },
    "period": {
      "description": "Optional time window for the metric, e.g. ttm, 12mo, ytd",
      "type": "string"
    },
    "compare_to": {
      "description": "Optional second market slug to compare against, e.g. dallas",
      "type": "string"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "market_slug": {
      "type": "string",
      "description": "Market slug (metro), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank"
    }
  },
  "required": [
    "market_slug"
  ]
}

{
  "type": "object",
  "properties": {
    "market_slug": {
      "type": "string",
      "description": "Market slug (metro), e.g. dallas, phoenix, northern-virginia — valid slugs come from rank_markets / get_market_dcpi_rank"
    },
    "horizon_quarters": {
      "description": "Forecast horizon in quarters (1-8, default 4); 2 = ~6 months ahead",
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    }
  },
  "required": [
    "market_slug"
  ]
}

{
  "type": "object",
  "properties": {
    "state": {
      "description": "US state abbreviation, e.g. TX, VA, AZ. Returns the DCGI score and verdict, plus `gas_price_series` naming which EIA series priced the state. A state that cannot be priced comes back verdict UNSCORED with dcgi null and an `unscored_reason` — absence, not a low score. Withdrawn 2026-08-08, restored 2026-08-30: do NOT compare against a figure published before 2026-08-08. Use get_gas_intelligence for the per-state pipeline and operator brief",
      "type": "string"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "Market slug (metro), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank"
    },
    "heat_rate_btu_per_kwh": {
      "description": "Optional custom generator heat rate in Btu/kWh for the gas-to-grid $/MWh scenario, e.g. 6800 (avg CCGT)",
      "type": "number"
    }
  },
  "required": [
    "market"
  ]
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "isos": {
      "type": "string",
      "description": "Comma-separated list of 2-4 US ISO/RTO grid regions to compare, e.g. \"PJM,ERCOT,CAISO\" (valid: ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE)"
    }
  },
  "required": [
    "isos"
  ]
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "buyer": {
      "description": "Filter by acquiring company name, e.g. Blackstone, KKR, Digital Realty",
      "type": "string"
    },
    "seller": {
      "description": "Filter by selling/target company name, e.g. CyrusOne",
      "type": "string"
    },
    "min_value_usd": {
      "description": "Minimum disclosed deal value in US dollars, e.g. 1000000000 for $1B+",
      "type": "number"
    },
    "max_value_usd": {
      "description": "Maximum disclosed deal value in US dollars",
      "type": "number"
    },
    "deal_type": {
      "description": "Deal type filter, e.g. acquisition, jv, refinance, recap",
      "type": "string"
    },
    "date_from": {
      "description": "Earliest deal date, ISO-8601 (YYYY-MM-DD)",
      "type": "string"
    },
    "date_to": {
      "description": "Latest deal date, ISO-8601 (YYYY-MM-DD)",
      "type": "string"
    },
    "region": {
      "description": "Geographic region filter, e.g. us, eu, apac, americas",
      "type": "string"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Pagination offset, 0-based (skip this many results)",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    }
  }
}

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text keyword to filter news, e.g. \"Stargate\" or \"interconnection queue\"",
      "type": "string"
    },
    "category": {
      "description": "News topic filter, e.g. deals, permits, outages, policy, AI",
      "type": "string"
    },
    "source": {
      "description": "Restrict to one trade source, e.g. DCD, \"Data Center Frontier\", \"Capacity Media\"",
      "type": "string"
    },
    "date_from": {
      "description": "Earliest published date, ISO-8601 (YYYY-MM-DD)",
      "type": "string"
    },
    "date_to": {
      "description": "Latest published date, ISO-8601 (YYYY-MM-DD)",
      "type": "string"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "min_relevance": {
      "description": "Minimum relevance score 0-1 to include an item, e.g. 0.5",
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Natural-language query (required), e.g. \"grids opening up for AI load in the Southeast\"",
      "type": "string"
    },
    "query": {
      "description": "Alias for q — the same natural-language query; send exactly one of q/query",
      "type": "string"
    },
    "corpus": {
      "description": "Optional CSV of corpora: news_articles, deals, discovered_facilities, market_narratives (default: all)",
      "type": "string"
    },
    "k": {
      "description": "Number of results, 1-15 (default 8)",
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Natural-language query (required), e.g. \"grids opening up for AI load in the Southeast\"",
      "type": "string"
    },
    "q": {
      "description": "Alias for query",
      "type": "string"
    },
    "corpus": {
      "description": "Optional corpus to restrict to: news | deals | facilities | market_narratives. CSV of several is allowed; default searches all.",
      "type": "string"
    },
    "limit": {
      "description": "Max results to return, 1-15 (default 8)",
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "Market slug (required), e.g. northern-virginia, dallas, phoenix — valid slugs come from rank_markets / get_market_dcpi_rank"
    },
    "max_tokens": {
      "description": "Token budget for the pack, 200-8000 (default 4000); sections are filled in priority order until the budget is spent",
      "type": "number"
    }
  },
  "required": [
    "market"
  ]
}

{
  "type": "object",
  "properties": {
    "iso": {
      "type": "string",
      "description": "ISO/RTO grid region (required): ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE"
    },
    "max_tokens": {
      "description": "Token budget for the pack, 200-8000 (default 4000); sections are filled in priority order until the budget is spent",
      "type": "number"
    }
  },
  "required": [
    "iso"
  ]
}

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Pipeline stage filter: announced, permitted, construction, or operational",
      "type": "string"
    },
    "country": {
      "description": "ISO 3166-1 alpha-2 country code, e.g. US, DE, SG",
      "type": "string"
    },
    "operator": {
      "description": "Operator/provider company name, e.g. Equinix, Digital Realty, AWS",
      "type": "string"
    },
    "min_capacity_mw": {
      "description": "Minimum project power capacity filter in megawatts (MW), e.g. 50 for hyperscale",
      "type": "number"
    },
    "expected_completion_before": {
      "description": "Only projects with expected commissioning before this ISO-8601 date (YYYY-MM-DD), e.g. 2027-01-01",
      "type": "string"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Pagination offset, 0-based (skip this many results)",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    }
  }
}

{
  "type": "object",
  "properties": {
    "state": {
      "description": "US state abbreviation to filter generators, e.g. VA, TX",
      "type": "string"
    },
    "ba": {
      "description": "Balancing-authority / ISO code, e.g. PJM, ERCO, SOCO, TVA, AZPS",
      "type": "string"
    },
    "status": {
      "description": "Generator status code: P/L/T (planned), U/V (under construction), TS (testing)",
      "type": "string"
    },
    "min_mw": {
      "description": "Minimum nameplate capacity filter in megawatts (MW)",
      "type": "number"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "type": {
      "description": "Which project list: gas_pipeline (EIA, US-wide), transmission (ERCOT TPIT, Texas only) or all (default)",
      "type": "string",
      "enum": [
        "gas_pipeline",
        "transmission",
        "all"
      ]
    },
    "state": {
      "description": "US state abbreviation, e.g. TX or LA. Gas projects match any state they cross; transmission projects are all TX",
      "type": "string"
    },
    "status": {
      "description": "Status, case-insensitive; comma list allowed. Gas: Announced, Pre-applied, Applied, Approved, Construction, On Hold, Completed. Transmission: Planned, Conceptual, Under Construction, Completed, Cancelled",
      "type": "string"
    },
    "min_capacity": {
      "description": "Gas only: minimum pipeline capacity in million cubic feet per day (MMcf/d), e.g. 1000. With type=all it narrows to gas projects",
      "type": "number"
    },
    "min_kv": {
      "description": "Transmission only: minimum voltage in kilovolts (kV), e.g. 345. With type=all it narrows to transmission projects",
      "type": "number"
    },
    "in_service_after": {
      "description": "Only projects entering service on or after this date (YYYY-MM-DD or YYYY). Gas compares the in-service year; transmission the actual, else projected, in-service date",
      "type": "string"
    },
    "in_service_before": {
      "description": "Only projects entering service on or before this date (YYYY-MM-DD or YYYY)",
      "type": "string"
    },
    "new_since": {
      "description": "Only projects DC Hub first saw on or after this date (YYYY-MM-DD). The initial backfill is never counted as new",
      "type": "string"
    },
    "include_delisted": {
      "description": "Also return projects the latest source release no longer lists (completed, withdrawn or dropped). Default false",
      "type": "boolean"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "2-letter US state code (required), e.g. OH, GA, TX — the timeline grain; a state can span ISOs and the response reports ISO membership as context"
    },
    "years": {
      "description": "Window in years from now, 1-6 (default 5)",
      "type": "number"
    },
    "mw": {
      "description": "Optional target MW for CONTEXT ONLY — echoed back with an explicit note; never converted into an energize-by date, which this data cannot honestly state",
      "type": "number"
    }
  },
  "required": [
    "state"
  ]
}

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country/area name to filter, e.g. Germany, India, Brazil, Japan",
      "type": "string"
    },
    "fuel": {
      "description": "Fuel/type filter, comma-separated for a union: coal, oil/gas, nuclear, solar, wind, hydro, bioenergy, geothermal",
      "type": "string"
    },
    "status": {
      "description": "Status substring filter, e.g. operating, construction, pre-construction, announced",
      "type": "string"
    },
    "pipeline": {
      "description": "true = ONLY the forward pipeline (announced + pre-construction + under-construction)",
      "type": "boolean"
    },
    "bbox": {
      "description": "Viewport filter as minLng,minLat,maxLng,maxLat",
      "type": "string"
    },
    "min_mw": {
      "description": "Minimum unit capacity in MW",
      "type": "number"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "iso": {
      "description": "ISO/RTO grid region to drill into: ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE; omit for the all-ISO snapshot",
      "type": "string"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "min_mw": {
      "description": "Minimum project capacity in MW, e.g. 1000 for 1 GW+",
      "type": "number"
    },
    "max_ttp_months": {
      "description": "Max time-to-power in months (ISO-level avg interconnection wait; HARD cut keeping projects in ISOs at/under this — PJM ~51, CAISO ~40, ISO-NE ~34, MISO ~34, ERCOT ~33, NYISO ~31, SPP ~24; <=30 leaves only SPP)",
      "type": "integer",
      "minimum": 1,
      "maximum": 120
    },
    "iso": {
      "description": "Restrict to one or more ISOs, comma-separated for a union: PJM, ERCOT, MISO, CAISO, SPP, NYISO, ISONE (ISO-NE). e.g. iso=ERCOT,PJM. Omit for all; combines with max_ttp_months as an intersection",
      "type": "string"
    },
    "baseload_only": {
      "description": "Keep only firm/dispatchable fuel (nuclear, gas, steam, geothermal, hydro, coal); exclude wind/solar/storage. Firm-vs-intermittent split only — does NOT sub-divide peaker vs combined-cycle gas (no duty-cycle field in the queue). Default false",
      "type": "boolean"
    },
    "fuel_type": {
      "description": "Isolate a fuel by inclusive substring match on the raw label; comma/semicolon-separated for a union, e.g. 'gas' hits GAS/Natural Gas, 'nuclear,hydro' unions both. Runs the fuel filter server-side instead of post-filtering survivors in context",
      "type": "string"
    },
    "status": {
      "description": "Queue status filter. Default 'active' = still progressing (excludes withdrawn/cancelled/suspended/in-commercial-operation) — cross-ISO safe (SPP labels live projects 'IA FULLY EXECUTED/ON SCHEDULE' not 'active'). Pass 'all' for every status, or a literal label to substring-match",
      "type": "string"
    },
    "max_fiber_km": {
      "description": "Keep only survivors within N km of the nearest MAPPED long-haul fiber route endpoint — coarse backbone proximity from a sparse ~260-node dataset over a county-centroid origin, NOT last-mile fiber. Implies geocoded rows only",
      "type": "number"
    },
    "geocoded_only": {
      "description": "Keep only survivors that carry lat/lng (~83% of the queue) — the ones with a ready site_evaluation_handoff you can pipe into analyze_site. Default false",
      "type": "boolean"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "target_mw": {
      "type": "number",
      "description": "Minimum required headroom in megawatts (MW) — filters to retiring generators at/above this size. Also passed through as the handoff's analyze_site capacity_mw (the DC you are siting)."
    },
    "horizon_months": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Time horizon in months to look ahead for planned retirements, 1-120 (e.g., 12, 18, 36)."
    },
    "region_iso": {
      "description": "Optional target region or ISO (e.g., 'MISO', 'PJM', 'ERCOT', 'SPP', 'CAISO', 'NYISO', 'ISONE'). Matches the generator's own EIA balancing-authority code — real market boundaries, not state lines. Comma-separated for a union.",
      "type": "string"
    },
    "fuel_filter": {
      "description": "Optional filter for retiring fuel categories, substring-matched (e.g., 'Coal', 'Natural Gas', 'Petroleum').",
      "type": "string"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "target_mw",
    "horizon_months"
  ]
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Latitude of the point to search around, decimal degrees. Must be paired with lon.",
      "type": "number"
    },
    "lon": {
      "description": "Longitude of the point to search around, decimal degrees. Must be paired with lat.",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "radius_km": {
      "description": "Search radius in km around lat/lon (default 25, max 150). Ignored when utility/market is passed — that mode covers the utility's entire published extent.",
      "type": "number",
      "minimum": 1,
      "maximum": 150
    },
    "utility": {
      "description": "Utility or market name, case-insensitive substring — e.g. \"Ameren Illinois\", \"Con Edison\", \"Providence\". Searches that utility's whole published territory instead of a point radius. Call with NO arguments to list every covered utility.",
      "type": "string"
    },
    "market": {
      "description": "Alias for utility — either name works (e.g. \"Northern Virginia · Richmond\", \"New York City · Westchester\").",
      "type": "string"
    },
    "capacity_type": {
      "description": "Restrict to one published type: \"load\" (what a new data-center load can DRAW — the type that answers siting), \"gen\" (DER/generation EXPORT headroom — NOT available load), or \"bus_headroom\" (transmission bus MW). Omit to get all three reported separately.",
      "type": "string"
    },
    "min_mw": {
      "description": "Only return feeders whose published capacity is at or above this many MW.",
      "type": "number"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "geometry": {
      "description": "GeoJSON Polygon or MultiPolygon parcel boundary, e.g. {\"type\":\"Polygon\",\"coordinates\":[[[lng,lat],[lng,lat],...]]} — a MultiPolygon carries discontinuous parcels as one envelope. Omit to look up the hosted parcel containing lat/lon instead"
    },
    "lat": {
      "description": "Latitude of a point ON the parcel — used with lon when geometry is omitted to look up the containing parcel from the hosted county/state GIS layer",
      "type": "number"
    },
    "lon": {
      "description": "Longitude of a point ON the parcel (used with lat when geometry is omitted)",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "capacity_mw": {
      "description": "Optional target load in MW to pass through into the site_evaluation_handoff",
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "candidates": {
      "description": "Array of candidate objects. PREFERRED: {candidate_id: \"cand_…\", <your metric fields>} using ids from get_refined_queue — frozen coordinates/capacity/fiber_km load from the mint (zero transcription drift), your enrichments (e.g. overall_score from analyze_site) overlay. Legacy: {id?, lat?, lng?, <metric fields>} flat objects also work. Omit if using shortlist_name"
    },
    "shortlist_name": {
      "description": "Alternative to candidates: re-rank a SAVED shortlist (created via save_to_shortlist) in one shot — loads its sites (scoped to your API key) + reuses their saved objectives if you pass none, and re-scores against the current baseline",
      "type": "string"
    },
    "constraints": {
      "description": "Hard filters {field: {min?, max?}} — a candidate missing a constrained field is dropped (fail-closed). e.g. {\"risk_resilience\": {\"min\": 70}, \"estimated_ttp_months\": {\"max\": 34}}"
    },
    "objectives": {
      "description": "Weighted objectives {field: signedWeight} — +weight maximizes, -weight minimizes. e.g. {\"water_stress\": -0.6, \"fiber_km\": -0.4}. Omit with shortlist_name to reuse the shortlist's saved objectives; required with candidates"
    },
    "absolute": {
      "description": "false (default) = min-max normalize within THIS batch (best-in-set, NOT stable across runs). true = score on a FIXED 0-100 scale for CROSS-RUN-STABLE, auditable scores — use ONLY when the objective fields are already 0-100 (analyze_site scores like risk_resilience/fiber_connectivity), not raw distances like fiber_km",
      "type": "boolean"
    },
    "percentile": {
      "description": "true = score each objective as its PERCENTILE against the viable-site POPULATION (\"better than X% of viable sites\") — the strongest cross-run + cross-region comparability. Works for fields with a maintained baseline (analyze_site metrics: overall_score, risk_resilience, fiber_connectivity, power_infrastructure, market_conditions, gas_pipeline_access, fiber_km, power_cost); other fields fall back to absolute (listed in unbaselined_fields). Takes precedence over absolute",
      "type": "boolean"
    },
    "require_complete": {
      "description": "true = DROP any candidate missing one or more of your (validated) objectives — dropped candidates are DECLARED in excluded_incomplete, never silent. Default false keeps incomplete candidates ranked on their carried objectives with missing_objectives flagged. Recommended true for autonomous take-rank-1 workflows (an incomplete candidate can otherwise top the ranking on its single best metric).",
      "type": "boolean"
    },
    "top_k": {
      "description": "How many top-ranked sites to return (1-50, default 3)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  }
}

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Optional keyword to filter families/tools, e.g. \"site selection\", \"grid queue\", \"fiber\", \"deals\", \"market\"",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "intent": {
      "type": "string",
      "description": "Natural-language description of what you are trying to find out, e.g. \"rank markets for a 200MW AI campus\" or \"how much power is available in ERCOT\""
    },
    "context": {
      "description": "Optional structured hints: {lat, lon, iso, market, capacity_mw, candidate_id, state (2-letter), since} — sharpens args_hint values and routing (e.g. lat/lon boosts the site-analysis route)"
    }
  },
  "required": [
    "intent"
  ]
}

{
  "type": "object",
  "properties": {
    "shortlist_name": {
      "type": "string",
      "description": "Name of the shortlist, e.g. \"Q3-2026-1GW-targets\" — created if new. REQUIRED."
    },
    "site": {
      "description": "Site object. MINIMAL form is enough: {site_ref, lat, lng, capacity_mw}. Richer is better — add any analyze_site metric fields (risk_resilience, fiber_connectivity, water score…) and those become what gets re-scored later."
    },
    "objectives": {
      "description": "OPTIONAL {field: signedWeight} map (+maximize/-minimize) if this site was ranked under explicit objectives — stored so re-scoring reuses the same criteria. Omit it and DC Hub weights the site's own metric fields equally."
    },
    "notes": {
      "description": "Optional free-text note, e.g. \"strong fiber, acceptable water\"",
      "type": "string"
    }
  },
  "required": [
    "shortlist_name",
    "site"
  ]
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The shortlist name to fetch"
    },
    "refresh": {
      "description": "true (default) = re-score every site against the CURRENT baseline + return drift deltas; false = return the saved snapshots only",
      "type": "boolean"
    }
  },
  "required": [
    "name"
  ]
}

{
  "type": "object",
  "properties": {
    "shortlist_name": {
      "description": "The shortlist to monitor (created via save_to_shortlist)",
      "type": "string"
    },
    "percentile_below": {
      "description": "Fire if any site's current percentile objective_score drops below this (e.g. 70)",
      "type": "number"
    },
    "delta_below": {
      "description": "Fire if any site's score_delta_since_saved drops below this — pass a NEGATIVE number, e.g. -8 (dropped 8+ points since saved)",
      "type": "number"
    },
    "notify": {
      "description": "Delivery: {\"webhook\":\"https://...\"} and/or {\"email\":\"you@co.com\"} — at least one required"
    }
  },
  "required": [
    "notify"
  ]
}

{
  "type": "object",
  "properties": {
    "shortlist_name": {
      "type": "string",
      "description": "The shortlist to re-allocate within (created via save_to_shortlist)"
    },
    "drifted_site_ref": {
      "description": "Optional site_ref of the drifted slot to replace; if omitted, the current lowest-scoring site is treated as the drifted one",
      "type": "string"
    }
  },
  "required": [
    "shortlist_name"
  ]
}

{
  "type": "object",
  "properties": {
    "iso": {
      "description": "ISO/RTO grid region (required): ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE",
      "type": "string"
    },
    "metric": {
      "description": "Optional metric focus, e.g. fuel_mix, demand, demand_curve",
      "type": "string"
    },
    "period": {
      "description": "Optional time window for the metric, e.g. 24h",
      "type": "string"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Return changes since this ISO-8601 timestamp (YYYY-MM-DD or full datetime) or shorthand \"24h\"/\"7d\"; default 24h",
      "type": "string"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "facility_id": {
      "description": "A DC Hub facility id or canonical slug to resolve the market context",
      "type": "string"
    },
    "market": {
      "description": "Alternatively, a market name or slug (e.g. \"northern-virginia\")",
      "type": "string"
    },
    "since": {
      "description": "Look-back window, e.g. \"7d\" or \"30d\" (default 7d)",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Site latitude in decimal degrees (-90 to 90), e.g. 39.04",
      "type": "number"
    },
    "lon": {
      "description": "Site longitude in decimal degrees (-180 to 180), e.g. -77.48",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "name": {
      "description": "Optional label for the saved site, e.g. \"Ashburn parcel\"",
      "type": "string"
    },
    "state": {
      "description": "US state abbreviation for the site, e.g. VA",
      "type": "string"
    },
    "market": {
      "description": "Market slug (metro) the site belongs to, e.g. northern-virginia",
      "type": "string"
    },
    "target_mw": {
      "description": "Target power load for the planned build in megawatts (MW), e.g. 100",
      "type": "number"
    },
    "notes": {
      "description": "Optional free-text notes to store with the saved site",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Delta window for per-site movement: \"24h\", \"7d\" (default) or an ISO-8601 timestamp — pass your cached generated_at from last session",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "Market slug (metro) to watch, e.g. northern-virginia — valid slugs come from rank_markets / get_market_dcpi_rank"
    },
    "channel": {
      "type": "string",
      "description": "Delivery channel: \"email\" (free, sent to your bound email) or \"webhook\" (Pro)"
    },
    "destination": {
      "description": "For channel=\"webhook\", the https URL to POST alerts to (Pro); ignored for email (forced to bound address)",
      "type": "string"
    }
  },
  "required": [
    "market",
    "channel"
  ]
}

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Your human's email address (required) — a one-click confirm link is sent; use only an address they explicitly gave"
    },
    "source": {
      "description": "Optional attribution tag for where the subscription came from, e.g. mcp_digest",
      "type": "string"
    }
  },
  "required": [
    "email"
  ]
}

{
  "type": "object",
  "properties": {
    "saved_site_id": {
      "description": "The saved_site_id returned by save_site or list_saved_sites (required)",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "trigger_type": {
      "description": "What movement fires the alert: \"dcpi_change\" (default), \"capacity_change\", or \"new_facility_nearby\"",
      "type": "string"
    },
    "threshold": {
      "description": "The points/MW move that fires the alert (default 5)",
      "type": "number"
    },
    "notify_email": {
      "type": "string",
      "description": "Email address the alert is sent to (required); on free tier forced to your human's bound email"
    }
  },
  "required": [
    "saved_site_id",
    "notify_email"
  ]
}

{
  "type": "object",
  "properties": {
    "format": {
      "description": "Output file format: \"csv\" (default) or \"geojson\" (for GIS tools like QGIS)",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "state": {
      "description": "2-letter US state to search, e.g. OH — required unless you pass lat + lon",
      "type": "string"
    },
    "lat": {
      "description": "Latitude of a search centre, e.g. 39.04 — use with lon (+ radius_km) instead of state",
      "type": "number"
    },
    "lon": {
      "description": "Longitude of a search centre, e.g. -77.48",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "radius_km": {
      "description": "Search radius in km around lat/lon (default 80, clamped 5-400); ignored in state mode",
      "type": "number"
    },
    "min_voltage_kv": {
      "description": "Only anchor on substations at or above this voltage in kV (default 115). 230+ for hyperscale, 500 for the largest campuses",
      "type": "number"
    },
    "max_gas_km": {
      "description": "Drop candidates farther than this from the nearest gas pipeline. Applied ONLY if the gas layer answers — check constraint_coverage",
      "type": "number"
    },
    "max_fiber_km": {
      "description": "Drop candidates farther than this from the nearest fiber route (CHORD approximation — see fiber_distance_basis). Applied ONLY if the fiber layer answers",
      "type": "number"
    },
    "exclude_moratorium": {
      "description": "true = drop candidates in a state with a published data-center moratorium. STATE grain, not jurisdiction grain",
      "type": "boolean"
    },
    "cluster_km": {
      "description": "Collapse anchors within this many km into one candidate area (default 8, max 100). Raise it for broader coverage, lower it for denser results",
      "type": "number"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "candidate_id": {
      "description": "PREFERRED for queue survivors: a cand_… id from get_refined_queue — coordinates come from the FROZEN mint (lat/lon args are ignored; zero transcription drift; expired ids fail closed with candidate_expired). See dchub.cloud/docs/candidate-lifecycle",
      "type": "string"
    },
    "lat": {
      "description": "Site latitude in decimal degrees (-90 to 90; required unless candidate_id or location given), e.g. 33.45",
      "type": "number"
    },
    "lon": {
      "description": "Site longitude in decimal degrees (-180 to 180; required unless candidate_id or location given), e.g. -112.07",
      "type": "number"
    },
    "location": {
      "description": "Market NAME or metro slug instead of coordinates, e.g. \"ashburn\", \"northern-virginia\", \"dallas\". Resolved to that market's PUBLISHED CENTROID through the DCPI market row, and the answer carries a resolved_from block saying so. This is a MARKET-level read, not the parcel you named — pass lat/lon for a specific site. Not an alias for lat/lon: a place name is not a coordinate.",
      "type": "string"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "state": {
      "description": "US state abbreviation (optional) — improves the tax-incentive lookup, e.g. AZ",
      "type": "string"
    },
    "capacity_mw": {
      "description": "Target power load for the build in megawatts (MW), e.g. 100 (typical 50-500)",
      "type": "number"
    },
    "include_grid": {
      "description": "Include grid-headroom / substation analysis (default true)",
      "type": "boolean"
    },
    "include_risk": {
      "description": "Include water/drought/climate risk analysis (default true)",
      "type": "boolean"
    },
    "include_fiber": {
      "description": "Include fiber-connectivity analysis (default true)",
      "type": "boolean"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45",
      "type": "number"
    },
    "lon": {
      "description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "state": {
      "description": "US state abbreviation (optional) — improves water/context lookups, e.g. AZ",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45",
      "type": "number"
    },
    "lon": {
      "description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 33.45",
      "type": "number"
    },
    "lon": {
      "description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -112.07",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "radius_km": {
      "description": "Max distance (km) to snap to the nearest NOAA station (optional, default 25)",
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 37.694",
      "type": "number"
    },
    "lon": {
      "description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -88.65",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "capacity_mw": {
      "description": "Target power load for the build in megawatts (MW), e.g. 150 (typical 50-500)",
      "type": "number"
    },
    "prepared_for": {
      "description": "Client name printed on the report cover, e.g. \"TON Infrastructure\"",
      "type": "string"
    },
    "prepared_by": {
      "description": "Your firm name that brands the report; defaults to DC Hub, e.g. \"Martone Advisors\"",
      "type": "string"
    },
    "latency_target": {
      "description": "Optional metro to measure latency against; default = nearest real carrier hotel",
      "type": "string"
    },
    "use_case": {
      "description": "Optional workload descriptor to tailor the report, e.g. \"AI training campus\"",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "locations": {
      "description": "Semicolon-separated list of 2-4 \"lat,lon\" pairs to compare, e.g. \"33.45,-112.07;39.04,-77.48\"",
      "type": "string"
    },
    "sites": {
      "description": "Alternative to locations: an array of {lat, lon} (or {lat, lng}) objects, 2-4 sites"
    },
    "capacity_mw": {
      "description": "Target power load for the build in megawatts (MW), e.g. 50 (typical 50-500)",
      "type": "number"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Center latitude in decimal degrees (-90 to 90, required), e.g. 33.45",
      "type": "number"
    },
    "lon": {
      "description": "Center longitude in decimal degrees (-180 to 180, required), e.g. -112.07",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "radius_km": {
      "description": "Search radius in kilometers around the point, e.g. 25",
      "type": "number"
    },
    "layer": {
      "description": "Optional single asset layer to return, e.g. substations, transmission, pipelines, power_plants",
      "type": "string"
    },
    "min_voltage_kv": {
      "description": "Only include transmission/substations at or above this voltage in kV, e.g. 69",
      "type": "number"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "carrier": {
      "description": "Fiber carrier to filter on, e.g. Zayo, Lumen, Cogent, \"Crown Castle\", Windstream, GTT, Uniti; omit for all carriers",
      "type": "string"
    },
    "route_type": {
      "description": "Route class: \"metro\", \"longhaul\", \"dark\", or \"ix\"",
      "type": "string"
    },
    "market": {
      "description": "Metro name or slug (e.g. \"dallas\", \"ashburn\", \"northern-virginia\") — returns only routes touching that metro (either endpoint within ~1.2°). Great with route_type=longhaul.",
      "type": "string"
    },
    "include_sources": {
      "description": "Include upstream data-source/provenance metadata in the response",
      "type": "boolean"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Site latitude in decimal degrees (-90 to 90, required), e.g. 39.04",
      "type": "number"
    },
    "lon": {
      "description": "Site longitude in decimal degrees (-180 to 180, required), e.g. -77.48",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "radius_km": {
      "description": "Search radius in km for reachable fiber carriers (default 50, range 5-200)",
      "type": "number"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Latitude of the site, e.g. 36.85 — with lon, returns landing points near it; omit both for the cable catalogue",
      "type": "number"
    },
    "lon": {
      "description": "Longitude of the site, e.g. -75.98",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "radius_km": {
      "description": "Search radius in km around lat/lon for landing points (default 200)",
      "type": "number"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Latitude of the site, e.g. 39.04 — with lon, returns the peering profile around it; omit both for the IXP directory",
      "type": "number"
    },
    "lon": {
      "description": "Longitude of the site, e.g. -77.48",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "market": {
      "description": "Optional metro name or slug for a single-market deep dive (carrier-by-carrier + dark fiber), e.g. \"Dallas-Fort Worth\", \"dallas\", \"Northern Virginia\", \"ashburn\". Omit to list every tracked metro ranked by fiber density.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "data_type": {
      "description": "Optional price type focus, e.g. retail, wholesale, gas",
      "type": "string"
    },
    "state": {
      "description": "US state abbreviation for state-level pricing context, e.g. TX",
      "type": "string"
    },
    "iso": {
      "description": "ISO/RTO grid region (required for ISO pricing): ERCOT, PJM, MISO, CAISO, SPP, NYISO, ISONE",
      "type": "string"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "energy_type": {
      "description": "Renewable type: \"solar\", \"wind\", or \"combined\"; omit for all",
      "type": "string"
    },
    "state": {
      "description": "US state abbreviation, e.g. TX, VA, AZ",
      "type": "string"
    },
    "lat": {
      "description": "Optional latitude in decimal degrees (-90 to 90) to find nearest projects within 50mi",
      "type": "number"
    },
    "lon": {
      "description": "Optional longitude in decimal degrees (-180 to 180) to find nearest projects within 50mi",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "state": {
      "description": "US state abbreviation (required), e.g. VA, TX, AZ",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "lat": {
      "description": "Site latitude in decimal degrees (-90 to 90) for the most precise water-risk read, e.g. 33.45",
      "type": "number"
    },
    "lon": {
      "description": "Site longitude in decimal degrees (-180 to 180), e.g. -112.07",
      "type": "number"
    },
    "latitude": {
      "description": "Alias for lat — either name works",
      "type": "number"
    },
    "lng": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "longitude": {
      "description": "Alias for lon — either name works",
      "type": "number"
    },
    "state": {
      "description": "US state abbreviation as an alternative to lat/lon, e.g. AZ",
      "type": "string"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "region_id": {
      "description": "Grid region (required): one of the 7 US ISOs (PJM, ERCOT, CAISO, MISO, SPP, NYISO, ISO-NE), an EIA balancing-authority code (e.g. SOCO, DUK, AZPS, TVA), or the PJM Dominion zone region_id=\"PJM-DOM\" for live Ashburn / Northern Virginia zone load + real-time LMP (the world's #1 DC market, invisible in EIA)",
      "type": "string"
    },
    "iso": {
      "description": "Alias for region_id — the ISO/RTO or balancing-authority code",
      "type": "string"
    },
    "region": {
      "description": "Alias for region_id — the ISO/RTO or balancing-authority code",
      "type": "string"
    },
    "market": {
      "description": "Market NAME or metro slug instead of a grid code, e.g. \"Ashburn\", \"northern-virginia\", \"dallas\". Resolved to its ISO through the published DCPI market row before the brief is built; the answer carries a resolved_from block naming what it resolved to. Not an alias for region_id — \"Ashburn\" is not a grid code.",
      "type": "string"
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  },
  "anyOf": [
    {
      "properties": {
        "region_id": {}
      },
      "required": [
        "region_id"
      ]
    },
    {
      "properties": {
        "iso": {}
      },
      "required": [
        "iso"
      ]
    },
    {
      "properties": {
        "region": {}
      },
      "required": [
        "region"
      ]
    },
    {
      "properties": {
        "market": {}
      },
      "required": [
        "market"
      ]
    }
  ]
}

{
  "type": "object",
  "properties": {
    "region": {
      "description": "US state code or name (required), e.g. \"TX\", \"Texas\", \"Virginia\"",
      "type": "string"
    },
    "state": {
      "description": "Alias for region — the US state code or name",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "subject": {
      "description": "What you are citing, in the words you will show the human, e.g. \"Ashburn DCPI verdict\" or \"ERCOT interconnection queue depth\"",
      "type": "string"
    },
    "as_of": {
      "description": "The as_of you read off the cited response (provenance.as_of). Omit it and the line says RETRIEVED instead of claiming a data date.",
      "type": "string"
    },
    "url": {
      "description": "The profile_url or dcpi_url from the cited row. Must be a dchub.cloud URL; anything else is dropped and named in `omitted`.",
      "type": "string"
    },
    "completeness": {
      "description": "The completeness flag from the cited response, if it carried one",
      "type": "string"
    },
    "layer": {
      "description": "Which layer the figure came from: dcpi | grid_analysis | facility_inventory | physical_infrastructure | deals | other. Decides the licence line; omit and you get the scoped statement rather than a grant.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "competitor": {
      "description": "Optional competitor/vendor name for a direct comparison-page link, e.g. DataCenterHawk, \"DC Byte\", DCD, Baxtel",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "context": {
      "description": "Free-text description of the siting request — MW, geography, workload, deadline, constraints, e.g. \"100MW AI training campus in Texas, short time-to-power\"",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "criteria": {
      "description": "Ranking criterion: \"cheapest_power\", \"most_capacity\", \"most_operators\", \"fastest_growing\", \"best_overall\" (default), or \"ai_ready\" (DCPI buildability — where new AI load can land, for AI-campus siting; region us/global)",
      "type": "string"
    },
    "region": {
      "description": "Region scope: \"global\", \"us\" (default), \"canada\", \"eu\", \"apac\", or \"americas\"",
      "type": "string"
    },
    "limit": {
      "description": "Number of markets to return, 1-50 (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "min_capacity_mw": {
      "description": "Minimum existing capacity filter in megawatts (MW), e.g. 100",
      "type": "number"
    },
    "fields": {
      "description": "Return ONLY these row fields (array or comma string) — a token diet. The response envelope (citation, provenance, as_of, coverage, request_interpretation, the human relay line) is NEVER projected away; a projection narrows ROWS only.",
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "string"
        }
      ]
    },
    "projection": {
      "description": "Named field preset, cheaper to send than a field list: market_summary (ranking rows), siting_summary (site/point rows), identity_only (ids + names).",
      "type": "string",
      "enum": [
        "siting_summary",
        "market_summary",
        "identity_only"
      ]
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "facility_id": {
      "type": "string",
      "description": "The seed facility id/slug (required) to find alternatives to, from a prior search result — there is no `name` param; an undeclared key is silently stripped"
    },
    "radius_km": {
      "description": "Search radius in km for candidate alternatives around the seed facility",
      "type": "number"
    },
    "match_on": {
      "description": "Optional similarity dimension to weight, e.g. capacity, operator, fiber, market",
      "type": "string"
    },
    "exclude_operator": {
      "description": "If true, exclude facilities from the same operator as the seed",
      "type": "boolean"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "facility_id"
  ]
}

{
  "type": "object",
  "properties": {
    "facility_id": {
      "type": "string",
      "description": "The facility id/slug to score (required), from a prior search_facilities result"
    },
    "weighting": {
      "description": "Scoring profile: \"balanced\" (default), \"power_priority\", \"risk_priority\", or \"expansion_priority\"",
      "type": "string"
    }
  },
  "required": [
    "facility_id"
  ]
}

{
  "type": "object",
  "properties": {
    "horizon": {
      "description": "Deployment horizon in days: 30, 60, or 90 (default 90)",
      "type": "integer",
      "minimum": 30,
      "maximum": 90
    },
    "limit": {
      "description": "Number of top markets to return (default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Number of recent AI-capex deals to return (default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "capacity_mw": {
      "description": "Target power load for the build in megawatts (MW), 1-5000, e.g. 100",
      "type": "integer",
      "minimum": 1,
      "maximum": 5000
    },
    "region": {
      "description": "Geography scope: a US state code like TX, an ISO like ERCOT, or a region like us/apac. `state` and `iso` are accepted as aliases for this same filter.",
      "type": "string"
    },
    "state": {
      "description": "US state code, e.g. OH — alias for `region`. Use either; `region` wins if both are sent.",
      "type": "string"
    },
    "iso": {
      "description": "ISO/RTO code, e.g. ERCOT or PJM — alias for `region`. Use either; `region` wins if both are sent.",
      "type": "string"
    },
    "max_months": {
      "description": "Maximum acceptable time-to-power in months, 1-120, e.g. 24",
      "type": "integer",
      "minimum": 1,
      "maximum": 120
    },
    "verdict": {
      "description": "Optional DCPI verdict filter: BUILD, CAUTION, or AVOID — or ALL to see every scored market in the geography. Defaults to BUILD,CAUTION, so a geography whose markets are all AVOID returns matched:0 plus an `empty_result` block explaining that; re-run with verdict=ALL to see those rows.",
      "type": "string"
    },
    "limit": {
      "description": "Number of shortlist markets to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "mpp_pay": {
      "description": "Autonomous payment (Stripe MPP), step 1: set true to receive a signed per-call payment challenge (the challenge states the amount) for this call instead of the free preview. No money moves — a challenge is a price quote. Humans never set this, so it does not affect the normal free/trial funnel.",
      "type": "boolean"
    },
    "mpp_credential": {
      "description": "Autonomous payment (Stripe MPP), step 2: the Shared Payment Token you minted for challenges[0]. Set it here to pay that challenge for this single call and receive the full result — no API key, no subscription, no human. One payment covers one call.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "max_months": {
      "description": "Maximum acceptable time-to-power in months for the emergence signal, 1-120, e.g. 24",
      "type": "integer",
      "minimum": 1,
      "maximum": 120
    },
    "limit": {
      "description": "Number of emerging markets to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Number of recent deals to return (default ~15)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "comparables": {
      "description": "Comparables detail: \"none\" (default — count only, cheapest), \"summary\" (top-2 grounding signals), or \"full\" (the complete cited set). Escalate only for deals you're drilling into.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "state": {
      "description": "US state filter, e.g. NY or MN (optional)",
      "type": "string"
    },
    "class": {
      "description": "Record class: \"moratorium\" | \"zoning\" | \"tax\" | \"utility_pause\" (optional)",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "avg_kwh_cents_pct": {
      "description": "Power price % change, e.g. 30 for +30% or -20 for -20%",
      "type": "number"
    },
    "time_to_power_months_delta": {
      "description": "Months added (+) or removed (-) from time-to-power, e.g. 12",
      "type": "number"
    },
    "queue_wait_months_delta": {
      "description": "Months added/removed from interconnection queue wait",
      "type": "number"
    },
    "reserve_margin_pct_delta": {
      "description": "Percentage POINTS added/removed from reserve margin, e.g. -5",
      "type": "number"
    },
    "curtailment_pct_delta": {
      "description": "Percentage POINTS added/removed from curtailment",
      "type": "number"
    },
    "market": {
      "description": "Score ONE market by slug (optional), e.g. abilene — slugs from rank_markets",
      "type": "string"
    },
    "top_n": {
      "description": "Markets to return, ranked by |score delta| (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  }
}

{
  "type": "object",
  "properties": {
    "question": {
      "description": "The research question (min 12 chars) — omit when polling with task_id",
      "type": "string"
    },
    "task_id": {
      "description": "Poll an earlier submission: the task_id returned by a previous research_task call",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "description": "Watch kind: \"new_deal_in_market\" | \"news_keyword\" | \"permitting_change\""
    },
    "webhook_url": {
      "type": "string",
      "description": "Your public HTTPS webhook endpoint (required)"
    },
    "market": {
      "description": "For new_deal_in_market: the market/region substring to watch, e.g. columbus",
      "type": "string"
    },
    "q": {
      "description": "For news_keyword: the keyword/phrase to watch in title+summary, e.g. moratorium",
      "type": "string"
    },
    "state": {
      "description": "For permitting_change: optional US state filter, e.g. MN",
      "type": "string"
    }
  },
  "required": [
    "kind",
    "webhook_url"
  ]
}

{
  "type": "object",
  "properties": {
    "intent_id": {
      "type": "string",
      "description": "The intent_id to delete (from list_standing_intents or register)"
    }
  },
  "required": [
    "intent_id"
  ]
}

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Origin site as \"lat,lng\" OR a street address, e.g. \"250 Paringa Road, Murarrie QLD\""
    },
    "to": {
      "type": "string",
      "description": "Destination carrier hotel/POP as \"lat,lng\" OR an address, e.g. \"20 Wharf Street, Brisbane City QLD\""
    },
    "n": {
      "description": "Number of diverse routes to plan, 1-6 (default 4)",
      "type": "integer",
      "minimum": 1,
      "maximum": 6
    },
    "fibre": {
      "description": "Fibre count spec for cost estimate: \"720F\" or \"1440F\"",
      "type": "string"
    },
    "bore_m": {
      "description": "River/rail bore length in metres to add to the route, 0-100000 (optional)",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    }
  },
  "required": [
    "from",
    "to"
  ]
}

{
  "type": "object",
  "properties": {
    "sites": {
      "description": "Semicolon-separated \"lat,lon\" pairs, 2-8 sites (same format as compare_sites locations); optional per-site labels via \"lat,lon:label\", e.g. \"39.04,-77.48:ashburn;39.29,-76.61:baltimore\". cand_… tokens are also accepted here and resolve to frozen mint coordinates. Optional if candidate_ids is given",
      "type": "string"
    },
    "candidate_ids": {
      "description": "Array (or comma-separated string) of candidate_id values from get_refined_queue — each resolves to its FROZEN mint coordinates (zero transcription drift); expired/unknown are dropped and declared in candidate_contract. Use instead of, or alongside, sites"
    },
    "max_latency_us": {
      "description": "Round-trip latency budget in microseconds (default 1000 µs = 1 ms; sync replication is typically 1000-2000 µs)",
      "type": "number",
      "minimum": 1,
      "maximum": 10000000
    },
    "min_confidence": {
      "description": "Minimum evidence tier a pair must meet to count as viable: \"published\" | \"tracked\" | \"inferred\" (default inferred = include all)",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "client_name": {
      "description": "Your agent/app name for attribution, e.g. \"Claude Desktop\" or \"acme-siting-bot\"",
      "type": "string"
    },
    "email": {
      "description": "Optional owner email to make the key recoverable across sessions; use only an address your human explicitly gave",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Your human's real email address (required) — use only an address they explicitly gave; placeholder/fake addresses are rejected"
    },
    "api_key": {
      "description": "Optional key to bind; omit to bind the key already active on this session",
      "type": "string"
    },
    "marketing_opt_in": {
      "description": "Set true ONLY after your human explicitly agrees to marketing email (default false = transactional only)",
      "type": "boolean"
    }
  },
  "required": [
    "email"
  ]
}

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Your human's email address that a lost key was bound to (required) — the key is re-sent to that inbox, never returned over the wire"
    }
  },
  "required": [
    "email"
  ]
}

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "One listing: its slug or numeric id exactly as items[].slug / items[].id return it. Omit to browse teaser cards",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "market": {
      "description": "Browse filter: market name as it appears on a listing, e.g. \"Dallas\"",
      "type": "string"
    },
    "state": {
      "description": "Browse filter: two-letter US state, e.g. \"TX\"",
      "type": "string"
    },
    "min_mw": {
      "description": "Browse filter: the size your human needs, in MW (min_kw is the same filter in kW). Matched against what a listing can ACTUALLY deliver, not just its headline total: contiguous_kw is the largest single contiguous block available and min_contract_kw the smallest chunk the provider will contract, so a listing answers only when this size fits the block it declares — a site with a big total but a small contiguous block is not a hit, and a big site willing to contract small chunks is. A listing that declares neither is matched on its total.",
      "type": "number"
    },
    "min_kw": {
      "description": "Browse filter: the size your human needs, in kW (min_mw is the same filter in MW). Matched against what a listing can ACTUALLY deliver, not just its headline total: contiguous_kw is the largest single contiguous block available and min_contract_kw the smallest chunk the provider will contract, so a listing answers only when this size fits the block it declares — a site with a big total but a small contiguous block is not a hit, and a big site willing to contract small chunks is. A listing that declares neither is matched on its total.",
      "type": "number"
    },
    "region": {
      "description": "Browse filter: comma-separated regions from north_america, latin_america, europe, asia_pacific and middle_east_africa; the aliases emea, apac, latam and americas also work, e.g. \"europe\" or \"emea, apac\"",
      "type": "string"
    },
    "location": {
      "description": "Browse filter: comma-separated free text matched against each listing's region, country, state and metro, e.g. \"Germany\" or \"Texas, Phoenix\"",
      "type": "string"
    },
    "delivery_type": {
      "description": "Browse filter: how the capacity is delivered: land, powered_shell, turnkey or colocation",
      "type": "string",
      "enum": [
        "land",
        "powered_shell",
        "turnkey",
        "colocation"
      ]
    },
    "available_by": {
      "description": "Browse filter: only listings available by this date, as YYYY-MM or YYYY-MM-DD",
      "type": "string"
    },
    "limit": {
      "description": "Max results to return (1-500; default varies by tool)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The listing to register a deal for: its slug or id from source_capacity. Omit to register a standing requirement for upcoming listings instead",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "name": {
      "description": "Your human's full name. Nothing is sent without it; use only what they gave you, never invent it",
      "type": "string"
    },
    "company": {
      "description": "Your human's company. Nothing is sent without it",
      "type": "string"
    },
    "role": {
      "description": "Your human's role or title",
      "type": "string"
    },
    "capacity_mw": {
      "description": "Capacity needed, in MW",
      "type": "number"
    },
    "capacity_kw": {
      "description": "Capacity needed, in kW (capacity_mw is the same requirement in MW)",
      "type": "number"
    },
    "markets": {
      "description": "Comma-separated markets of interest, e.g. \"Dallas, Phoenix\"",
      "type": "string"
    },
    "states": {
      "description": "Comma-separated US states of interest, e.g. \"TX, AZ\"",
      "type": "string"
    },
    "regions": {
      "description": "Comma-separated regions of interest from north_america, latin_america, europe, asia_pacific and middle_east_africa (aliases emea, apac, latam, americas), e.g. \"europe, apac\"",
      "type": "string"
    },
    "countries": {
      "description": "Comma-separated countries of interest, e.g. \"Germany, Netherlands\"",
      "type": "string"
    },
    "timeline": {
      "description": "When the capacity is needed, e.g. a quarter and year",
      "type": "string"
    },
    "use_case": {
      "description": "What the capacity is for, e.g. \"AI inference\"",
      "type": "string"
    },
    "notes": {
      "description": "Anything else the provider should know about the requirement. It travels with the requirement, so leave out anything that identifies your human",
      "type": "string"
    },
    "message": {
      "description": "A short note from your human for the provider. The deal registration itself carries only the company name and the requirement",
      "type": "string"
    },
    "accept_terms": {
      "description": "Set true ONLY after your human has read and agreed to the introduction terms at https://dchub.cloud/listings#terms. Unless it is exactly true, nothing is sent",
      "type": "boolean"
    },
    "terms_version": {
      "description": "The terms version your human agreed to, e.g. program.terms.version from source_capacity. Omit to send the version currently published",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "accept_terms": {
      "description": "Set true ONLY after your human has read and agreed to the introduction terms at https://dchub.cloud/listings#terms. Unless it is exactly true, nothing is sent",
      "type": "boolean"
    },
    "terms_version": {
      "description": "The terms version your human agreed to, e.g. access.unlock.terms.version from source_capacity. Omit to send the version currently published",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "reason": {
      "description": "Optional free-text describing what you were trying to do, so your human sees why an upgrade matters",
      "type": "string"
    }
  }
}