Skip to content

Sync docs/2026-07-28-release with main#3059

Merged
localden merged 176 commits into
docs/2026-07-28-releasefrom
claude/sync-docs-release-with-main
Jul 10, 2026
Merged

Sync docs/2026-07-28-release with main#3059
localden merged 176 commits into
docs/2026-07-28-releasefrom
claude/sync-docs-release-with-main

Conversation

@claude

@claude claude Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Requested by Den Delimarsky · Slack thread

Before: the docs/2026-07-28-release branch last merged main on 2026-06-03 and predates the authorization spec split, so work anchored to it targets the old monolithic docs/specification/draft/basic/authorization.mdx. After: the branch carries main's current state — including the split of the authorization spec into docs/specification/draft/basic/authorization/ (index.mdx, authorization-server-discovery.mdx, client-registration.mdx, security-considerations.mdx) — unblocking re-anchored work for #3054. Unblocks #3054.

Notable incoming changes (146 files, +5030/−3326):

  • Authorization spec split: docs/specification/draft/basic/authorization.mdx replaced by the four-file authorization/ directory
  • Basic-spec reorg: basic/utilities/ and basic/patterns.mdx consolidated into basic/patterns/ (cancellation, progress, subscriptions, MRTR)
  • Community docs restructure: charters moved into docs/community/interest-groups/ and docs/community/working-groups/, plus new interest-group pages (auth, security, financial services, primitive grouping, enterprise-managed authorization)
  • New docs/docs/develop/build-client.mdx tutorial and expanded security best practices
  • Draft schema updates (schema/draft/schema.ts / schema.json and example fixtures) with regenerated schema.mdx pages, and streamable-HTTP transport doc updates
  • Repo policy files: AI_POLICY.md, SECURITY.md, CODE_OF_CONDUCT.md, CONTRIBUTING/AGENTS updates
  • SDK betas blog post and enterprise-managed-auth blog post

Conflicts: none — the merge completed cleanly with no manual resolution needed.

Checks: check:docs:links passes. check:docs:format reports 8 files with prettier issues, all byte-identical to main (pre-existing there, not introduced by this merge).


Generated by Claude Code

devcrocod and others added 30 commits April 2, 2026 18:49
The "Sampling" link in each architecture overview pointed at
/specification/<version>/client, which has no index page and is not a route
(only /client/sampling, /client/roots, /client/elicitation exist). Point it at
/specification/<version>/client/sampling, matching the link text. Applied across
all five spec versions (2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, draft).

Also fix two extension overviews (apps, tasks) that linked the "core MCP
specification" to /specification, which has no index/redirect. Point them at
/specification/latest, the version-agnostic spec landing redirect.
Codifies the existing #auth-ig as a chartered Interest Group following
the community charter template. Documents scope, facilitators, biweekly
cadence, the WG-incubation process, and the six Working Groups proposed
to date.
[Bug Fix] make server/discover support caching
The message patterns reorg (ea7c32a) accidentally dropped the
Transports group from the draft Base Protocol navigation, orphaning
the stdio and Streamable HTTP transport pages.
dependabot Bot and others added 17 commits June 29, 2026 16:01
Bumps [eslint](https://github.com/eslint/eslint) from 10.5.0 to 10.6.0.
- [Release notes](https://github.com/eslint/eslint/releases)
- [Commits](eslint/eslint@v10.5.0...v10.6.0)

---
updated-dependencies:
- dependency-name: eslint
  dependency-version: 10.6.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
* build(deps-dev): bump prettier from 3.8.4 to 3.9.3

Bumps [prettier](https://github.com/prettier/prettier) from 3.8.4 to 3.9.3.
- [Release notes](https://github.com/prettier/prettier/releases)
- [Changelog](https://github.com/prettier/prettier/blob/main/CHANGELOG.md)
- [Commits](prettier/prettier@3.8.4...3.9.3)

---
updated-dependencies:
- dependency-name: prettier
  dependency-version: 3.9.1
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>

* Reformat schema and SEP files for prettier 3.9

:house: Remote-Dev: homespace

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Den Delimarsky <[email protected]>
…l-decouple

spec: decouple Mcp-Param-* header emission from schema TTL
Add an Appeals section to CODE_OF_CONDUCT.md pointing to the new
[email protected] Google Group, an out-of-band email
channel for appealing enforcement actions (including org-level GitHub
bans). The group was stood up in modelcontextprotocol/access#123.
* Add blog post announcing Python and TypeScript SDK betas for 2026-07-28

:house: Remote-Dev: homespace

* Tighten blog post wording

:house: Remote-Dev: homespace

* Correct validation window and mention upcoming Go and C# SDK betas

:house: Remote-Dev: homespace

* Make SDK betas post developer-focused

Rework the announcement around what server implementers need: a
compatibility section up front, runnable install and migration steps
for both SDKs, links to the RC and transports posts for context, and
pointers to the SDK documentation sites and migration guides. Correct
the SEP-2577 deprecation scope and clarify the TypeScript wire opt-in.

:house: Remote-Dev: homespace

* Cover Go and C# betas alongside Python and TypeScript

All four Tier 1 SDKs now have pre-releases implementing 2026-07-28:
Go v1.7.0-pre.1 and C# 2.0.0-preview.1 join the Python and TypeScript
betas. Add a section with install commands, the Go stateless HTTP
opt-in, and links to release notes and docs sites; update the title,
intro, issue trackers, and pinning advice accordingly.

:house: Remote-Dev: homespace

* Add Felix Weinberger and Max Isbey to byline

:house: Remote-Dev: homespace

* Update blog/content/posts/2026-06-29-sdk-betas-for-2026-07-28.md

Co-authored-by: kfang-ant <[email protected]>

* Update blog/content/posts/2026-06-29-sdk-betas-for-2026-07-28.md

Co-authored-by: kfang-ant <[email protected]>

* Update blog/content/posts/2026-06-29-sdk-betas-for-2026-07-28.md

Co-authored-by: kfang-ant <[email protected]>

* Restructure compatibility section and move protocol summary before SDK details

Address review feedback: frame the betas as test-and-feedback releases
with stable versions recommended for production, spell out why trying a
beta is safe (opt-in at install and on the wire), and end with concrete
steps for library authors. Move the SEP summary ahead of the per-SDK
sections so readers see what changed before the language-specific
install instructions.

:house: Remote-Dev: homespace

* Add stack diagram and align SDK betas post with amplification messaging

- Add stack.svg showing spec -> SDKs -> clients/servers layering
- Lead intro with 'stateless' and Python/TypeScript v2
- Standardize on 'v2' (drop mixed '2.0' in prose)
- Rename feedback section to 'Tell us what breaks'
- Reflow prose to ~100 chars and fix typos

* Refine SDK betas post title and feedback section

- Retitle to 'Beta SDKs for the 2026-07-28 MCP Spec Release Candidate Are Here'
- Restore 'Give us your feedback' section heading
- Separate spec-repo pointer from the C# issue-tracker bullet

* Style "+ more" SDK tile as full-size hatched block

* Update author bylines to per-SDK lead titles

---------

Co-authored-by: kfang-ant <[email protected]>
* Correct several claims in the SDK betas post

- Scope the "resolves to a stable version" install claim to Python, Go,
  and C#: the TypeScript v2 packages are new package names with no
  stable release, so installing them is itself the beta opt-in.
- State that Python and C# servers pick up the new revision on upgrade,
  in contrast to the TypeScript/Go transport-level opt-in.
- Note that the v2 SDK lines are new major versions with breaking
  changes, separate from anything that happens on July 28.
- Python: the decorator API carries over from v1's FastMCP; drop the
  "API got smaller" and "can now be implemented" framing.
- Mcp-Name rides only on requests that name a tool, resource, or
  prompt, not on every request.
- Soften the claim that every release's notes list exactly which SEPs
  are covered.
- Use https for the MRTR link.
- Move the post date to the actual publish date.

* Keep the original post date
Wire up the slash-commands action's new dependabot-auto-approve mode:

- Add pull_request_target types opened/reopened and a check_suite
  completed trigger (gated to dependabot/ branches at the job level so
  suites on other branches don't start a run)
- Pass dependabot-auto-approve: dev-patch-minor and the explicit file
  allow-list (package.json, package-lock.json)

Dependabot PRs that update direct dev dependencies by patch/minor
versions, touch only the lockfile pair, carry verified
dependabot-authored commits, and have green CI get approved and
auto-merged by mcp-commander. Everything else still requires /lgtm.


Claude-Session: https://claude.ai/code/session_019ygNtiNcAaqTRnQjHCDkVS

Co-authored-by: Claude <[email protected]>
Bumps [tsx](https://github.com/privatenumber/tsx) from 4.22.4 to 4.23.0.
- [Release notes](https://github.com/privatenumber/tsx/releases)
- [Changelog](https://github.com/privatenumber/tsx/blob/master/release.config.cjs)
- [Commits](privatenumber/tsx@v4.22.4...v4.23.0)

---
updated-dependencies:
- dependency-name: tsx
  dependency-version: 4.23.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [prettier](https://github.com/prettier/prettier) from 3.9.3 to 3.9.4.
- [Release notes](https://github.com/prettier/prettier/releases)
- [Changelog](https://github.com/prettier/prettier/blob/main/CHANGELOG.md)
- [Commits](prettier/prettier@3.9.3...3.9.4)

---
updated-dependencies:
- dependency-name: prettier
  dependency-version: 3.9.4
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
* build(deps-dev): bump typedoc from 0.28.19 to 0.28.20

Bumps [typedoc](https://github.com/TypeStrong/TypeDoc) from 0.28.19 to 0.28.20.
- [Release notes](https://github.com/TypeStrong/TypeDoc/releases)
- [Changelog](https://github.com/TypeStrong/typedoc/blob/master/CHANGELOG.md)
- [Commits](TypeStrong/typedoc@v0.28.19...v0.28.20)

---
updated-dependencies:
- dependency-name: typedoc
  dependency-version: 0.28.20
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Regenerate schema docs for typedoc 0.28.20

typedoc 0.28.20's updated JSX renderer emits whitespace between adjacent
block-level HTML tags, changing the generated schema.mdx output. Regenerated
via npm run generate:schema:md so check:schema:md passes.

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Claude <[email protected]>
* docs: update Goose documentation links

* docs: format Goose links table
@github-actions github-actions Bot added documentation Improvements or additions to documentation blog labels Jul 10, 2026
@github-actions

github-actions Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Preview

Preview deployments for this PR have been cleaned up.

@localden
localden marked this pull request as ready for review July 10, 2026 00:47
@localden
localden requested review from a team, dsp-ant and localden as code owners July 10, 2026 00:47
@localden
localden enabled auto-merge (squash) July 10, 2026 00:50
@localden
localden merged commit a60bd7a into docs/2026-07-28-release Jul 10, 2026
14 checks passed
@localden
localden deleted the claude/sync-docs-release-with-main branch July 10, 2026 00:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

blog documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.