greenpick 0.4.0__tar.gz → 0.4.2__tar.gz

{greenpick-0.4.0/src/greenpick.egg-info → greenpick-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greenpick
-Version: 0.4.0
+Version: 0.4.2
 Summary: Design-time sustainability co-pilot (MCP server): greener, cheaper cloud infrastructure decisions with carbon + cost + latency tradeoffs.
 Author-email: "Data Science Advisers, LLC" <info@datascienceadvisers.com>
 License-Expression: MIT
@@ -19,7 +19,7 @@ Classifier: Topic :: Scientific/Engineering
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp<2,>=1.2
+Requires-Dist: mcp<2,>=1.7
 Requires-Dist: pydantic>=2.0
 Requires-Dist: httpx>=0.27
 Provides-Extra: dev
@@ -60,11 +60,12 @@ seconds. (It responds when you ask; auto-nudging on infra-code changes is on the
 > this month's average for each grid, from a year of real data.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~28× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
 </p>
 
-*The same 40-GPU-hour training run emits ~0.7 kg CO₂ in Stockholm vs ~19 kg in Sydney — a ~30×
-difference from region choice alone. Ask GreenPick and it surfaces that (with the cost and latency
+*The same 40-GPU-hour training run emits ~0.6 kg CO₂ in Stockholm vs ~17.5 kg in Sydney — a ~28×
+difference from region choice alone (typical October grids; Sydney on Ember's 2025 national figure,
+a lower bound for its coal-heavier state grid). Ask GreenPick and it surfaces that (with the cost and latency
 tradeoff) while you're still in the editor, before you commit.*
 
 **▶ [See the 5-minute demo](docs/demo.md)** — three scenarios with real tool output (training placement, the egress backfire, the forecast).
@@ -195,12 +196,12 @@ See `docs/user-questions-backlog.md`.
   intensity and average hour-of-day profile (UTC), computed from 12 months of real hourly EIA-930 /
   ENTSO-E data (`data/typical.json`, refreshed by `scripts/refresh_typical.py`). Labelled
   `quality: "typical"` — a realistic norm, never presented as a current reading.
-- **Annual** — for Singapore, Tokyo and Mumbai/Pune, where no free hourly data exists: the country's
+- **Annual** — for Singapore, Tokyo, Mumbai/Pune and Sydney, where no free hourly data exists: the country's
   yearly lifecycle grid intensity from [Ember](https://ember-energy.org/) (via Our World in Data,
   CC BY 4.0), with source and year (`data/annual.json`). Labelled `quality: "annual_average"`; fine for
   comparing regions, but carries no timing signal.
-- **Mock** — a hand-set illustrative value, labelled `quality: "mock"`, used only where nothing else
-  exists (currently Sydney).
+- **Mock** — a hand-set illustrative value, labelled `quality: "mock"`, kept only as a last resort if
+  every other source is missing. No catalog region relies on it.
 - Cost: a **dated static pricing table** (`data/pricing.json`), refreshed from live Vantage
   pricing via `scripts/refresh_pricing.py` using one matched method across all three clouds.
 - Instance-family efficiency: directional perf-per-watt multipliers (`data/instance_families.json`).
@@ -318,7 +319,7 @@ carbon, set two free keys (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
 `GREENPICK_CARBON_SOURCE=auto` — see [Turn on live data](#turn-on-live-data).
 
 **Why "directional" and not audited numbers?** Because it's for a *design-time decision*, not a
-compliance report. "Stockholm is ~30× cleaner than Sydney" is what you need to pick a region in
+compliance report. "Stockholm is ~28× cleaner than Sydney" is what you need to pick a region in
 seconds — a certified figure is a different job for a different tool (Electricity Maps, WattTime).
 GreenPick is for *decisions*, not *disclosures*, and says so in every tool's limitations.
 

{greenpick-0.4.0 → greenpick-0.4.2}/README.md

@@ -30,11 +30,12 @@ seconds. (It responds when you ask; auto-nudging on infra-code changes is on the
 > this month's average for each grid, from a year of real data.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~28× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
 </p>
 
-*The same 40-GPU-hour training run emits ~0.7 kg CO₂ in Stockholm vs ~19 kg in Sydney — a ~30×
-difference from region choice alone. Ask GreenPick and it surfaces that (with the cost and latency
+*The same 40-GPU-hour training run emits ~0.6 kg CO₂ in Stockholm vs ~17.5 kg in Sydney — a ~28×
+difference from region choice alone (typical October grids; Sydney on Ember's 2025 national figure,
+a lower bound for its coal-heavier state grid). Ask GreenPick and it surfaces that (with the cost and latency
 tradeoff) while you're still in the editor, before you commit.*
 
 **▶ [See the 5-minute demo](docs/demo.md)** — three scenarios with real tool output (training placement, the egress backfire, the forecast).
@@ -165,12 +166,12 @@ See `docs/user-questions-backlog.md`.
   intensity and average hour-of-day profile (UTC), computed from 12 months of real hourly EIA-930 /
   ENTSO-E data (`data/typical.json`, refreshed by `scripts/refresh_typical.py`). Labelled
   `quality: "typical"` — a realistic norm, never presented as a current reading.
-- **Annual** — for Singapore, Tokyo and Mumbai/Pune, where no free hourly data exists: the country's
+- **Annual** — for Singapore, Tokyo, Mumbai/Pune and Sydney, where no free hourly data exists: the country's
   yearly lifecycle grid intensity from [Ember](https://ember-energy.org/) (via Our World in Data,
   CC BY 4.0), with source and year (`data/annual.json`). Labelled `quality: "annual_average"`; fine for
   comparing regions, but carries no timing signal.
-- **Mock** — a hand-set illustrative value, labelled `quality: "mock"`, used only where nothing else
-  exists (currently Sydney).
+- **Mock** — a hand-set illustrative value, labelled `quality: "mock"`, kept only as a last resort if
+  every other source is missing. No catalog region relies on it.
 - Cost: a **dated static pricing table** (`data/pricing.json`), refreshed from live Vantage
   pricing via `scripts/refresh_pricing.py` using one matched method across all three clouds.
 - Instance-family efficiency: directional perf-per-watt multipliers (`data/instance_families.json`).
@@ -288,7 +289,7 @@ carbon, set two free keys (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
 `GREENPICK_CARBON_SOURCE=auto` — see [Turn on live data](#turn-on-live-data).
 
 **Why "directional" and not audited numbers?** Because it's for a *design-time decision*, not a
-compliance report. "Stockholm is ~30× cleaner than Sydney" is what you need to pick a region in
+compliance report. "Stockholm is ~28× cleaner than Sydney" is what you need to pick a region in
 seconds — a certified figure is a different job for a different tool (Electricity Maps, WattTime).
 GreenPick is for *decisions*, not *disclosures*, and says so in every tool's limitations.
 

{greenpick-0.4.0 → greenpick-0.4.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "greenpick"
-version = "0.4.0"
+version = "0.4.2"
 description = "Design-time sustainability co-pilot (MCP server): greener, cheaper cloud infrastructure decisions with carbon + cost + latency tradeoffs."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -19,7 +19,7 @@ classifiers = [
     "Topic :: Scientific/Engineering",
 ]
 dependencies = [
-    "mcp>=1.2,<2",       # Model Context Protocol SDK (FastMCP lives here). Pinned <2: mcp 2.x
+    "mcp>=1.7,<2",       # Model Context Protocol SDK (FastMCP lives here). >=1.7: tool annotations. Pinned <2: mcp 2.x
                          # renamed FastMCP -> MCPServer and changed APIs; this code targets the 1.x API.
     "pydantic>=2.0",
     "httpx>=0.27",       # async HTTP for live data sources

{greenpick-0.4.0 → greenpick-0.4.2}/src/greenpick/__init__.py

@@ -4,7 +4,7 @@ Greener cloud-region choices with honest carbon + cost + latency tradeoffs,
 delivered inside the vibe-coding loop. Directional guidance, not audited accounting.
 """
 
-__version__ = "0.4.0"
+__version__ = "0.4.2"
 
 # httpx logs every request URL at INFO, and our live sources pass their API key / token as a URL
 # query parameter — so at the default log level the secret would land in the MCP client's logs.

{greenpick-0.4.0 → greenpick-0.4.2}/src/greenpick/data/annual.json

@@ -8,6 +8,8 @@
   "JP": { "country": "Japan", "g_co2_per_kwh": 477.3, "year": 2025,
           "note": "National average; the Tokyo (TEPCO) area mix differs somewhat and varies by hour." },
   "IN": { "country": "India", "g_co2_per_kwh": 670.1, "year": 2025,
-          "note": "National average; Maharashtra (Mumbai, Pune) runs about 6% above it on Ember's state-level data." }
+          "note": "National average; Maharashtra (Mumbai, Pune) runs about 6% above it on Ember's state-level data." },
+  "AU": { "country": "Australia", "g_co2_per_kwh": 525.2, "year": 2025,
+          "note": "National average; New South Wales (Sydney) is more coal-heavy and runs higher, so treat this as a lower bound for Sydney." }
  }
 }

{greenpick-0.4.0 → greenpick-0.4.2}/src/greenpick/data/regions.json

@@ -6,7 +6,7 @@
     "us-west-2":      { "name": "Oregon",        "lat": 45.87, "lon": -119.69, "zone": "US-NW-PACW", "eia_ba": "BPAT", "jurisdiction": "US" },
     "eu-west-1":      { "name": "Ireland",       "lat": 53.41, "lon": -8.24,  "zone": "IE", "entsoe_eic": "10Y1001A1001A59C", "jurisdiction": "EEA" },
     "eu-north-1":     { "name": "Stockholm",     "lat": 59.33, "lon": 18.07,  "zone": "SE", "entsoe_eic": "10YSE-1--------K", "jurisdiction": "EEA" },
-    "ap-southeast-2": { "name": "Sydney",        "lat": -33.87, "lon": 151.21, "zone": "AU-NSW", "jurisdiction": "AU" },
+    "ap-southeast-2": { "name": "Sydney",        "lat": -33.87, "lon": 151.21, "zone": "AU-NSW", "annual_zone": "AU", "jurisdiction": "AU" },
     "ca-central-1":   { "name": "Montreal",      "lat": 45.50, "lon": -73.57, "zone": "CA-QC", "ca_source": "hq", "jurisdiction": "CA" },
     "ap-southeast-1": { "name": "Singapore",     "lat": 1.29,  "lon": 103.85, "zone": "SG", "annual_zone": "SG", "jurisdiction": "SG" },
     "ap-northeast-1": { "name": "Tokyo",         "lat": 35.68, "lon": 139.69, "zone": "JP-TK", "annual_zone": "JP", "jurisdiction": "JP" },

{greenpick-0.4.0 → greenpick-0.4.2}/src/greenpick/server.py

@@ -8,6 +8,17 @@ from __future__ import annotations
 from typing import Optional
 
 from mcp.server.fastmcp import FastMCP
+from mcp.types import ToolAnnotations
+
+# Tool annotations let MCP hosts decide whether to ask the user before a call (and some
+# directories require them). Every GreenPick tool only reads and computes: nothing is created,
+# changed or deleted, so repeating a call has no extra effect. Most fetch live grid data from
+# outside services (EIA, ENTSO-E, Hydro-Québec, IESO) -> openWorldHint; the methodology tool
+# returns fixed text only.
+LIVE_DATA_TOOL = ToolAnnotations(readOnlyHint=True, destructiveHint=False,
+                                 idempotentHint=True, openWorldHint=True)
+LOCAL_TOOL = ToolAnnotations(readOnlyHint=True, destructiveHint=False,
+                             idempotentHint=True, openWorldHint=False)
 
 from .models import Workload, GeoPoint, Provider
 from .data import get_repository
@@ -48,7 +59,7 @@ mcp = FastMCP("greenpick", instructions=INSTRUCTIONS)
 _repo = get_repository()
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def compare_regions_tri_axis(
     user_lat: float,
     user_lon: float,
@@ -80,7 +91,7 @@ async def compare_regions_tri_axis(
     return with_hint(rec.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def greener_alternative_to(
     current_region: str,
     user_lat: float,
@@ -110,7 +121,7 @@ async def greener_alternative_to(
     return with_hint(rec.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def estimate_workload_carbon(
     provider: str,
     region: str,
@@ -134,7 +145,7 @@ async def estimate_workload_carbon(
     })
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def region_carbon_now(provider: str, region: str) -> dict:
     """Current grid carbon intensity for a region, with source, timestamp, and data freshness.
     When the reading is live, also says how it compares with what's typical for that hour this month
@@ -149,7 +160,7 @@ async def region_carbon_now(provider: str, region: str) -> dict:
     return with_hint(out)
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def cleanest_hours_to_run(
     provider: str, region: str, top_n: int = 3, window_hours: Optional[int] = None,
 ) -> dict:
@@ -164,7 +175,7 @@ async def cleanest_hours_to_run(
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def greener_instance_family(
     provider: str,
     region: str,
@@ -192,7 +203,7 @@ async def greener_instance_family(
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def estimate_inference_carbon(
     size_class: str,
     monthly_requests: float,
@@ -214,7 +225,7 @@ async def estimate_inference_carbon(
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def rightsizing_check(
     provider: str,
     region: str,
@@ -237,7 +248,7 @@ async def rightsizing_check(
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def carbon_metric_scaffold(
     language: str = "python",
     region: Optional[str] = None,
@@ -260,7 +271,7 @@ async def carbon_metric_scaffold(
     return with_hint(scaffold.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def serving_pattern_advice(
     hubs: list[dict],
     vcpu: float = 1,
@@ -290,7 +301,7 @@ async def serving_pattern_advice(
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def data_locality_egress_check(
     compute_provider: str,
     compute_region: str,
@@ -312,7 +323,7 @@ async def data_locality_egress_check(
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def carbon_forecast(
     provider: str, region: str, hours_ahead: int = 24, top_n: int = 5,
 ) -> dict:
@@ -327,7 +338,7 @@ async def carbon_forecast(
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def cleanest_time_of_day(provider: str, region: str) -> dict:
     """For a RECURRING job (e.g. a nightly batch you run every day), find the region's cleanest
     time of day — each hour-of-day averaged across the recent days of data. Returns the cleanest/
@@ -337,7 +348,7 @@ async def cleanest_time_of_day(provider: str, region: str) -> dict:
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LIVE_DATA_TOOL)
 async def estimate_training_carbon(
     gpu: str,
     gpu_count: int,
@@ -364,7 +375,7 @@ async def estimate_training_carbon(
     return with_hint(advice.model_dump())
 
 
-@mcp.tool()
+@mcp.tool(annotations=LOCAL_TOOL)
 def explain_methodology_and_limits() -> dict:
     """GreenPick's assumptions and what it explicitly does NOT claim. Read this before trusting a number."""
     return {
@@ -381,6 +392,6 @@ def explain_methodology_and_limits() -> dict:
         "forecast": "Day-ahead forecast is RELATIVE: upcoming hours ranked by forecast wind+solar output (ENTSO-E A69), not an absolute gCO2/kWh forecast. EU only; US/uncovered zones degrade to the recent historical pattern (labelled 'historical').",
         "data_residency": "GreenPick flags when a recommended move CROSSES a jurisdiction (esp. leaving the EEA) as a geographic heads-up only. It does NOT assess legal/GDPR compliance, does not encode adequacy decisions, and is not legal advice — confirm with your own data governance.",
         "ignored": "Embodied/hardware carbon and provider renewable-energy certificates.",
-        "fallback_data": "Used when live data isn't available (no key, the source didn't respond, or GreenPick isn't set to live). 'typical' = this calendar month's average intensity and average hour-of-day profile (UTC) for the region, computed from 12 months of real hourly EIA-930 / ENTSO-E data with GreenPick's own emission factors (bundled typical.json, refreshed by scripts/refresh_typical.py) — a realistic norm, not a current reading. 'annual_average' = the country's yearly lifecycle grid intensity from Ember (via Our World in Data; bundled annual.json with source and year), for regions with no free hourly data (Singapore, Tokyo, Mumbai/Pune) — sound for comparing regions, no timing signal (no hourly profile). 'mock' = a hand-set illustrative value with a synthetic hourly pattern, used only where nothing else exists (Sydney); timing advice on mock isn't meaningful. Both carry a live_data_hint saying why the result isn't live and how to turn live data on.",
+        "fallback_data": "Used when live data isn't available (no key, the source didn't respond, or GreenPick isn't set to live). 'typical' = this calendar month's average intensity and average hour-of-day profile (UTC) for the region, computed from 12 months of real hourly EIA-930 / ENTSO-E data with GreenPick's own emission factors (bundled typical.json, refreshed by scripts/refresh_typical.py) — a realistic norm, not a current reading. 'annual_average' = the country's yearly lifecycle grid intensity from Ember (via Our World in Data; bundled annual.json with source and year), for regions with no free hourly data (Singapore, Tokyo, Mumbai/Pune, Sydney — national figures, so Sydney's is a lower bound for its coal-heavier state) — sound for comparing regions, no timing signal (no hourly profile). 'mock' = a hand-set illustrative value with a synthetic hourly pattern, a last resort no catalog region relies on; timing advice on mock isn't meaningful. Both carry a live_data_hint saying why the result isn't live and how to turn live data on.",
         "data_sources": "GREENPICK_CARBON_SOURCE=auto routes US regions to EIA-930 and EU regions to ENTSO-E (both free, key needed), and Canadian regions to Hydro-Québec (Québec) and IESO (Ontario) open data (free, no key). All mixes are weighted with the same per-fuel factors. Without live data a region uses its clearly-labelled typical value (or mock where no free source exists). Electricity Maps is available when selected explicitly (GREENPICK_CARBON_SOURCE=electricitymaps).",
     }

{greenpick-0.4.0 → greenpick-0.4.2/src/greenpick.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: greenpick
-Version: 0.4.0
+Version: 0.4.2
 Summary: Design-time sustainability co-pilot (MCP server): greener, cheaper cloud infrastructure decisions with carbon + cost + latency tradeoffs.
 Author-email: "Data Science Advisers, LLC" <info@datascienceadvisers.com>
 License-Expression: MIT
@@ -19,7 +19,7 @@ Classifier: Topic :: Scientific/Engineering
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp<2,>=1.2
+Requires-Dist: mcp<2,>=1.7
 Requires-Dist: pydantic>=2.0
 Requires-Dist: httpx>=0.27
 Provides-Extra: dev
@@ -60,11 +60,12 @@ seconds. (It responds when you ask; auto-nudging on infra-code changes is on the
 > this month's average for each grid, from a year of real data.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~30× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
+  <img src="https://raw.githubusercontent.com/bithug01/greenpick/master/docs/img/region-carbon-30x.svg" alt="Same H100 training run, ~28× the carbon depending only on region (Stockholm vs Sydney)" width="560" />
 </p>
 
-*The same 40-GPU-hour training run emits ~0.7 kg CO₂ in Stockholm vs ~19 kg in Sydney — a ~30×
-difference from region choice alone. Ask GreenPick and it surfaces that (with the cost and latency
+*The same 40-GPU-hour training run emits ~0.6 kg CO₂ in Stockholm vs ~17.5 kg in Sydney — a ~28×
+difference from region choice alone (typical October grids; Sydney on Ember's 2025 national figure,
+a lower bound for its coal-heavier state grid). Ask GreenPick and it surfaces that (with the cost and latency
 tradeoff) while you're still in the editor, before you commit.*
 
 **▶ [See the 5-minute demo](docs/demo.md)** — three scenarios with real tool output (training placement, the egress backfire, the forecast).
@@ -195,12 +196,12 @@ See `docs/user-questions-backlog.md`.
   intensity and average hour-of-day profile (UTC), computed from 12 months of real hourly EIA-930 /
   ENTSO-E data (`data/typical.json`, refreshed by `scripts/refresh_typical.py`). Labelled
   `quality: "typical"` — a realistic norm, never presented as a current reading.
-- **Annual** — for Singapore, Tokyo and Mumbai/Pune, where no free hourly data exists: the country's
+- **Annual** — for Singapore, Tokyo, Mumbai/Pune and Sydney, where no free hourly data exists: the country's
   yearly lifecycle grid intensity from [Ember](https://ember-energy.org/) (via Our World in Data,
   CC BY 4.0), with source and year (`data/annual.json`). Labelled `quality: "annual_average"`; fine for
   comparing regions, but carries no timing signal.
-- **Mock** — a hand-set illustrative value, labelled `quality: "mock"`, used only where nothing else
-  exists (currently Sydney).
+- **Mock** — a hand-set illustrative value, labelled `quality: "mock"`, kept only as a last resort if
+  every other source is missing. No catalog region relies on it.
 - Cost: a **dated static pricing table** (`data/pricing.json`), refreshed from live Vantage
   pricing via `scripts/refresh_pricing.py` using one matched method across all three clouds.
 - Instance-family efficiency: directional perf-per-watt multipliers (`data/instance_families.json`).
@@ -318,7 +319,7 @@ carbon, set two free keys (`EIA_API_KEY` for US, `ENTSOE_TOKEN` for EU) and
 `GREENPICK_CARBON_SOURCE=auto` — see [Turn on live data](#turn-on-live-data).
 
 **Why "directional" and not audited numbers?** Because it's for a *design-time decision*, not a
-compliance report. "Stockholm is ~30× cleaner than Sydney" is what you need to pick a region in
+compliance report. "Stockholm is ~28× cleaner than Sydney" is what you need to pick a region in
 seconds — a certified figure is a different job for a different tool (Electricity Maps, WattTime).
 GreenPick is for *decisions*, not *disclosures*, and says so in every tool's limitations.
 

{greenpick-0.4.0 → greenpick-0.4.2}/src/greenpick.egg-info/requires.txt

@@ -1,4 +1,4 @@
-mcp<2,>=1.2
+mcp<2,>=1.7
 pydantic>=2.0
 httpx>=0.27
 

{greenpick-0.4.0 → greenpick-0.4.2}/tests/test_services.py

@@ -348,10 +348,10 @@ async def test_auto_router_picks_source_by_region(monkeypatch):
     repo = AutoRepository(eia_key="k", entsoe_token="t")
     us = await repo.carbon_now("aws", "us-east-1")      # -> EIA
     eu = await repo.carbon_now("aws", "eu-north-1")     # -> ENTSO-E
-    syd = await repo.carbon_now("aws", "ap-southeast-2")  # -> mock
+    syd = await repo.carbon_now("aws", "ap-southeast-2")  # -> no live source: sourced yearly figure
     assert us.source == "eia"
     assert eu.source == "entsoe"
-    assert syd.quality == "mock"
+    assert syd.quality == "annual_average"
 
 
 @pytest.mark.asyncio
@@ -1494,14 +1494,26 @@ async def test_typical_reading_is_this_months_real_average():
 
 
 @pytest.mark.asyncio
-async def test_uncovered_region_still_falls_back_to_mock():
+async def test_mock_is_only_the_last_resort(monkeypatch):
+    from greenpick.data import typical_repository as tr
     repo = TypicalCarbonRepository()
+    # Sydney has no typical data but a sourced yearly figure -> annual, not mock.
     r = await repo.carbon_now("aws", "ap-southeast-2")
-    assert r.quality == "mock"
+    assert r.quality == "annual_average" and r.g_co2_per_kwh == 525.2
+    # With no yearly figure either, mock still answers (labelled) rather than failing.
+    monkeypatch.setattr(tr, "annual_entry", lambda p, reg: None)
+    m = await repo.carbon_now("aws", "ap-southeast-2")
+    assert m.quality == "mock"
     hist = await repo.carbon_history("aws", "ap-southeast-2")
     assert hist and hist[0].period.startswith("H") and not hist[0].period.endswith("Z")
 
 
+def test_no_catalog_region_relies_on_mock():
+    from greenpick.data.static_data import iter_regions
+    for prov, reg, meta in iter_regions():
+        assert typical_entry(prov, reg) or annual_entry(prov, reg), f"{prov}/{reg} would be mock"
+
+
 @pytest.mark.asyncio
 async def test_typical_history_is_the_months_real_profile_in_utc():
     from greenpick.services import scheduling_service as ss
@@ -1780,3 +1792,55 @@ async def test_asian_users_are_now_served_from_asia():
     adv = await serving_service.serving_pattern(TypicalCarbonRepository(), hubs, Workload(vcpu=1, ram_gb=2))
     assert adv.single_region.region in ("ap-southeast-1", "asia-southeast1", "southeastasia")
     assert adv.single_region.weighted_latency_ms < 40                  # was ~199 ms from Sydney
+
+
+# --- 0.4.2: tool annotations on every tool; every tool tested by name ---
+
+def test_every_tool_declares_all_four_annotation_hints():
+    import asyncio
+    from greenpick import server
+    tools = asyncio.run(server.mcp.list_tools())
+    assert len(tools) == 15
+    for t in tools:
+        a = t.annotations
+        assert a is not None, t.name
+        for hint in (a.readOnlyHint, a.destructiveHint, a.idempotentHint, a.openWorldHint):
+            assert isinstance(hint, bool), t.name           # explicit booleans, none missing
+        assert a.readOnlyHint and not a.destructiveHint and a.idempotentHint, t.name
+    local = {t.name for t in tools if not t.annotations.openWorldHint}
+    assert local == {"explain_methodology_and_limits"}   # the only tool that fetches nothing
+
+
+def _tool(name):
+    from greenpick import server
+    f = getattr(server, name)
+    return getattr(f, "fn", f)
+
+
+@pytest.mark.asyncio
+async def test_tool_greener_alternative_to(monkeypatch):
+    from greenpick import server
+    monkeypatch.setattr(server, "_repo", MockCarbonRepository())
+    r = await _tool("greener_alternative_to")(current_region="us-east-1", user_lat=40.71, user_lon=-74.01,
+                                               vcpu=4, ram_gb=16, max_added_latency_ms=50)
+    assert r["recommended_region"] in ("aws/ca-central-1", "gcp/northamerica-northeast1", "azure/canadaeast")
+    picked = next(c for c in r["candidates"]
+                  if f"{c['provider']}/{c['region']}" == r["recommended_region"])
+    assert picked["added_latency_ms"] <= 50 + 15
+
+
+@pytest.mark.asyncio
+async def test_tool_cleanest_hours_to_run(monkeypatch):
+    from greenpick import server
+    monkeypatch.setattr(server, "_repo", TypicalCarbonRepository())
+    r = await _tool("cleanest_hours_to_run")(provider="aws", region="us-west-2", window_hours=4)
+    assert r["quality"] == "typical" and r["cleanest"]
+    assert r["window"]["window_hours"] == 4 and r["window"]["start_hour_of_day"] is not None
+    assert "live_data_hint" in r
+
+
+def test_tool_explain_methodology_and_limits():
+    r = _tool("explain_methodology_and_limits")()
+    for key in ("what_it_is", "what_it_is_not", "carbon", "cost", "fallback_data", "data_sources"):
+        assert r.get(key), key
+    assert "annual_average" in r["fallback_data"] and "Hydro-Québec" in r["data_sources"]