Skip to content

docs: add WebMCP docs#68756

Open
dgp1130 wants to merge 1 commit into
angular:mainfrom
dgp1130:webmcp-docs
Open

docs: add WebMCP docs#68756
dgp1130 wants to merge 1 commit into
angular:mainfrom
dgp1130:webmcp-docs

Conversation

@dgp1130
Copy link
Copy Markdown
Contributor

@dgp1130 dgp1130 commented May 16, 2026

This provides some documentation for initial WebMCP features in the upcoming v22 release.

Some decisions made in the process which reviewers are welcome to contest:

  • I put this under the "Build with AI" header, which makes it visible without an expando. That honestly might be too much visibility given how experimental this all is, but there's no other category to put it under, so I think that's the best we can do now.
  • I tried to give a little bit of context about the intended use case without going into many specifics (ex. you need to sign up to get access to Chrome's documentation) or distracting from the overall doc. Ultimately this isn't a great explanation of WebMCP as a whole or the broader story around that, but I think that's a higher-level discussion than this particular doc can drive.
  • I didn't get into the nuances of the input schema (ex. what types are allowed, what validators/constraints are allowed) as that seemed a bit out of scope for Angular and even I don't know the full scope of the edge cases. Hopefully as the spec matures we'll be able to link to other quality resources about those concepts.
  • I didn't expand on the return type both because I don't have a ton of visibility into what is supported and also because I think it goes somewhat out of scope of Angular.
  • I suspect some users might get tripped up by the fact that execute is an async function running in an injection context, meaning inject works before an await, but not after it. This is an existing hazard of async functions in injection contexts, so I didn't call it out specifically.

@dgp1130 dgp1130 added action: review The PR is still awaiting reviews from at least one requested reviewer target: rc This PR is targeted for the next release-candidate area: docs Related to the documentation core: webmcp Issues/PRs related to Angular's WebMCP support in `@angular/core`. labels May 16, 2026
@ngbot ngbot Bot added this to the Backlog milestone May 16, 2026
Comment thread adev/src/content/ai/webmcp.md Outdated
Comment thread adev/src/content/ai/webmcp.md Outdated
@SkyZeroZx
Copy link
Copy Markdown
Contributor

SkyZeroZx commented May 16, 2026

I suspect some users might get tripped up by the fact that execute is an async function running in an injection context, meaning inject works before an await, but not after it. This is an existing hazard of async functions in injection contexts, so I didn't call it out specifically.

This is similar to what's happening with reactive context currently; I think in that case we could document it in the same way we have in Reactive context and async operations

@dgp1130
Copy link
Copy Markdown
Contributor Author

dgp1130 commented May 16, 2026

This is similar to what's happening with reactive context currently; I think in that case we could document it in the same way we have in Reactive context and async operations

I'm hesitant to duplicate that content here. Maybe the better approach would be refactor the existing content into a more general description and then link to it from both the signals guide and WebMCP?

Adds initial documentation of experimental WebMCP APIs.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 16, 2026

Deployed adev-preview for b9102e7 to: https://ng-dev-previews-fw--pr-angular-angular-68756-adev-prev-h8fj2vqb.web.app

Note: As new commits are pushed to this pull request, this link is updated after the preview is rebuilt.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action: review The PR is still awaiting reviews from at least one requested reviewer adev: preview area: docs Related to the documentation core: webmcp Issues/PRs related to Angular's WebMCP support in `@angular/core`. target: rc This PR is targeted for the next release-candidate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants