v0.4.0 - API v2 Upgrade

What's Changed

API v2 Migration

• Upgraded from Release Communications API v1 to v2 endpoint
• Response format now uses OData wrapper (value array)
• Fields renamed to match v2 schema:
  • tags → products
  • release_phases → release_rings
  • public_disclosure_date → general_availability_date
  • public_preview_date → preview_availability_date
• Date format changed from "Month CY20XX" to YYYY-MM
• New output fields: availabilities (per-ring schedule), more_info_urls (documentation links)

Repo Cleanup

• Removed unused tool files (details.py, cloud.py, recent.py) — all functionality covered by search_roadmap
• Removed 3 MB test snapshot and example server directory
• Aligned version numbers across all config files

Breaking Changes

• Output field names have changed (see above). Consumers relying on tags, release_phases, public_disclosure_date, or public_preview_date keys must update.
• Date strings are now YYYY-MM format instead of "Month CY20XX".

v0.3.1 - Date Filter Fix and Facets Support

Changes

• Fix: Date filters now support both 'December 2026' and 'December CY2026' formats
• Feature: Added include_facets parameter to discover available filter values (products, platforms, statuses, release phases, cloud instances)
• Docs: Updated documentation with new parameter usage examples

Bug Fixes

• Issue #1: CY date format mismatch causing failed searches
• Rollout date and preview date filters now normalize 'CY' prefix

New Features

• include_facets parameter for taxonomy discovery
• Facets include counts for products, statuses, release_phases, platforms, and cloud_instances
• Use limit=0 with include_facets=True to get only facets

Breaking Changes

None - all changes are backward compatible

v0.3.0: Enhanced Filter Parameters

New Features

Added 5 new filter parameters to the search_roadmap tool:

• release_phase - Filter by release phase (e.g., General Availability, Preview)
• platform - Filter by platform (e.g., Web, iOS, Android, Desktop, Mac)
• rollout_date - Filter by rollout start date (e.g., December CY2026)
• preview_date - Filter by preview availability date
• modified_within_days - Filter features modified within N days (1-365)

Improvements

• API parser now extracts releasePhase, platforms, and publicPreviewDate fields
• All filters support case-insensitive partial matching
• Filters can be combined for complex queries
• Comprehensive test coverage with 45 total tests

Example Usage

Find web features rolling out in December 2026:
result = await search_roadmap(rollout_date="December CY2026", platform="Web", limit=5)

Find recently modified Teams features:
result = await search_roadmap(product="Teams", modified_within_days=30)

Technical Details

• Version bump: 0.2.1 → 0.3.0
• 486 lines added across 7 files
• 23 new tests added
• All tests passing (45/45)

v0.2.1

• Fix mcp-name format in README for MCP Registry compatibility
• Add server.json registry metadata
• Add automated MCP Registry publishing to CI workflow
• Sync version across all files

v0.2.0

What's Changed

Consolidated 4 MCP tools into a single search_roadmap tool.

Breaking Changes

• Removed get_feature_details — use search_roadmap(feature_id="...") instead
• Removed check_cloud_availability — use search_roadmap(cloud_instance="...", feature_id="...") instead; each feature includes cloud_instances in the response
• Removed list_recent_additions — use search_roadmap(added_within_days=30) instead

New

• Added added_within_days parameter to search_roadmap (clamped 1–365) for filtering recently added features
• All existing filters (query, product, status, cloud_instance, feature_id, limit) are unchanged and composable with the new parameter

v0.1.0

Initial release of the M365 Roadmap MCP Server.

Tools

• search_roadmap — Search and filter M365 roadmap features by keyword, product, status, cloud instance, or feature ID
• get_feature_details — Retrieve full metadata for a specific roadmap feature
• check_cloud_availability — Verify feature availability for GCC, GCC High, DoD, and other cloud instances
• list_recent_additions — List features recently added to the roadmap

Install

pip install m365-roadmap-mcp

Or run directly:

uvx m365-roadmap-mcp