m365-roadmap-mcp 0.1.0__tar.gz → 0.2.1__tar.gz

{m365_roadmap_mcp-0.1.0 → m365_roadmap_mcp-0.2.1}/.github/workflows/publish.yml

@@ -27,3 +27,13 @@ jobs:
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Install mcp-publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_linux_amd64.tar.gz" | tar xz mcp-publisher
+
+      - name: Authenticate to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish

{m365_roadmap_mcp-0.1.0 → m365_roadmap_mcp-0.2.1}/.gitignore

@@ -186,7 +186,7 @@ cython_debug/
 #  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
 #  and can be added to the global gitignore or merged into this file. However, if you prefer, 
 #  you could uncomment the following to ignore the entire vscode folder
-# .vscode/
+.vscode/
 
 # Ruff stuff:
 .ruff_cache/
@@ -201,6 +201,10 @@ cython_debug/
 .cursorignore
 .cursorindexingignore
 
+# Claude Code
+.claude/
+CLAUDE.md
+
 # Marimo
 marimo/_static/
 marimo/_lsp/

m365_roadmap_mcp-0.2.1/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.4
+Name: m365-roadmap-mcp
+Version: 0.2.1
+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
+Project-URL: Issues, https://github.com/jonnybottles/M365-roadmap-mcp-server/issues
+Author: Justin Buttler
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agent,gcc,mcp,microsoft-365,roadmap
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: fastmcp
+Requires-Dist: httpx
+Requires-Dist: pydantic
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# M365 Roadmap MCP Server
+
+<!-- mcp-name: io.github.jonnybottles/m365-roadmap -->
+
+A Python-based MCP (Model Context Protocol) server that enables AI agents to query the Microsoft 365 Roadmap programmatically.
+
+## Strategic Rationale
+
+For organizations relying on Microsoft 365, Teams, or SharePoint, the "Roadmap" is the single source of truth for upcoming changes. However, navigating the roadmap website manually is cumbersome and disconnected from technical planning workflows. "When is Copilot coming to GCC High?" is a question that affects multi-million dollar contracts and deployment schedules.
+
+Existing research indicates that while RSS feeds exist, there is no tool that allows an AI agent to structurally query this data to answer complex filtering questions. A "Roadmap Scout" MCP server empowers the Agent to act as a release manager, proactively identifying features that enable new capabilities or threaten existing customizations.
+
+## Prompt Examples
+
+Once connected to an MCP client, you can ask questions like:
+
+1. **Search by product and status**: "What Microsoft Teams features are currently rolling out?"
+2. **Check government cloud availability**: "Is Copilot available for GCC High yet?"
+3. **Find recent additions**: "Show me everything added to the M365 roadmap in the last 30 days"
+4. **Get feature details**: "Tell me more about roadmap feature 534606"
+5. **Government cloud planning**: "My agency is on GCC High. Which OneDrive features can we expect?"
+
+## Installation
+
+### Prerequisites
+
+- **Python 3.11+**
+- An MCP-compatible client (Claude Desktop, Cursor, Claude Code, GitHub Copilot CLI, etc.)
+
+### From PyPI (recommended)
+
+Using `uvx` (requires [uv](https://github.com/astral-sh/uv)):
+
+```bash
+uvx m365-roadmap-mcp
+```
+
+To update to the latest version:
+
+```bash
+uvx m365-roadmap-mcp@latest
+```
+
+Install uv if you don't have it:
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+irm https://astral.sh/uv/install.ps1 | iex
+```
+
+Or install with pip (no uv required):
+
+```bash
+pip install m365-roadmap-mcp
+
+# Update to latest
+pip install --upgrade m365-roadmap-mcp
+```
+## Quick Setup
+
+[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0078d4?style=flat-square&logo=visualstudiocode)](https://vscode.dev/redirect/mcp/install?name=m365-roadmap-mcp&config=%7B%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22uvx%22%2C%20%22args%22%3A%20%5B%22m365-roadmap-mcp%22%5D%7D)
+[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?style=flat-square&logo=cursor)](https://cursor.com/docs/context/mcp)
+[![Install in Claude Code](https://img.shields.io/badge/Install_in-Claude_Code-9b6bff?style=flat-square&logo=anthropic)](https://code.claude.com/docs/en/mcp)
+[![Install in Copilot CLI](https://img.shields.io/badge/Install_in-Copilot_CLI-28a745?style=flat-square&logo=github)](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli)
+
+> **One-click install:** Click VS Code badge for automatic setup (requires `uv` installed)
+> **Manual install:** See instructions below for Cursor, Claude Code, Copilot CLI, or Claude Desktop
+
+## Client Configuration
+
+### Running the server
+
+```bash
+uvx m365-roadmap-mcp
+```
+
+Or if installed with pip:
+
+```bash
+m365-roadmap-mcp
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop MCP config:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+**Using uvx (recommended)**
+
+```json
+{
+  "mcpServers": {
+    "m365-roadmap": {
+      "command": "uvx",
+      "args": ["m365-roadmap-mcp"]
+    }
+  }
+}
+```
+
+**Using installed package**
+
+```json
+{
+  "mcpServers": {
+    "m365-roadmap": {
+      "command": "m365-roadmap-mcp"
+    }
+  }
+}
+```
+
+### Cursor
+
+**Option 1: One-Click Install (Recommended)**
+
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=m365-roadmap-mcp&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJtMzY1LXJvYWRtYXAtbWNwIl19
+```
+
+**Option 2: Manual Configuration**
+
+Add to your Cursor MCP config:
+
+- macOS: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+- Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+
+### Claude Code
+
+```bash
+claude mcp add --transport stdio m365-roadmap -- uvx m365-roadmap-mcp
+```
+
+### GitHub Copilot CLI
+
+Add to `~/.copilot/mcp-config.json`:
+
+```json
+{
+  "mcpServers": {
+    "m365-roadmap": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["m365-roadmap-mcp"]
+    }
+  }
+}
+```
+## Features
+
+Provides a single **`search_roadmap`** tool that handles all M365 roadmap queries. Combine any filters:
+
+- **Keyword search** -- Find features by keyword in title/description
+- **Product filter** -- Filter by product tag (Teams, SharePoint, etc.)
+- **Status filter** -- Filter by status (In development, Rolling out, Launched)
+- **Cloud instance filter** -- Filter by cloud instance (GCC, GCC High, DoD)
+- **Feature lookup** -- Retrieve full metadata for a specific roadmap ID
+- **Recent additions** -- List features added within the last N days
+
+## Data Source
+
+This MCP server pulls data from Microsoft's public roadmap API:
+
+- **API Endpoint:** `https://www.microsoft.com/releasecommunications/api/v1/m365`
+- **Authentication:** None required (public endpoint)
+- **RSS Mirror:** `https://www.microsoft.com/microsoft-365/RoadmapFeatureRSS` (same data, RSS format)
+
+This is the same data that powers the [Microsoft 365 Roadmap website](https://www.microsoft.com/en-us/microsoft-365/roadmap). The legacy endpoint (`roadmap-api.azurewebsites.net`) was retired in March 2025.
+
+### Coverage and Limitations
+
+The API returns approximately **1,900 active features** -- those currently In Development, Rolling Out, or recently Launched. This is a hard cap; older or retired features age out of the API and are no longer returned. The roadmap website may display historical features that are no longer present in the API.
+
+There is no official Microsoft documentation for this API. It is a public, unauthenticated endpoint that the community has reverse-engineered. Microsoft Graph does not expose the public M365 roadmap (Graph's Service Communications API covers tenant-specific Message Center posts and Service Health, which is different data).
+
+---
+
+## License
+
+MIT

m365_roadmap_mcp-0.2.1/README.md

@@ -0,0 +1,185 @@
+# M365 Roadmap MCP Server
+
+<!-- mcp-name: io.github.jonnybottles/m365-roadmap -->
+
+A Python-based MCP (Model Context Protocol) server that enables AI agents to query the Microsoft 365 Roadmap programmatically.
+
+## Strategic Rationale
+
+For organizations relying on Microsoft 365, Teams, or SharePoint, the "Roadmap" is the single source of truth for upcoming changes. However, navigating the roadmap website manually is cumbersome and disconnected from technical planning workflows. "When is Copilot coming to GCC High?" is a question that affects multi-million dollar contracts and deployment schedules.
+
+Existing research indicates that while RSS feeds exist, there is no tool that allows an AI agent to structurally query this data to answer complex filtering questions. A "Roadmap Scout" MCP server empowers the Agent to act as a release manager, proactively identifying features that enable new capabilities or threaten existing customizations.
+
+## Prompt Examples
+
+Once connected to an MCP client, you can ask questions like:
+
+1. **Search by product and status**: "What Microsoft Teams features are currently rolling out?"
+2. **Check government cloud availability**: "Is Copilot available for GCC High yet?"
+3. **Find recent additions**: "Show me everything added to the M365 roadmap in the last 30 days"
+4. **Get feature details**: "Tell me more about roadmap feature 534606"
+5. **Government cloud planning**: "My agency is on GCC High. Which OneDrive features can we expect?"
+
+## Installation
+
+### Prerequisites
+
+- **Python 3.11+**
+- An MCP-compatible client (Claude Desktop, Cursor, Claude Code, GitHub Copilot CLI, etc.)
+
+### From PyPI (recommended)
+
+Using `uvx` (requires [uv](https://github.com/astral-sh/uv)):
+
+```bash
+uvx m365-roadmap-mcp
+```
+
+To update to the latest version:
+
+```bash
+uvx m365-roadmap-mcp@latest
+```
+
+Install uv if you don't have it:
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+irm https://astral.sh/uv/install.ps1 | iex
+```
+
+Or install with pip (no uv required):
+
+```bash
+pip install m365-roadmap-mcp
+
+# Update to latest
+pip install --upgrade m365-roadmap-mcp
+```
+## Quick Setup
+
+[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0078d4?style=flat-square&logo=visualstudiocode)](https://vscode.dev/redirect/mcp/install?name=m365-roadmap-mcp&config=%7B%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22uvx%22%2C%20%22args%22%3A%20%5B%22m365-roadmap-mcp%22%5D%7D)
+[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?style=flat-square&logo=cursor)](https://cursor.com/docs/context/mcp)
+[![Install in Claude Code](https://img.shields.io/badge/Install_in-Claude_Code-9b6bff?style=flat-square&logo=anthropic)](https://code.claude.com/docs/en/mcp)
+[![Install in Copilot CLI](https://img.shields.io/badge/Install_in-Copilot_CLI-28a745?style=flat-square&logo=github)](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli)
+
+> **One-click install:** Click VS Code badge for automatic setup (requires `uv` installed)
+> **Manual install:** See instructions below for Cursor, Claude Code, Copilot CLI, or Claude Desktop
+
+## Client Configuration
+
+### Running the server
+
+```bash
+uvx m365-roadmap-mcp
+```
+
+Or if installed with pip:
+
+```bash
+m365-roadmap-mcp
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop MCP config:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+**Using uvx (recommended)**
+
+```json
+{
+  "mcpServers": {
+    "m365-roadmap": {
+      "command": "uvx",
+      "args": ["m365-roadmap-mcp"]
+    }
+  }
+}
+```
+
+**Using installed package**
+
+```json
+{
+  "mcpServers": {
+    "m365-roadmap": {
+      "command": "m365-roadmap-mcp"
+    }
+  }
+}
+```
+
+### Cursor
+
+**Option 1: One-Click Install (Recommended)**
+
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=m365-roadmap-mcp&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJtMzY1LXJvYWRtYXAtbWNwIl19
+```
+
+**Option 2: Manual Configuration**
+
+Add to your Cursor MCP config:
+
+- macOS: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+- Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+
+### Claude Code
+
+```bash
+claude mcp add --transport stdio m365-roadmap -- uvx m365-roadmap-mcp
+```
+
+### GitHub Copilot CLI
+
+Add to `~/.copilot/mcp-config.json`:
+
+```json
+{
+  "mcpServers": {
+    "m365-roadmap": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["m365-roadmap-mcp"]
+    }
+  }
+}
+```
+## Features
+
+Provides a single **`search_roadmap`** tool that handles all M365 roadmap queries. Combine any filters:
+
+- **Keyword search** -- Find features by keyword in title/description
+- **Product filter** -- Filter by product tag (Teams, SharePoint, etc.)
+- **Status filter** -- Filter by status (In development, Rolling out, Launched)
+- **Cloud instance filter** -- Filter by cloud instance (GCC, GCC High, DoD)
+- **Feature lookup** -- Retrieve full metadata for a specific roadmap ID
+- **Recent additions** -- List features added within the last N days
+
+## Data Source
+
+This MCP server pulls data from Microsoft's public roadmap API:
+
+- **API Endpoint:** `https://www.microsoft.com/releasecommunications/api/v1/m365`
+- **Authentication:** None required (public endpoint)
+- **RSS Mirror:** `https://www.microsoft.com/microsoft-365/RoadmapFeatureRSS` (same data, RSS format)
+
+This is the same data that powers the [Microsoft 365 Roadmap website](https://www.microsoft.com/en-us/microsoft-365/roadmap). The legacy endpoint (`roadmap-api.azurewebsites.net`) was retired in March 2025.
+
+### Coverage and Limitations
+
+The API returns approximately **1,900 active features** -- those currently In Development, Rolling Out, or recently Launched. This is a hard cap; older or retired features age out of the API and are no longer returned. The roadmap website may display historical features that are no longer present in the API.
+
+There is no official Microsoft documentation for this API. It is a public, unauthenticated endpoint that the community has reverse-engineered. Microsoft Graph does not expose the public M365 roadmap (Graph's Service Communications API covers tenant-specific Message Center posts and Service Health, which is different data).
+
+---
+
+## License
+
+MIT

{m365_roadmap_mcp-0.1.0 → m365_roadmap_mcp-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "m365-roadmap-mcp"
-version = "0.1.0"
+version = "0.2.1"
 description = "MCP server for querying the Microsoft 365 Roadmap"
 readme = "README.md"
 license = "MIT"

m365_roadmap_mcp-0.2.1/server.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.jonnybottles/m365-roadmap",
+  "description": "Query the Microsoft 365 Roadmap from AI agents",
+  "title": "M365 Roadmap",
+  "repository": {
+    "url": "https://github.com/jonnybottles/M365-roadmap-mcp-server",
+    "source": "github"
+  },
+  "version": "0.2.1",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "registryBaseUrl": "https://pypi.org",
+      "identifier": "m365-roadmap-mcp",
+      "version": "0.2.1",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

{m365_roadmap_mcp-0.1.0 → m365_roadmap_mcp-0.2.1}/src/m365_roadmap_mcp/__init__.py

@@ -1,3 +1,3 @@
 """M365 Roadmap MCP Server - Query the Microsoft 365 Roadmap via MCP."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"

{m365_roadmap_mcp-0.1.0 → m365_roadmap_mcp-0.2.1}/src/m365_roadmap_mcp/server.py

@@ -8,9 +8,6 @@ from fastmcp import FastMCP
 # Suppress FastMCP's INFO logs to reduce console noise
 logging.getLogger("fastmcp").setLevel(logging.WARNING)
 
-from .tools.cloud import check_cloud_availability
-from .tools.details import get_feature_details
-from .tools.recent import list_recent_additions
 from .tools.search import search_roadmap
 
 # Create the MCP server
@@ -19,23 +16,24 @@ mcp = FastMCP(
     instructions=(
         "Query and search the Microsoft 365 Roadmap for upcoming features, "
         "release dates, and cloud instance availability.\n\n"
-        "Available tools:\n"
-        "- search_roadmap: Find and filter roadmap features by keyword, product, "
-        "status, cloud instance (GCC, GCC High, DoD), or feature ID.\n"
-        "- get_feature_details: Retrieve full metadata for a specific roadmap "
-        "feature by its ID.\n"
-        "- check_cloud_availability: Verify whether a feature is available for a "
-        "specific cloud instance (critical for government/defense clients).\n"
-        "- list_recent_additions: List features recently added to the roadmap "
-        "within a given number of days."
+        "Use the search_roadmap tool with any combination of filters:\n"
+        "- query: keyword search across title and description\n"
+        "- product: filter by product tag (e.g. 'Teams', 'SharePoint')\n"
+        "- 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"
+        "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)."
     ),
 )
 
 # Register tools
 mcp.tool(search_roadmap)
-mcp.tool(get_feature_details)
-mcp.tool(check_cloud_availability)
-mcp.tool(list_recent_additions)
 
 
 def main():

{m365_roadmap_mcp-0.1.0 → m365_roadmap_mcp-0.2.1}/src/m365_roadmap_mcp/tools/search.py

@@ -1,5 +1,7 @@
 """Search tool for querying and filtering M365 Roadmap features."""
 
+from datetime import datetime, timedelta, timezone
+
 from ..feeds.m365_api import fetch_features
 
 
@@ -9,13 +11,15 @@ async def search_roadmap(
     status: str | None = None,
     cloud_instance: str | None = None,
     feature_id: str | None = None,
+    added_within_days: int | None = None,
     limit: int = 10,
 ) -> dict:
     """Search the Microsoft 365 Roadmap for features matching keywords and filters.
 
-    Combines keyword search, product filtering, status filtering, and cloud instance
-    filtering into a single flexible tool. All filter parameters are optional and
-    can be combined. When no filters are provided, returns the most recent features.
+    Combines keyword search, product filtering, status filtering, cloud instance
+    filtering, and recency filtering into a single flexible tool. All filter
+    parameters are optional and can be combined. When no filters are provided,
+    returns the most recent features.
 
     Use this tool to:
     - Browse recent roadmap features (no filters)
@@ -24,6 +28,7 @@ async def search_roadmap(
     - Find features by status (status="In development", "Rolling out", "Launched")
     - 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)
     - Combine any of the above (query="Copilot" + product="Teams" + cloud_instance="GCC")
 
     Args:
@@ -35,6 +40,9 @@ async def search_roadmap(
             e.g. "GCC" matches "GCC", "GCC High" matches "GCC High").
         feature_id: Optional roadmap ID to retrieve a single specific feature.
             When provided, all other filters are ignored.
+        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.
         limit: Maximum number of results to return (default: 10, max: 100).
             Ignored when feature_id is provided.
 
@@ -64,6 +72,12 @@ async def search_roadmap(
     # Clamp limit to reasonable bounds
     limit = max(1, min(limit, 100))
 
+    # Compute recency cutoff if requested
+    cutoff = None
+    if added_within_days is not None:
+        added_within_days = max(1, min(added_within_days, 365))
+        cutoff = datetime.now(timezone.utc) - timedelta(days=added_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
@@ -96,6 +110,19 @@ async def search_roadmap(
             ):
                 continue
 
+        # Recency filter (added_within_days)
+        if cutoff is not None:
+            if not feature.created:
+                continue
+            try:
+                created_dt = datetime.fromisoformat(feature.created)
+                if created_dt.tzinfo is None:
+                    created_dt = created_dt.replace(tzinfo=timezone.utc)
+                if created_dt < cutoff:
+                    continue
+            except (ValueError, TypeError):
+                continue
+
         matched.append(feature)
 
     # Build filters summary
@@ -108,6 +135,9 @@ async def search_roadmap(
         filters_applied["status"] = status
     if cloud_instance:
         filters_applied["cloud_instance"] = cloud_instance
+    if added_within_days is not None:
+        filters_applied["added_within_days"] = added_within_days
+        filters_applied["cutoff_date"] = cutoff.isoformat()
     if not filters_applied:
         filters_applied["note"] = "No filters applied, returning most recent features"