ng-postcode-mcp 0.2.3__tar.gz → 0.2.4__tar.gz

{ng_postcode_mcp-0.2.3 → ng_postcode_mcp-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ng-postcode-mcp
-Version: 0.2.3
+Version: 0.2.4
 Summary: MCP server for Nigeria's NIPOST digital postcode (NDAPS): validate, look up, reverse-geocode and resolve addresses to postcodes.
 Project-URL: Repository, https://github.com/Adeniyikayodee/ng-postcode
 Project-URL: Issues, https://github.com/Adeniyikayodee/ng-postcode/issues
@@ -22,7 +22,7 @@ Classifier: Topic :: Scientific/Engineering :: GIS
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: mcp<3,>=2.3
-Requires-Dist: ng-address-resolver<0.2,>=0.1.3
+Requires-Dist: ng-address-resolver<0.2,>=0.1.4
 Requires-Dist: ng-postcode[client]<0.3,>=0.2.1
 Description-Content-Type: text/markdown
 

{ng_postcode_mcp-0.2.3 → ng_postcode_mcp-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ng-postcode-mcp"
-version = "0.2.3"
+version = "0.2.4"
 description = "MCP server for Nigeria's NIPOST digital postcode (NDAPS): validate, look up, reverse-geocode and resolve addresses to postcodes."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -26,7 +26,7 @@ classifiers = [
     "Topic :: Scientific/Engineering :: GIS",
     "Typing :: Typed",
 ]
-dependencies = ["mcp>=2.3,<3", "ng-address-resolver>=0.1.3,<0.2", "ng-postcode[client]>=0.2.1,<0.3"]
+dependencies = ["mcp>=2.3,<3", "ng-address-resolver>=0.1.4,<0.2", "ng-postcode[client]>=0.2.1,<0.3"]
 
 [project.scripts]
 ng-postcode-mcp = "ng_postcode_mcp.server:main"

{ng_postcode_mcp-0.2.3 → ng_postcode_mcp-0.2.4}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.Adeniyikayodee/ng-postcode",
   "title": "Nigeria Postcode",
   "description": "Validate, look up and resolve addresses to Nigeria's NIPOST digital postcodes (NDAPS).",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "repository": {
     "url": "https://github.com/Adeniyikayodee/ng-postcode",
     "source": "github",
@@ -13,7 +13,7 @@
     {
       "registryType": "pypi",
       "identifier": "ng-postcode-mcp",
-      "version": "0.2.3",
+      "version": "0.2.4",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

{ng_postcode_mcp-0.2.3 → ng_postcode_mcp-0.2.4}/src/ng_postcode_mcp/server.py

@@ -65,6 +65,7 @@ HINTS = {
     "level_not_granted": "The key is not granted this lookup level; use a lower level or "
     f"request more access at {KEY_URL}.",
 }
+LEVEL_2_FIELDS = ("state_name", "lga_name", "locality_name", "address")
 STATUS_HINTS = {
     403: "The key lacks the scope or access level for this request.",
     429: "NIPOST rate limit reached; wait before retrying.",
@@ -298,11 +299,14 @@ def create_server(
             Field(ge=0, le=250, description="Search radius in metres. Defaults to 25."),
         ] = None,
     ) -> Location:
-        """Return the postcode of the nearest building to a coordinate in Nigeria."""
+        """Return the postcode of the nearest building to a coordinate in Nigeria.
+
+        Names and the house address are withheld unless NG_POSTCODE_MAX_LEVEL is 2 or more.
+        """
         result = await api(ctx).send(
             reverse(Coordinate(lat=latitude, lng=longitude), max_distance_m)
         )
-        return Location.model_validate(unwrap(result))
+        return capped(Location.model_validate(unwrap(result)), settings.max_level)
 
     @server.tool(
         title="Resolve a Nigerian address to a postcode",
@@ -383,6 +387,14 @@ def geocoder_for(settings: Settings, http: httpx.AsyncClient | None) -> Nominati
     )
 
 
+def capped(location: Location, max_level: int) -> Location:
+    """The location without the fields a level 2 key adds, unless the cap allows them."""
+    if max_level >= 2 or location.unit is None:
+        return location
+    unit = location.unit.model_copy(update=dict.fromkeys(LEVEL_2_FIELDS))
+    return location.model_copy(update={"unit": unit})
+
+
 def completions(found: Autocomplete) -> Completions:
     return Completions(
         segment=None if found.segment is None else found.segment.value,

{ng_postcode_mcp-0.2.3 → ng_postcode_mcp-0.2.4}/tests/test_resolve_tool.py

@@ -61,6 +61,13 @@ async def call(
     return result
 
 
+@pytest.mark.anyio
+async def test_queries_without_landmarks_never_give_a_building() -> None:
+    queries = {k: v for k, v in BEHIND_FABIAN.items() if k != "landmarks"}
+    answer = (await call(queries)).structured_content
+    assert (answer["status"], answer["level"]) == ("partial", "area")
+
+
 @pytest.mark.anyio
 async def test_the_host_models_reading_drives_the_answer() -> None:
     searched: list[httpx.Request] = []

{ng_postcode_mcp-0.2.3 → ng_postcode_mcp-0.2.4}/tests/test_tools.py

@@ -22,6 +22,7 @@ from ng_postcode_mcp.server import (
     Location,
     NearestBuilding,
     PostcodeDetails,
+    capped,
     unwrap,
 )
 
@@ -181,6 +182,26 @@ async def test_autocomplete_and_reverse() -> None:
     assert (near.structured_content["found"], near.structured_content["radius_m"]) == (False, 25.0)
 
 
+def test_the_level_cap_withholds_names_and_addresses() -> None:
+    unit = NearestBuilding(
+        postcode="EK-01-A03-FK-01",
+        display="EK 01 A03 FK 01",
+        distance_m=8.0,
+        confidence="high",
+        state_name="EKITI",
+        lga_name="ADO EKITI",
+        locality_name="ADO EKITI",
+        address="NTA ROAD",
+    )
+    found = Location(
+        found=True, unit=unit, area=None, district=None, state=None, message=None, radius_m=25.0
+    )
+    assert capped(found, 2) == found
+    held = capped(found, 1).unit
+    assert held is not None
+    assert (held.postcode, held.address, held.state_name) == ("EK-01-A03-FK-01", None, None)
+
+
 @pytest.mark.anyio
 async def test_rejects_out_of_range_arguments() -> None:
     result = await call("find_postcode_at_location", {"latitude": 95, "longitude": 5.22})