m365-roadmap-mcp 0.2.1__py3-none-any.whl → 0.3.0__py3-none-any.whl

m365_roadmap_mcp/feeds/m365_api.py

@@ -55,6 +55,20 @@ def _parse_item(item: dict) -> RoadmapFeature | None:
             if "tagName" in c
         ]
 
+        # Extract release phases from tagsContainer
+        release_phases = [
+            r["tagName"]
+            for r in tags_container.get("releasePhase", [])
+            if "tagName" in r
+        ]
+
+        # Extract platforms from tagsContainer
+        platforms = [
+            p["tagName"]
+            for p in tags_container.get("platforms", [])
+            if "tagName" in p
+        ]
+
         return RoadmapFeature(
             id=str(item.get("id", "")),
             title=item.get("title", ""),
@@ -62,7 +76,10 @@ def _parse_item(item: dict) -> RoadmapFeature | None:
             status=item.get("status"),
             tags=products,
             cloud_instances=cloud_instances,
+            release_phases=release_phases,
+            platforms=platforms,
             public_disclosure_date=item.get("publicDisclosureAvailabilityDate"),
+            public_preview_date=item.get("publicPreviewDate"),
             created=item.get("created"),
             modified=item.get("modified"),
         )

m365_roadmap_mcp/models/feature.py

@@ -21,9 +21,21 @@ class RoadmapFeature(BaseModel):
         default_factory=list,
         description="Cloud availability (e.g., Worldwide, GCC, GCC High, DoD)",
     )
+    release_phases: list[str] = Field(
+        default_factory=list,
+        description="Release phases (e.g., General Availability, Preview, Targeted Release)",
+    )
+    platforms: list[str] = Field(
+        default_factory=list,
+        description="Target platforms (e.g., Web, Desktop, iOS, Android, Mac)",
+    )
     public_disclosure_date: str | None = Field(
         default=None,
-        description="Estimated release date (e.g., August CY2026)",
+        description="Estimated rollout start date (e.g., December CY2026)",
+    )
+    public_preview_date: str | None = Field(
+        default=None,
+        description="Estimated preview availability date (e.g., July 2026)",
     )
     created: str | None = Field(
         default=None,
@@ -43,7 +55,10 @@ class RoadmapFeature(BaseModel):
             "status": self.status,
             "tags": self.tags,
             "cloud_instances": self.cloud_instances,
+            "release_phases": self.release_phases,
+            "platforms": self.platforms,
             "public_disclosure_date": self.public_disclosure_date,
+            "public_preview_date": self.public_preview_date,
             "created": self.created,
             "modified": self.modified,
         }

m365_roadmap_mcp/server.py

@@ -22,13 +22,20 @@ mcp = FastMCP(
         "- status: filter by status ('In development', 'Rolling out', 'Launched')\n"
         "- cloud_instance: filter by cloud instance ('GCC', 'GCC High', 'DoD')\n"
         "- feature_id: retrieve a single feature by its roadmap ID\n"
-        "- added_within_days: show only features added within N days\n\n"
+        "- added_within_days: show only features added within N days\n"
+        "- release_phase: filter by release phase ('General Availability', 'Preview')\n"
+        "- platform: filter by platform ('Web', 'Desktop', 'iOS', 'Android', 'Mac')\n"
+        "- rollout_date: filter by rollout start date (e.g. 'December 2026')\n"
+        "- preview_date: filter by preview availability date (e.g. 'July 2026')\n"
+        "- modified_within_days: show only features modified within N days\n\n"
         "Tips:\n"
         "- To get feature details, use feature_id with the roadmap ID.\n"
         "- To check cloud availability, use cloud_instance with a feature_id or "
         "product filter. The cloud_instances field in each result shows all "
         "supported instances.\n"
-        "- To list recent additions, use added_within_days (e.g. 30 for last month)."
+        "- To list recent additions, use added_within_days (e.g. 30 for last month).\n"
+        "- To filter by release phase or platform, use release_phase or platform filters.\n"
+        "- To search by dates, use rollout_date or preview_date with partial date strings."
     ),
 )
 

m365_roadmap_mcp/tools/cloud.py

@@ -0,0 +1,70 @@
+"""Tool for checking cloud instance availability of M365 Roadmap features."""
+
+from ..feeds.m365_api import fetch_features
+
+
+async def check_cloud_availability(feature_id: str, instance: str) -> dict:
+    """Check whether a Microsoft 365 Roadmap feature is available for a specific cloud instance.
+
+    Critical for government and defense clients who need to verify feature availability
+    on GCC, GCC High, or DoD cloud instances before planning deployments.
+
+    Args:
+        feature_id: The unique Roadmap ID (e.g., "534606").
+        instance: The cloud instance to check (e.g., "GCC", "GCC High", "DoD",
+            "Worldwide"). Case-insensitive partial match is used, so "gcc" matches
+            "GCC" and "GCC High".
+
+    Returns:
+        Dictionary with:
+        - feature_id: The queried feature ID
+        - instance_queried: The cloud instance that was checked
+        - found: Whether the feature was found in the roadmap
+        - available: Whether the feature is available for the queried instance
+        - matched_instances: List of cloud instances that matched the query
+        - all_instances: All cloud instances the feature supports
+        - status: Feature status (if found)
+        - public_disclosure_date: Estimated release date (if found)
+        - title: Feature title (if found)
+        - error: Error message (if feature not found)
+    """
+    features = await fetch_features()
+
+    # Find the feature by ID
+    target = None
+    for feature in features:
+        if feature.id == feature_id:
+            target = feature
+            break
+
+    if target is None:
+        return {
+            "feature_id": feature_id,
+            "instance_queried": instance,
+            "found": False,
+            "available": False,
+            "matched_instances": [],
+            "all_instances": [],
+            "status": None,
+            "public_disclosure_date": None,
+            "title": None,
+            "error": f"No feature found with ID '{feature_id}'",
+        }
+
+    # Case-insensitive partial match on cloud instances
+    instance_lower = instance.lower()
+    matched = [
+        ci for ci in target.cloud_instances if instance_lower in ci.lower()
+    ]
+
+    return {
+        "feature_id": feature_id,
+        "instance_queried": instance,
+        "found": True,
+        "available": len(matched) > 0,
+        "matched_instances": matched,
+        "all_instances": target.cloud_instances,
+        "status": target.status,
+        "public_disclosure_date": target.public_disclosure_date,
+        "title": target.title,
+    }

m365_roadmap_mcp/tools/details.py

@@ -0,0 +1,35 @@
+"""Tool for retrieving full details of a single M365 Roadmap feature."""
+
+from ..feeds.m365_api import fetch_features
+
+
+async def get_feature_details(feature_id: str) -> dict:
+    """Retrieve full metadata for a specific Microsoft 365 Roadmap feature by its ID.
+
+    Use this tool when you need complete details about a known roadmap feature,
+    including its description, status, product tags, cloud instance availability,
+    and release date.
+
+    Args:
+        feature_id: The unique Roadmap ID (e.g., "534606").
+
+    Returns:
+        Dictionary with:
+        - found: Whether the feature was found
+        - feature: Full feature object if found, None otherwise
+        - error: Error message if not found
+    """
+    features = await fetch_features()
+
+    for feature in features:
+        if feature.id == feature_id:
+            return {
+                "found": True,
+                "feature": feature.to_dict(),
+            }
+
+    return {
+        "found": False,
+        "feature": None,
+        "error": f"No feature found with ID '{feature_id}'",
+    }

m365_roadmap_mcp/tools/recent.py

@@ -0,0 +1,50 @@
+"""Tool for listing recently added M365 Roadmap features."""
+
+from datetime import datetime, timedelta, timezone
+
+from ..feeds.m365_api import fetch_features
+
+
+async def list_recent_additions(days: int = 7) -> dict:
+    """List features recently added to the Microsoft 365 Roadmap.
+
+    Use this tool to monitor what new features have appeared on the roadmap
+    within a given time window. Useful for staying current on Microsoft's
+    latest plans and announcements.
+
+    Args:
+        days: Number of days to look back (default: 7, clamped to 1–365).
+
+    Returns:
+        Dictionary with:
+        - total_found: Number of features added within the time window
+        - features: List of recently added feature objects
+        - days_queried: The actual number of days used (after clamping)
+        - cutoff_date: The earliest date included in the results (ISO format)
+    """
+    # Clamp days to reasonable bounds
+    days = max(1, min(days, 365))
+
+    cutoff = datetime.now(timezone.utc) - timedelta(days=days)
+    features = await fetch_features()
+
+    recent = []
+    for feature in features:
+        if not feature.created:
+            continue
+        try:
+            created_dt = datetime.fromisoformat(feature.created)
+            # Ensure timezone-aware comparison
+            if created_dt.tzinfo is None:
+                created_dt = created_dt.replace(tzinfo=timezone.utc)
+            if created_dt >= cutoff:
+                recent.append(feature)
+        except (ValueError, TypeError):
+            continue
+
+    return {
+        "total_found": len(recent),
+        "features": [f.to_dict() for f in recent],
+        "days_queried": days,
+        "cutoff_date": cutoff.isoformat(),
+    }

m365_roadmap_mcp/tools/search.py

@@ -12,6 +12,11 @@ async def search_roadmap(
     cloud_instance: str | None = None,
     feature_id: str | None = None,
     added_within_days: int | None = None,
+    release_phase: str | None = None,
+    platform: str | None = None,
+    rollout_date: str | None = None,
+    preview_date: str | None = None,
+    modified_within_days: int | None = None,
     limit: int = 10,
 ) -> dict:
     """Search the Microsoft 365 Roadmap for features matching keywords and filters.
@@ -29,6 +34,11 @@ async def search_roadmap(
     - Filter by cloud instance (cloud_instance="GCC High", "DoD", "GCC")
     - Retrieve a specific feature by ID (feature_id="534606")
     - List recently added features (added_within_days=30)
+    - Filter by release phase (release_phase="General Availability", "Preview")
+    - Filter by platform (platform="Web", "iOS", "Android")
+    - Filter by rollout date (rollout_date="December 2026")
+    - Filter by preview date (preview_date="July 2026")
+    - List recently modified features (modified_within_days=7)
     - Combine any of the above (query="Copilot" + product="Teams" + cloud_instance="GCC")
 
     Args:
@@ -43,6 +53,14 @@ async def search_roadmap(
         added_within_days: Optional number of days to look back for recently added
             features (clamped to 1–365). Only features with a created date within
             this window are returned.
+        release_phase: Optional release phase filter (case-insensitive partial match).
+        platform: Optional platform filter (case-insensitive partial match).
+        rollout_date: Optional rollout start date filter (partial string match against
+            publicDisclosureAvailabilityDate, e.g. "December 2026").
+        preview_date: Optional preview availability date filter (partial string match
+            against publicPreviewDate, e.g. "July 2026").
+        modified_within_days: Optional number of days to look back for recently modified
+            features (clamped to 1-365).
         limit: Maximum number of results to return (default: 10, max: 100).
             Ignored when feature_id is provided.
 
@@ -78,11 +96,21 @@ async def search_roadmap(
         added_within_days = max(1, min(added_within_days, 365))
         cutoff = datetime.now(timezone.utc) - timedelta(days=added_within_days)
 
+    # Compute modified cutoff if requested
+    modified_cutoff = None
+    if modified_within_days is not None:
+        modified_within_days = max(1, min(modified_within_days, 365))
+        modified_cutoff = datetime.now(timezone.utc) - timedelta(days=modified_within_days)
+
     # Prepare lowercase values for case-insensitive matching
     query_lower = query.lower() if query else None
     product_lower = product.lower() if product else None
     status_lower = status.lower() if status else None
     cloud_lower = cloud_instance.lower() if cloud_instance else None
+    release_phase_lower = release_phase.lower() if release_phase else None
+    platform_lower = platform.lower() if platform else None
+    rollout_date_lower = rollout_date.lower() if rollout_date else None
+    preview_date_lower = preview_date.lower() if preview_date else None
 
     # Apply all filters
     matched = []
@@ -102,6 +130,26 @@ async def search_roadmap(
             if not any(cloud_lower in ci.lower() for ci in feature.cloud_instances):
                 continue
 
+        # Release phase filter (partial match)
+        if release_phase_lower:
+            if not any(release_phase_lower in rp.lower() for rp in feature.release_phases):
+                continue
+
+        # Platform filter (partial match)
+        if platform_lower:
+            if not any(platform_lower in p.lower() for p in feature.platforms):
+                continue
+
+        # Rollout date filter (partial match against publicDisclosureAvailabilityDate)
+        if rollout_date_lower:
+            if not feature.public_disclosure_date or rollout_date_lower not in feature.public_disclosure_date.lower():
+                continue
+
+        # Preview date filter (partial match against publicPreviewDate)
+        if preview_date_lower:
+            if not feature.public_preview_date or preview_date_lower not in feature.public_preview_date.lower():
+                continue
+
         # Keyword search (title + description)
         if query_lower:
             if (
@@ -123,6 +171,19 @@ async def search_roadmap(
             except (ValueError, TypeError):
                 continue
 
+        # Recency filter (modified_within_days)
+        if modified_cutoff is not None:
+            if not feature.modified:
+                continue
+            try:
+                modified_dt = datetime.fromisoformat(feature.modified)
+                if modified_dt.tzinfo is None:
+                    modified_dt = modified_dt.replace(tzinfo=timezone.utc)
+                if modified_dt < modified_cutoff:
+                    continue
+            except (ValueError, TypeError):
+                continue
+
         matched.append(feature)
 
     # Build filters summary
@@ -138,6 +199,17 @@ async def search_roadmap(
     if added_within_days is not None:
         filters_applied["added_within_days"] = added_within_days
         filters_applied["cutoff_date"] = cutoff.isoformat()
+    if modified_within_days is not None:
+        filters_applied["modified_within_days"] = modified_within_days
+        filters_applied["modified_cutoff_date"] = modified_cutoff.isoformat()
+    if release_phase:
+        filters_applied["release_phase"] = release_phase
+    if platform:
+        filters_applied["platform"] = platform
+    if rollout_date:
+        filters_applied["rollout_date"] = rollout_date
+    if preview_date:
+        filters_applied["preview_date"] = preview_date
     if not filters_applied:
         filters_applied["note"] = "No filters applied, returning most recent features"
 

{m365_roadmap_mcp-0.2.1.dist-info → m365_roadmap_mcp-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: m365-roadmap-mcp
-Version: 0.2.1
+Version: 0.3.0
 Summary: MCP server for querying the Microsoft 365 Roadmap
 Project-URL: Homepage, https://github.com/jonnybottles/M365-roadmap-mcp-server
 Project-URL: Repository, https://github.com/jonnybottles/M365-roadmap-mcp-server
@@ -24,6 +24,8 @@ Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: pytest-asyncio; extra == 'dev'
 Description-Content-Type: text/markdown
 
+### Disclaimer: This is an independent, self-built project and is not an official Microsoft tool or service.
+
 # M365 Roadmap MCP Server
 
 <!-- mcp-name: io.github.jonnybottles/m365-roadmap -->

m365_roadmap_mcp-0.3.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+m365_roadmap_mcp/__init__.py,sha256=ydNG2ztexAZvnKchX4y1FnQ_atvfc1WGa4E8Y45lPjk,96
+m365_roadmap_mcp/__main__.py,sha256=D9mYXV4TlB361LHfDDwvxsybz0_7EUsseJ3pZkS9AOo,84
+m365_roadmap_mcp/server.py,sha256=jO47eBfPs8SOYySjs9WUR2u4NXChW_I4iCOOQdEjg9A,2785
+m365_roadmap_mcp/feeds/__init__.py,sha256=mVerRhM3n8iwoiupqp4rhqOGOpR2WbtA6MErj5pLG3g,38
+m365_roadmap_mcp/feeds/m365_api.py,sha256=Elkx_4N42H8v-b93Y9jbt5y2zq6jB8gbWZAjQ3dwWVA,2594
+m365_roadmap_mcp/models/__init__.py,sha256=Ml_sDvBRyK40Pq4Of0pDExGEBTjyh0QWB4VLu_zKkks,112
+m365_roadmap_mcp/models/feature.py,sha256=XZlFbwR5s3Unq4JylOQ9YbJv6KLRxldFyDwZGjytK_M,2302
+m365_roadmap_mcp/tools/__init__.py,sha256=nsNOC46HR1ElncjDck0CjOyeCkh1ZugH8YOiaCg_4dE,34
+m365_roadmap_mcp/tools/cloud.py,sha256=NuvztbKyMLc9pKZYD98kih23e09dAKnAeaEXZig2ky0,2562
+m365_roadmap_mcp/tools/details.py,sha256=jgIpi1BhraHPuMT9tQi3d8ikvLF0EZR7p_D7spNlWL0,1067
+m365_roadmap_mcp/tools/recent.py,sha256=Y9I5SS0I2MsV0i98QKtzXrL14AF5yfEyC3f6RiAxj-g,1709
+m365_roadmap_mcp/tools/search.py,sha256=Baoh9Gc7XsBlrsTXIoN_KVPYmEnW6ExMva9Wqad6kg8,9344
+m365_roadmap_mcp-0.3.0.dist-info/METADATA,sha256=ZRUqG71qDlw4uZTAwwIwfYZtamgYBSuUnnT04vCJJFs,7502
+m365_roadmap_mcp-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+m365_roadmap_mcp-0.3.0.dist-info/entry_points.txt,sha256=GNzyIHa06s1_7BMZzkI4Dsury7aBgUmOYiSXFGNgE6M,66
+m365_roadmap_mcp-0.3.0.dist-info/licenses/LICENSE,sha256=NNt5lEWzqGxqVCVmj-VEeWFxXhtbgCNwFhYcCUffWDI,1071
+m365_roadmap_mcp-0.3.0.dist-info/RECORD,,

m365_roadmap_mcp-0.2.1.dist-info/RECORD

@@ -1,14 +0,0 @@
-m365_roadmap_mcp/__init__.py,sha256=ydNG2ztexAZvnKchX4y1FnQ_atvfc1WGa4E8Y45lPjk,96
-m365_roadmap_mcp/__main__.py,sha256=D9mYXV4TlB361LHfDDwvxsybz0_7EUsseJ3pZkS9AOo,84
-m365_roadmap_mcp/server.py,sha256=U-vSRQjxmQVpySifzbPFM_eHdZn0cmYygZnoZWeDW0E,2181
-m365_roadmap_mcp/feeds/__init__.py,sha256=mVerRhM3n8iwoiupqp4rhqOGOpR2WbtA6MErj5pLG3g,38
-m365_roadmap_mcp/feeds/m365_api.py,sha256=MXvPGxRaE1EIyGYQCF6F94CGarz4qvGoIS6b_yD5t0Y,2058
-m365_roadmap_mcp/models/__init__.py,sha256=Ml_sDvBRyK40Pq4Of0pDExGEBTjyh0QWB4VLu_zKkks,112
-m365_roadmap_mcp/models/feature.py,sha256=NDKZpq4xcWBaujSaI3H7npXTO03Bh4y2BCY5vc4ZUH0,1672
-m365_roadmap_mcp/tools/__init__.py,sha256=nsNOC46HR1ElncjDck0CjOyeCkh1ZugH8YOiaCg_4dE,34
-m365_roadmap_mcp/tools/search.py,sha256=yKfWtQ1LzPJSa96OlM8PQBkbDzuW6SPVjmCLAWtFa9U,5817
-m365_roadmap_mcp-0.2.1.dist-info/METADATA,sha256=p_WX6PvRNjlvleOWhDRViZI1NNZcUXjdPdenICCqT54,7392
-m365_roadmap_mcp-0.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-m365_roadmap_mcp-0.2.1.dist-info/entry_points.txt,sha256=GNzyIHa06s1_7BMZzkI4Dsury7aBgUmOYiSXFGNgE6M,66
-m365_roadmap_mcp-0.2.1.dist-info/licenses/LICENSE,sha256=NNt5lEWzqGxqVCVmj-VEeWFxXhtbgCNwFhYcCUffWDI,1071
-m365_roadmap_mcp-0.2.1.dist-info/RECORD,,