microsoft-ai-roundup-mcp
This server lets you search and explore the Microsoft AI Roundup newsletter archive via natural language or keywords.
search_microsoft_ai_roundup: Search the full archive with hybrid, semantic, or keyword modes, returning sourced excerpts with issue number, date, and URL.
get_issue: Retrieve the full content of a specific issue by issue number, or by date (YYYY-MM-DD or YYYY-MM).
list_issues: Browse available issues with optional year/month filtering and pagination.
find_tool_mentions: Discover community tools, GitHub projects, and Microsoft AI products/features mentioned across issues, with optional keyword filtering.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@microsoft-ai-roundup-mcp Search the roundup for announcements about Copilot agents"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Microsoft AI Roundup MCP Server
A Model Context Protocol (MCP) server for searching the archive of Merill's Weekly Microsoft AI Roundup — a curated weekly Substack newsletter by Merill Fernando (with Joanne Hayek) covering Microsoft AI: Copilot, GitHub, Azure AI, M365 AI integrations, and the surrounding ecosystem.
Ask natural-language questions like "When did Copilot get feature X?", "What did the roundup say about Build?", or "Which GitHub projects has it highlighted?" and get sourced answers with issue numbers, dates, and links.
Sister project to entra-news-mcp.
Quick Start
No installation, no API keys, no configuration required:
npx microsoft-ai-roundup-mcpOn first run the server downloads a pre-built search index (SQLite database) from this repo's GitHub Releases and caches it locally. It checks for an updated index at most once every 7 days.
Requires Node.js 22 or later — the server uses Node's built-in
node:sqlitemodule (no native dependencies). Node 20 will not work.
Related MCP server: openresearch-mcp
Client Configuration
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"microsoft-ai-roundup": {
"command": "npx",
"args": ["microsoft-ai-roundup-mcp"]
}
}
}Claude Code
claude mcp add microsoft-ai-roundup -- npx microsoft-ai-roundup-mcpCursor / VS Code / Copilot Studio
{
"mcpServers": {
"microsoft-ai-roundup": {
"command": "npx",
"args": ["-y", "microsoft-ai-roundup-mcp"]
}
}
}Optional: semantic search
Keyword search works with zero configuration. For semantic (meaning-based) search, add an OpenAI API key:
{
"mcpServers": {
"microsoft-ai-roundup": {
"command": "npx",
"args": ["microsoft-ai-roundup-mcp"],
"env": { "OPENAI_API_KEY": "sk-..." }
}
}
}Without a key the server degrades gracefully to keyword-only search.
Tools
Tool | Description |
| Search the full archive with natural language or keywords. Hybrid semantic + keyword search; returns sourced excerpts with issue number, date, and URL. Args: |
| Retrieve the full content of an issue by |
| Browse the archive with optional |
| Find community tools, GitHub projects, and Microsoft AI products/features mentioned across issues, with surrounding context. Optional |
Example queries
"Search the Microsoft AI roundup for Copilot Studio agent announcements"
"Get issue #4 of the Microsoft AI roundup"
"List all roundup issues from May 2026"
"What GitHub projects has the Microsoft AI roundup mentioned?"
How It Works
Substack API (https://msai.ms/api/v1/posts)
│
▼
TypeScript ingestion script (scripts/ingest.ts)
│ weekly GitHub Action — Tuesdays 09:00 UTC
▼
OpenAI text-embedding-3-small embeddings (1536 dims)
│
▼
SQLite via node:sqlite (Node 22 built-in — no native deps)
│
▼
GitHub Release asset: microsoft-ai-roundup.db
│
▼
NPX MCP Server (stdio)
└─ Downloads DB on first run → caches in ~/.microsoft-ai-roundup-mcp/
└─ Re-checks for updates weekly (7-day staleness + tag diff)
└─ In-memory cosine similarity + SQL LIKE keyword searchSearch implementation (honest version): semantic search loads all embedding vectors into memory at startup and ranks by cosine similarity in JavaScript; keyword search uses SQL LIKE (exact phrase first, then per-word fallback). Hybrid mode merges and de-duplicates both result sets. No sqlite-vec, no FTS5 — deliberately simple, and more than adequate at this archive's scale.
Automated Weekly Updates
A GitHub Actions workflow runs every Tuesday at 09:00 UTC (the morning after the newsletter's usual Monday publish). It incrementally ingests any new issues, verifies the database, and publishes it as a new GitHub Release tagged db-YYYY.MM.DD-NNNN. The NPX server picks up the new database automatically within a week (or immediately on a fresh install). A workflow_dispatch trigger provides a manual escape hatch for off-schedule publishes or full rebuilds.
Cache Locations
OS | Path |
Windows |
|
macOS / Linux |
|
Delete the folder to force a fresh download of the latest database.
Local Development / Ingestion
git clone https://github.com/darrenjrobinson/microsoft-ai-roundup-mcp
cd microsoft-ai-roundup-mcp
npm install
npm run build
# Build the search index locally (requires an OpenAI API key for embeddings)
export OPENAI_API_KEY=sk-...
node dist/scripts/ingest.js # full ingest
node dist/scripts/ingest.js --incremental # only new issues
# On Windows there's a PowerShell wrapper:
./scripts/ingest.ps1 -Incremental
# Run the server against your local database
MSAI_ROUNDUP_DB_PATH=./microsoft-ai-roundup.db npx microsoft-ai-roundup-mcpEnvironment variable | Used by | Purpose |
| ingest + server | Embeddings (required for ingest; optional for the server's semantic search) |
| ingest | Output database path (default |
| server | Use a local database instead of downloading from GitHub Releases |
Permissions & Licensing
Newsletter content is © Merill Fernando & Joanne Hayek. This project indexes the freely available public archive via the public Substack API (all posts are free, audience: "everyone") and always links back to the original issues. The code is MIT licensed.
Credits
Newsletter: Merill Fernando & Joanne Hayek — msai.ms
MCP server: Darren Robinson
Sister project: entra-news-mcp for entra.news
Available Tools
4 toolsfind_tool_mentionsA
Find community tools, GitHub projects, and Microsoft AI products/features mentioned in the Microsoft AI Roundup. Returns tool names, descriptions, GitHub URLs, and the issue context where they appeared. Optionally filter by keyword to find tools related to a specific technology or capability.
Inputs: limit, query.
get_issueA
Retrieve the full content of a specific Microsoft AI Roundup issue by issue number or publication date. Returns the complete text of the newsletter with section headings preserved.
Inputs: date, issue_number.
list_issuesA
Browse the Microsoft AI Roundup (msai.ms) archive with optional year/month filtering. Returns a list of issues with title, date, and URL. Use this to discover what issues exist before using get_issue or search_microsoft_ai_roundup.
Inputs: year, limit, month, offset.
search_microsoft_ai_roundupA
Search the full Microsoft AI Roundup (msai.ms) archive using natural language or keywords. Returns sourced excerpts from past issues with issue number, date, and URL. Supports hybrid semantic + keyword search (semantic requires OPENAI_API_KEY). Covers all issues of Merill's weekly Microsoft AI roundup from May 2026 to present.
Inputs: query (required), mode, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool serves a distinct purpose: listing issues, retrieving full content, searching across content, and specifically finding tool mentions. There is no overlap or ambiguity in their roles.
Three tools follow a consistent verb_noun pattern (get_issue, list_issues, find_tool_mentions). The search tool includes the domain name, making it slightly longer but still clear and predictable.
Four tools is well-scoped for a newsletter archive server, covering the core access and search needs without unnecessary bloat.
The set covers browsing, retrieving, searching, and specialized extraction (tool mentions), providing complete lifecycle coverage for read-only access to the newsletter archive. No obvious gaps.
Maintenance
Related MCP Connectors
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Official Microsoft MCP Server to query Microsoft Entra data using natural language
Related MCP Servers
- AlicenseBqualityBmaintenanceMCP server for searching and citing ASTGL (As The Geek Learns) articles about MCP servers, local AI, and AI automation. Provides semantic search, direct Q\&A, and topic browsing across 20 authoritative articles with pre-computed embeddings.387 npmMIT
- AlicenseNot gradedqualityCmaintenanceZero-auth multi-source research MCP server that enables web search, reading URLs, PDFs, GitHub repos, and querying Hacker News, Stack Overflow, Semantic Scholar, and YouTube transcripts without API keys.61 PyPI12Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server that aggregates AI news, academic papers from ArXiv, and trending GitHub repositories from multiple sources, enabling users to fetch, search, and filter recent AI content via natural language.1MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides AI-powered document processing and search capabilities, including PDF summarization, text extraction, metadata retrieval, and web search via Google Custom Search.-