Document Work IQ MCP retrieve tool and migration

[MSFTgraph-sorceress]

Summary

• Add public-preview guidance for using the Work IQ MCP retrieve tool, including scalar query examples, retrieval strategies, source scoping, SharePoint Embedded support, structured responses, and error handling.
• Add migration guidance from the Copilot Retrieval API, including licensing and billing differences, the planned November 2026 REST availability, SharePoint comparison guidance, and filter roadmap considerations.
• Update the Work IQ MCP overview, tool reference, and table of contents.

Validation

• markdownlint passed for all changed Markdown files.
• cspell passed for all changed Markdown files.
• Interactive Demo link validation passed for all changed Markdown files (12 existing links).
• CleanupUnusedImages.ps1 completed with 0 unused files.
• Full-repository Markdown lint and spell checks were also run; they report pre-existing failures in unrelated documentation files.

Interactive Demo

No retrieve-specific Interactive Demo link was added because a reviewed production experience and canonical generated deep link for this public-preview tool weren't available. Existing Work IQ MCP Interactive Demo links in the changed files were validated successfully.

[MSFTgraph-sorceress]

MSFTgraph-sorceress please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

• (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.

@microsoft-github-policy-service agree

• (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.

@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement

@microsoft-github-policy-service agree company="Microsoft"