# DeltaPulse — Full Documentation for LLMs

> Microsoft 365 Change Intelligence Platform

## About

DeltaPulse (https://deltapulse.app) is a free community platform that aggregates Microsoft 365 Roadmap data and Message Center announcements into a single searchable interface. It serves IT administrators, Microsoft 365 consultants, managed service providers, and enterprise IT teams who need to track and plan for Microsoft 365 changes.

## Data Sources

### Microsoft 365 Roadmap Items
Each roadmap item includes:
- **Title**: Feature name (e.g., "Microsoft Teams: Copilot in Teams meetings")
- **Roadmap ID**: Unique numeric identifier
- **Product/Service**: The Microsoft 365 service (e.g., Microsoft Teams, SharePoint, Exchange Online, Microsoft Entra)
- **Status**: In development, Rolling out, Launched, or Cancelled
- **Platform**: Desktop, Web, Mac, iOS, Android, or combinations
- **Cloud Instance**: Worldwide, GCC, GCC High, DoD, China
- **Release Phase**: General Availability, Preview, Targeted Release
- **Expected Release**: Target month/quarter (AI-extracted deployment months)
- **Description**: Full text description of the feature
- **Change History**: Tracked modifications with previous and new values, timestamps

### Message Center Announcements
Each message center item includes:
- **Title**: Announcement title
- **Message ID**: Unique identifier (e.g., MC1234567)
- **Category**: Plan for Change, Stay Informed, or Prevent or Avoid Issues
- **Services**: Affected Microsoft 365 services
- **Tags**: New feature, Updated message, User impact, Admin impact, Retirement, Major change
- **Severity**: Normal or High
- **Action Required By**: Deadline date if action is needed
- **Summary**: Brief overview
- **Body Content**: Full HTML content with details, timelines, and instructions
- **Change History**: Tracked modifications with timestamps

## URL Structure

- Homepage: https://deltapulse.app/
- Dashboard: https://deltapulse.app/dashboard
- Individual items: https://deltapulse.app/item/{id}
  - Roadmap items use numeric IDs: https://deltapulse.app/item/536578
  - Message Center items use MC-prefixed IDs: https://deltapulse.app/item/MC1253746
- Weekly Digest: https://deltapulse.app/weekly-digest
- Analytics: https://deltapulse.app/analytics
- Timeline: https://deltapulse.app/timeline
- MCP Documentation: https://deltapulse.app/mcp-docs

## MCP Server (Model Context Protocol)

DeltaPulse provides an MCP server for AI assistants and LLMs to query Microsoft 365 change data programmatically.

**Endpoint**: https://deltapulse.app/mcp  
**Protocol**: JSON-RPC 2.0, compatible with Microsoft Copilot Studio, ChatGPT, and Claude.  
**Authentication**: None required.

### Recommended Workflow

1. Call `get_guide` to read usage guidance and best practices
2. Call `get_schema` to understand the data model and available fields
3. Call `list_products` to discover product/service names before searching
4. Call `list_filters` to discover valid filter values (tags, statuses, categories, months)
5. Call `search` with structured filters to find relevant items
6. Call `fetch` to retrieve full details (body content, change history) for specific items

**Dates**: `today` and `yesterday` are UTC calendar days; `last_7_days` and `last_30_days` are rolling windows ending now. Date-filtered responses include `date_window` with the exact start and end.

---

## Available Tools

### get_guide
**Getting Started** — Returns the complete usage guide including golden rules, recommended workflow, query patterns, use cases, and best practices. Call this first to understand how to query DeltaPulse data effectively.

No parameters required.

---

### get_schema
**Data Dictionary** — Returns the data schema for Roadmap items, Message Center items, or both. Describes field names, types, enumerations, and change detection logic so you know exactly what fields are returned by search/list/fetch tools.

Parameters:
- `source` (string, optional): `"roadmap"`, `"messages"`, or `"both"` (default: `"both"`)

---

### list_products
**Discovery** — Returns the available products/services and whether each appears in the Roadmap and Message Center, including new products that appear on items before they have a display-name mapping. Letter case doesn't matter, and common short names also work: `"Teams"` → `"Microsoft Teams"`, `"Exchange"` → `"Exchange Online"`, `"Supply Chain Management"` → `"Dynamics 365 Supply Chain Management"`. An unrecognized name returns an error with suggestions.

Parameters:
- `source` (string, optional): `"all"`, `"roadmap"`, or `"messages"` (default: `"all"`)

---

### list_filters
**Discovery** — Returns available filter values from the database including statuses, tags, categories, severities, and deployment months. Use this to discover valid values before filtering a search.

Note: `status` applies to Roadmap only. `tags`, `category`, `severity`, `isMajorChange` apply to Message Center only. `products`, `dateRange`, and `featured` apply to both.

Parameters:
- `source` (string, optional): `"all"`, `"roadmap"`, or `"messages"` (default: `"all"`)

---

### search
**Search** — Search Microsoft 365 Roadmap and Message Center items with filters. Returns lightweight summaries; use `fetch` for full details including body content and change history.

**Golden Rule**: Use structured filters (products, months, status), NOT free-text queries. Free-text queries often return 0 results.
- WRONG: `search(query: "Teams releasing November 2025")` → 0 results  
- RIGHT: `search(source: "both", products: ["Microsoft Teams"], months: "November 2025")` → results

Parameters:
- `query` (string, optional): Free-text search (searches titles and descriptions)
- `source` (string, optional): `"messages"`, `"roadmap"`, or `"both"` (default: `"both"`)
- `changeType` (string, optional): `"new"`, `"updated"`, or `"all"` (default: `"all"`)
- `products` (array of strings, optional): Filter by product names — use `list_products` for valid values (`services` is accepted as an alias)
- `dateRange` (string, optional): `"today"` and `"yesterday"` are UTC calendar days; `"last_24_hours"`, `"last_48_hours"`, `"last_7_days"`, `"last_30_days"`, and `"last_90_days"` are rolling windows ending now
- `startDate` (string, optional): Custom start date in `YYYY-MM-DD` format
- `endDate` (string, optional): Custom end date in `YYYY-MM-DD` format
- `publishedDate` (string, optional): Single date filter in `YYYY-MM-DD` format
- `months` (string or array, optional): Deployment timeline month(s), e.g., `"December 2025"` or `["December 2025", "January 2026"]`
- `status` (string, optional): Roadmap status — use `list_filters` for valid values
- `actionRequired` (boolean, optional): Filter for Message Center items requiring action
- `category` (string, optional): `"planForChange"`, `"stayInformed"`, or `"preventOrFixIssue"` (Message Center)
- `tags` (array of strings, optional): Filter by tags — use `list_filters` for valid values
- `severity` (string, optional): `"normal"` or `"high"` (Message Center)
- `isMajorChange` (boolean, optional): Filter for major changes only (Message Center)
- `featured` (boolean, optional): Filter for moderator-curated featured items only
- `limit` (integer, optional): Maximum results to return (default: 200)

---

### fetch
**Retrieval** — Fetch complete details for a specific item by ID, including full body content (Message Center bodies describe how users and admins are affected), summary, and change history. Use this after `search` or `list_*` tools to get the full record for items of interest.

- Message Center IDs: with or without `"MC"` prefix (e.g., `"MC123456"` or `"123456"`)
- Roadmap IDs: numeric (e.g., `"12345"`)

Parameters:
- `id` (string, **required**): Item ID to fetch
- `includeChangeHistory` (boolean, optional): Include change history (default: `true`)

---

### list_new_items
**Search** — Get only NEW items first published/created within a date range. Uses `createdDate` for Roadmap and `publishedDate` for Message Center. Returns lightweight summaries; use `fetch` for full details.

Parameters:
- `source` (string, optional): `"messages"`, `"roadmap"`, or `"both"` (default: `"both"`)
- `dateRange` (string, optional): `"today"`, `"yesterday"`, `"last_7_days"`, or `"last_30_days"` (default: `"last_7_days"`); `today` and `yesterday` are UTC calendar days, the others are rolling windows ending now
- `startDate` (string, optional): Custom start date `YYYY-MM-DD` — takes precedence over `dateRange`
- `endDate` (string, optional): Custom end date `YYYY-MM-DD` (default: now)
- `products` (array of strings, optional): Filter by product names
- `limit` (integer, optional): Maximum results (default: 200)

---

### list_updated_items
**Search** — Get only UPDATED items (modified but not new within the date range). Uses `modifiedDate > createdDate` for Roadmap and `lastUpdatedDate > publishedDate` for Message Center. Returns lightweight summaries; use `fetch` for full details.

Parameters:
- `source` (string, optional): `"messages"`, `"roadmap"`, or `"both"` (default: `"both"`)
- `dateRange` (string, optional): `"today"`, `"yesterday"`, `"last_7_days"`, or `"last_30_days"` (default: `"last_7_days"`); `today` and `yesterday` are UTC calendar days, the others are rolling windows ending now
- `startDate` (string, optional): Custom start date `YYYY-MM-DD` — takes precedence over `dateRange`
- `endDate` (string, optional): Custom end date `YYYY-MM-DD` (default: now)
- `products` (array of strings, optional): Filter by product names
- `limit` (integer, optional): Maximum results (default: 200)

---

### list_change_history
**Retrieval** — Recent edits to existing items. Each record lists the fields that changed with their previous and new values; long text shows each changed passage with a few words of context. Newly published items are not change records (use `list_new_items`), and removed items are not tracked.

Parameters:
- `source` (string, optional): `"all"`, `"roadmap"`, or `"messages"` (default: `"all"`)
- `changeType` (string, optional): `"changed"` or `"all"` (default: `"all"`); every record is an edit, so both return the same records
- `days` (integer, optional): Number of days to look back (default: 7)
- `limit` (integer, optional): Maximum records to return (default: 50)

---

### get_digest
**Summary** — Get a digest summary of new and updated Microsoft 365 items. Returns counts and item lists for both Roadmap and Message Center changes, plus `date_window` with the exact start and end. Good starting point to see what's new before drilling into specific items.

Parameters:
- `period` (string, optional): `"today"` (the current UTC calendar day so far) or `"week"` (the rolling past 7 days) (default: `"week"`)

---

## MCP Resources

DeltaPulse also exposes MCP Resources (for clients that support them):

- `deltapulse://products` — canonical product list
- `deltapulse://filters` — available filter values
- `deltapulse://schema/roadmap` — Roadmap data schema
- `deltapulse://schema/messages` — Message Center data schema
- `deltapulse://digest/today` — today's digest
- `deltapulse://digest/week` — weekly digest
- `deltapulse://featured` — moderator-curated featured items
- `deltapulse://prompting-guide` — full AI prompting guide

Clients that do not support MCP Resources can use the `get_guide`, `get_schema`, and `get_digest` tools instead.

---

## Item Page Content

Each item page (https://deltapulse.app/item/{id}) is server-rendered HTML containing:
- Full item title and metadata
- Complete description/body content
- Structured data (JSON-LD) with Schema.org WebPage markup
- Change history with tracked field modifications
- Related service and category information
- Breadcrumb navigation

## Sitemap

All item pages are listed in the sitemap: https://deltapulse.app/sitemap.xml  
The sitemap contains approximately 5,400 URLs with lastmod dates and priority scores.