Add "Available in MCP" badge for OpenAPI operations

[nolannbiron]

Adds an "Available in MCP" badge to OpenAPI operations, driven by the x-gitbook-mcp extension.

What

• Operations with x-gitbook-mcp: true show an "Available in MCP" badge next to the title, alongside the existing Deprecated / stability badges.
• When x-gitbook-mcp-url is set, the badge becomes a button that copies the MCP server URL to the clipboard (reusing the existing OpenAPICopyButton).
• x-gitbook-mcp-url resolves with cascade precedence operation → path → root (mirroring getServers), so it can be set once at the spec root and overridden per path or operation.
• The label is localized across all supported locales; the badge uses the mcp icon and an emerald theme consistent with the existing badge styles.

Extensions

Extension	Level	Purpose
x-gitbook-mcp: boolean	operation	Gates whether the badge is shown (per-endpoint).
x-gitbook-mcp-url: string	operation / path / root	Optional MCP server URL; turns the badge into a copy-to-clipboard button.

Demo

Resolves RND-11615.

[linear-code]

RND-11615

[changeset-bot]

🦋 Changeset detected

Latest commit: c4a157a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@gitbook/openapi-parser	Patch
@gitbook/react-openapi	Patch
gitbook	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-1s6ryjxsi-gitbook.vercel.app	✅
Cloudflare	https://47231be3-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-1s6ryjxsi-gitbook.vercel.app/url/gitbook.com/docs	https://47231be3-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-1s6ryjxsi-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://47231be3-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2-cloudflare (Inspect)	👍 Changes approved	2 changed, 1 ignored	Jul 1, 2026, 3:26 PM
customers-v2-vercel (Inspect)	👍 Changes approved	1 changed	Jul 1, 2026, 3:25 PM
v2-cloudflare (Inspect)	👍 Changes approved	2 changed, 2 ignored	Jul 1, 2026, 3:33 PM
v2-vercel (Inspect)	👍 Changes approved	1 changed, 1 ignored	Jul 1, 2026, 3:32 PM

[zenoachtig]

I have some doubts about the placement and understandability of the badge, but let's not block it and iterate as we get feedback on it

[gregberge]

On my side I don't understand why we don't expose everything. If this just for us or for other customers also?

[nolannbiron]

I have some doubts about the placement and understandability of the badge

@zenoachtig Yeah I agree it's not perfect in terms of readability. I've put it in the same row as the other badges, but happy to move it if you have a better idea for this one (or all badges ?)

On my side I don't understand why we don't expose everything. If this just for us or for other customers also?

@gregberge wdym by "expose everything" ? This could be used by anyone who did OpenAPI -> MCP it's pretty specific but it's what we did, I'll document it in our docs