Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

docs: add v4.2.0a3 changelog entries (#6306)

nate nowackf5607e812a85
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 7e57bf706..72db890ca 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -6,6 +6,159 @@ rss: true
tag: NEW
---
+<Update label="v4.2.0a3" description="2026-11-03">
+
+**[v4.2.0a3: A Particular Set of Skills](https://github.com/PrefectHQ/fastmcp/releases/tag/v4.2.0a3)**
+
+FastMCP 4.2.0a3 consolidates skills around `Skill`, `SkillCatalogProvider`, and the new strict `SkillsDirectoryProvider` in `fastmcp.skills.provider`. Directory loading validates each skill before publication, and skills with structured metadata or YAML `allowed-tools` lists are accepted without changing their values. This alpha also fixes stale proxy discovery caches, preserves OpenAPI schema references and explicit null values, and improves client connection recovery. Skills support remains experimental; this prerelease is intended for integration testing. If you import the 4.1 skills providers directly, they keep their behavior in 4.2 and now warn ahead of removal in 4.3. Move directory loading to `from fastmcp.skills.provider import SkillsDirectoryProvider`; its startup errors and the legacy providers' warnings identify folders that need fixing. For a single skill, use `Skill.from_directory(...)` with `SkillCatalogProvider` from `fastmcp.skills.provider`. `Client.list_skill_resources()` remains available for servers without the Skills extension. The old `experimental_skills=True` path redirects to the new provider for the base class and rejects subclasses to preserve access controls. Legacy `Skill` wire-model construction still works with a warning, wire entries retain `isinstance(entry, Skill)` behavior, and existing Pydantic `Skill` fields still validate wire payloads. Use `MCPSkill` for wire entries, annotations, and checks, and `Skill` for authoring. For manifest metadata on resource-only servers, read `skill://<name>/_manifest` with `client.read_resource()` and parse its JSON; `client.get_skill()` requires the Skills extension, while `client.read_skill()` downloads and validates the whole skill. Since a2, `ClientGroup` retains known tool routes after its context exits, OpenAPI tool inputs omit `readOnly` properties, and header and path parameters follow their declared simple serialization style. OAuth consent bindings survive concurrent approvals, exception middleware matches subclasses, and empty logging method filters mean β€œlog nothing.” Thanks to our 46 contributors, including 29 first-time contributors.
+
+### Breaking Changes ⚠️
+* Make Skill a storage-neutral object with folders as one loader by [@zzstoatzz](https://github.com/zzstoatzz) in [#6065](https://github.com/PrefectHQ/fastmcp/pull/6065)
+### Enhancements ✨
+* Rename the resource-era list_skills helper to list_skill_summaries by [@zzstoatzz](https://github.com/zzstoatzz) in [#6051](https://github.com/PrefectHQ/fastmcp/pull/6051)
+* Discover skills through mounted servers by [@zzstoatzz](https://github.com/zzstoatzz) in [#6067](https://github.com/PrefectHQ/fastmcp/pull/6067)
+* Share Prefab renderer resources across equivalent tools by [@jlowin](https://github.com/jlowin), [@fprieto14](https://github.com/fprieto14), and [@keremoktener](https://github.com/keremoktener) in [#6077](https://github.com/PrefectHQ/fastmcp/pull/6077)
+* Export Skill from fastmcp by [@zzstoatzz](https://github.com/zzstoatzz) in [#6071](https://github.com/PrefectHQ/fastmcp/pull/6071)
+* Add skills discovery to ClientGroup by [@zzstoatzz](https://github.com/zzstoatzz) in [#6072](https://github.com/PrefectHQ/fastmcp/pull/6072)
+* Add --skills to fastmcp list by [@zzstoatzz](https://github.com/zzstoatzz) in [#6073](https://github.com/PrefectHQ/fastmcp/pull/6073)
+* Add Client.read_skill and tighten skills docs by [@zzstoatzz](https://github.com/zzstoatzz) in [#6087](https://github.com/PrefectHQ/fastmcp/pull/6087)
+* Verify and export skills with resource-manifest fallback by [@zzstoatzz](https://github.com/zzstoatzz) in [#6086](https://github.com/PrefectHQ/fastmcp/pull/6086)
+* Forward Skills discovery through proxies by [@jakekaplan](https://github.com/jakekaplan) in [#5788](https://github.com/PrefectHQ/fastmcp/pull/5788)
+* Share strict skill snapshot projection by [@zzstoatzz](https://github.com/zzstoatzz) in [#6089](https://github.com/PrefectHQ/fastmcp/pull/6089)
+* Use scoped local tests and leave full suites to CI by [@zzstoatzz](https://github.com/zzstoatzz) in [#6094](https://github.com/PrefectHQ/fastmcp/pull/6094)
+* Share ClientGroup skill client lookup by [@zzstoatzz](https://github.com/zzstoatzz) in [#6101](https://github.com/PrefectHQ/fastmcp/pull/6101)
+* Share filesystem skill supporting-file reads by [@zzstoatzz](https://github.com/zzstoatzz) in [#6102](https://github.com/PrefectHQ/fastmcp/pull/6102)
+* Deliver concurrent triage reviews, draft fixes and mutation proposals by [@zzstoatzz](https://github.com/zzstoatzz) in [#6116](https://github.com/PrefectHQ/fastmcp/pull/6116)
+* Post Marvin's dedupe and too-long comments from workflow steps by [@gaker](https://github.com/gaker) in [#6170](https://github.com/PrefectHQ/fastmcp/pull/6170)
+* Remove the unused triage mutation batch by [@zzstoatzz](https://github.com/zzstoatzz) in [#6208](https://github.com/PrefectHQ/fastmcp/pull/6208)
+* Restore the status site by [@zzstoatzz](https://github.com/zzstoatzz) in [#6216](https://github.com/PrefectHQ/fastmcp/pull/6216)
+* Add agno, Agent Framework, and OpenAI Agents SDK to downstream smoke by [@zzstoatzz](https://github.com/zzstoatzz) in [#6222](https://github.com/PrefectHQ/fastmcp/pull/6222)
+* Close external PRs until their author is assigned again by [@zzstoatzz](https://github.com/zzstoatzz) in [#6227](https://github.com/PrefectHQ/fastmcp/pull/6227)
+* Let private triage sweeps run without the Sol reviewer by [@zzstoatzz](https://github.com/zzstoatzz) in [#6229](https://github.com/PrefectHQ/fastmcp/pull/6229)
+* Add named model tiers to the agentic triage plans by [@zzstoatzz](https://github.com/zzstoatzz) in [#6228](https://github.com/PrefectHQ/fastmcp/pull/6228)
+* Add reproducible public triage leads to backlog dashboard by [@zzstoatzz](https://github.com/zzstoatzz) in [#6293](https://github.com/PrefectHQ/fastmcp/pull/6293)
+* Add a strict SkillsDirectoryProvider to fastmcp.skills.provider by [@zzstoatzz](https://github.com/zzstoatzz) in [#6278](https://github.com/PrefectHQ/fastmcp/pull/6278)
+* Point experimental_skills at the new provider and drop alpha-only skills code by [@zzstoatzz](https://github.com/zzstoatzz) in [#6279](https://github.com/PrefectHQ/fastmcp/pull/6279)
+* Deprecate the 4.1 skills API for removal in 4.3 by [@zzstoatzz](https://github.com/zzstoatzz) in [#6280](https://github.com/PrefectHQ/fastmcp/pull/6280)
+### Security πŸ”’
+* Verify advertised skill frontmatter when reading content by [@zzstoatzz](https://github.com/zzstoatzz) in [#6090](https://github.com/PrefectHQ/fastmcp/pull/6090)
+* Check skill limits before reading directory and remote files by [@zzstoatzz](https://github.com/zzstoatzz) in [#6092](https://github.com/PrefectHQ/fastmcp/pull/6092)
+* fix: preserve _list_query_params in FastMCPProviderResourceTemplate.wrap by [@RS-ITACHI](https://github.com/RS-ITACHI) in [#6130](https://github.com/PrefectHQ/fastmcp/pull/6130)
+* Read composite action inputs from env and pin actions by digest by [@gaker](https://github.com/gaker) in [#6168](https://github.com/PrefectHQ/fastmcp/pull/6168)
+* Scope the /marvin App token to the permissions it uses by [@zzstoatzz](https://github.com/zzstoatzz) in [#6206](https://github.com/PrefectHQ/fastmcp/pull/6206)
+### Fixes 🐞
+* Make the version-check InvalidURL regression independent of proxy parsing by [@HootRock](https://github.com/HootRock) in [#6048](https://github.com/PrefectHQ/fastmcp/pull/6048)
+* Build the Prefab renderer page on read, not on resources/list by [@adam-zovos](https://github.com/adam-zovos) in [#6039](https://github.com/PrefectHQ/fastmcp/pull/6039)
+* Install mounted skills under their own name in sync_skills by [@zzstoatzz](https://github.com/zzstoatzz) in [#6078](https://github.com/PrefectHQ/fastmcp/pull/6078)
+* Stage skill exports before replacing installed files by [@zzstoatzz](https://github.com/zzstoatzz) in [#6091](https://github.com/PrefectHQ/fastmcp/pull/6091)
+* fix: Prefix backend hash addresses with double underscores by [@jlowin](https://github.com/jlowin) and [@BlueX888](https://github.com/BlueX888) in [#6100](https://github.com/PrefectHQ/fastmcp/pull/6100)
+* Rebind pre-4.2 Prefab backend addresses through 4.2 proxies by [@jakekaplan](https://github.com/jakekaplan) in [#6108](https://github.com/PrefectHQ/fastmcp/pull/6108)
+* Isolate and bound triage verification by [@zzstoatzz](https://github.com/zzstoatzz) in [#6109](https://github.com/PrefectHQ/fastmcp/pull/6109)
+* Improve OpenAPI upstream error details by [@zzstoatzz](https://github.com/zzstoatzz) and [@mssaleh](https://github.com/mssaleh) in [#6141](https://github.com/PrefectHQ/fastmcp/pull/6141)
+* Compare JSON const and enum values by JSON equality by [@prassu017](https://github.com/prassu017) and [@alpaylan](https://github.com/alpaylan) in [#6126](https://github.com/PrefectHQ/fastmcp/pull/6126)
+* Bound Skills proxy backend pagination by [@prassu017](https://github.com/prassu017) and [@Yash-Tripath1](https://github.com/Yash-Tripath1) in [#6104](https://github.com/PrefectHQ/fastmcp/pull/6104)
+* fix: forward script arguments in FastMCPStdioTransport by [@KashifManzer](https://github.com/KashifManzer) and [@BlueX888](https://github.com/BlueX888) in [#6119](https://github.com/PrefectHQ/fastmcp/pull/6119)
+* Return invalid params for prompts/get with a missing required argument by [@asasemahmed](https://github.com/asasemahmed) and [@xubenqiang](https://github.com/xubenqiang) in [#6027](https://github.com/PrefectHQ/fastmcp/pull/6027)
+* Fix kept-alive stdio transports ignoring client timeouts by [@HootRock](https://github.com/HootRock) and [@BlueX888](https://github.com/BlueX888) in [#6156](https://github.com/PrefectHQ/fastmcp/pull/6156)
+* perf(schema): skip unnecessary reference sibling restoration by [@andreivince](https://github.com/andreivince) in [#6161](https://github.com/PrefectHQ/fastmcp/pull/6161)
+* fix(cli): prefer Claude Code project servers by [@mikamikasuki](https://github.com/mikamikasuki) in [#5522](https://github.com/PrefectHQ/fastmcp/pull/5522)
+* fix(cli): preserve JSON content block fields by [@mikamikasuki](https://github.com/mikamikasuki) in [#5530](https://github.com/PrefectHQ/fastmcp/pull/5530)
+* Keep schema definitions when hydrating a wrapped tool result by [@asasemahmed](https://github.com/asasemahmed) in [#5927](https://github.com/PrefectHQ/fastmcp/pull/5927)
+* Reject undeclared OpenAPI tool arguments under strict input validation by [@prassu017](https://github.com/prassu017) and [@mssaleh](https://github.com/mssaleh) in [#6140](https://github.com/PrefectHQ/fastmcp/pull/6140)
+* fix(resources): reverse hostless URIs through Namespace unchanged by [@serhiizghama](https://github.com/serhiizghama) and [@andreivince](https://github.com/andreivince) in [#5230](https://github.com/PrefectHQ/fastmcp/pull/5230)
+* fix(openapi): preserve timeouts so the server maps them to the actionable message by [@BlueX888](https://github.com/BlueX888) in [#5847](https://github.com/PrefectHQ/fastmcp/pull/5847)
+* Keep posted review receipts on partial delivery and reject differing reviews by [@zzstoatzz](https://github.com/zzstoatzz) in [#6178](https://github.com/PrefectHQ/fastmcp/pull/6178)
+* Drop client context holds left by finished tasks by [@zzstoatzz](https://github.com/zzstoatzz) in [#6205](https://github.com/PrefectHQ/fastmcp/pull/6205)
+* Let clients with different timeouts share a kept-alive stdio session by [@zzstoatzz](https://github.com/zzstoatzz) in [#6223](https://github.com/PrefectHQ/fastmcp/pull/6223)
+* fix(cli): preserve explicit null in generated tool commands by [@likecake](https://github.com/likecake) in [#6191](https://github.com/PrefectHQ/fastmcp/pull/6191)
+* Honor empty tag inclusion filters in multi-server configs by [@PennEwan](https://github.com/PennEwan) in [#6200](https://github.com/PrefectHQ/fastmcp/pull/6200)
+* fix(mcp-config): reuse one OAuth client per configured server by [@kbkb628](https://github.com/kbkb628) and [@whoskn](https://github.com/whoskn) in [#6097](https://github.com/PrefectHQ/fastmcp/pull/6097)
+* Fix and quiet the triage alerts from 2026-11-02 by [@zzstoatzz](https://github.com/zzstoatzz) in [#6235](https://github.com/PrefectHQ/fastmcp/pull/6235)
+* fix(tasks): send task IDs in routing headers by [@eli-yip](https://github.com/eli-yip) in [#5810](https://github.com/PrefectHQ/fastmcp/pull/5810)
+* fix(middleware): treat an empty methods allowlist as "log nothing" by [@gdut4140](https://github.com/gdut4140) in [#5727](https://github.com/PrefectHQ/fastmcp/pull/5727)
+* Fix namespaced file resource reads while preserving URI normalization by [@BlueLi66](https://github.com/BlueLi66) in [#5716](https://github.com/PrefectHQ/fastmcp/pull/5716)
+* fix(server): pass typed list request messages to list middleware hooks by [@BlueX888](https://github.com/BlueX888) in [#5732](https://github.com/PrefectHQ/fastmcp/pull/5732)
+* Stop OpenAPI end-to-end tests from hitting the network by [@zzstoatzz](https://github.com/zzstoatzz) in [#6249](https://github.com/PrefectHQ/fastmcp/pull/6249)
+* fix(auth): Preserve browser consent bindings across concurrent OAuth approvals by [@mikamikasuki](https://github.com/mikamikasuki) in [#5541](https://github.com/PrefectHQ/fastmcp/pull/5541)
+* fix(openapi): serialize header and path parameters per the simple style by [@Harsh23Kashyap](https://github.com/Harsh23Kashyap) in [#5091](https://github.com/PrefectHQ/fastmcp/pull/5091)
+* Fall back to method and path when an OpenAPI name slugs to nothing by [@asasemahmed](https://github.com/asasemahmed) in [#5699](https://github.com/PrefectHQ/fastmcp/pull/5699)
+* Convert OpenAPI 3.0 boolean exclusive bounds to numeric bounds by [@asasemahmed](https://github.com/asasemahmed) in [#5697](https://github.com/PrefectHQ/fastmcp/pull/5697)
+* Rewrite component refs under not, if/then/else and similar keywords by [@asasemahmed](https://github.com/asasemahmed) in [#5698](https://github.com/PrefectHQ/fastmcp/pull/5698)
+* fix(openapi): keep media-type $defs beside component schemas by [@BlueX888](https://github.com/BlueX888) in [#5709](https://github.com/PrefectHQ/fastmcp/pull/5709)
+* Omit readOnly properties from OpenAPI tool input schemas by [@AarnavNoble](https://github.com/AarnavNoble) in [#5753](https://github.com/PrefectHQ/fastmcp/pull/5753)
+* fix: name root self-references after the generated root class by [@BlueX888](https://github.com/BlueX888) in [#5671](https://github.com/PrefectHQ/fastmcp/pull/5671)
+* fix(proxy): keep stale list results out of cache by [@mikamikasuki](https://github.com/mikamikasuki) in [#5521](https://github.com/PrefectHQ/fastmcp/pull/5521)
+* Match Claude Code project keys by path on Windows by [@zzstoatzz](https://github.com/zzstoatzz) and [@yongpange](https://github.com/yongpange) in [#6240](https://github.com/PrefectHQ/fastmcp/pull/6240)
+* Stop preloading the server before launching the Inspector by [@zzstoatzz](https://github.com/zzstoatzz) and [@mikamikasuki](https://github.com/mikamikasuki) in [#6241](https://github.com/PrefectHQ/fastmcp/pull/6241)
+* Cull expired OAuth state from the default OAuthProxy file store by [@zzstoatzz](https://github.com/zzstoatzz), [@nosmile99](https://github.com/nosmile99), and [@mheidari98](https://github.com/mheidari98) in [#6242](https://github.com/PrefectHQ/fastmcp/pull/6242)
+* Reuse the stdio session after a cancelled startup by [@zzstoatzz](https://github.com/zzstoatzz) and [@mikamikasuki](https://github.com/mikamikasuki) in [#6243](https://github.com/PrefectHQ/fastmcp/pull/6243)
+* Match Gemini function responses to tool-use IDs by [@zzstoatzz](https://github.com/zzstoatzz) and [@mikamikasuki](https://github.com/mikamikasuki) in [#6244](https://github.com/PrefectHQ/fastmcp/pull/6244)
+* Replace parent type keywords when an ArgTransform changes the type by [@zzstoatzz](https://github.com/zzstoatzz), [@syf2211](https://github.com/syf2211), [@HootRock](https://github.com/HootRock), and [@chrikrah](https://github.com/chrikrah) in [#6246](https://github.com/PrefectHQ/fastmcp/pull/6246)
+* Expire idle per-client rate limiters by [@zzstoatzz](https://github.com/zzstoatzz) and [@mikamikasuki](https://github.com/mikamikasuki) in [#6247](https://github.com/PrefectHQ/fastmcp/pull/6247)
+* Match resource templates that spell out a literal query by [@zzstoatzz](https://github.com/zzstoatzz) and [@taltal-beep](https://github.com/taltal-beep) in [#6248](https://github.com/PrefectHQ/fastmcp/pull/6248)
+* fix(openapi): preserve explicit null in nullable JSON body properties by [@mumu-bird](https://github.com/mumu-bird) in [#5633](https://github.com/PrefectHQ/fastmcp/pull/5633)
+* Keep OpenAPI refs that point into a component schema intact by [@zzstoatzz](https://github.com/zzstoatzz) and [@AarnavNoble](https://github.com/AarnavNoble) in [#6245](https://github.com/PrefectHQ/fastmcp/pull/6245)
+* fix(telemetry): record mounted and nested server spans as INTERNAL by [@zzstoatzz](https://github.com/zzstoatzz) and [@sonmaximum](https://github.com/sonmaximum) in [#6252](https://github.com/PrefectHQ/fastmcp/pull/6252)
+* fix(client): identify as fastmcp in clientInfo by default by [@zzstoatzz](https://github.com/zzstoatzz) in [#6254](https://github.com/PrefectHQ/fastmcp/pull/6254)
+* fix(openapi): keep both values when a query object property matches another parameter by [@zzstoatzz](https://github.com/zzstoatzz) and [@alpaylan](https://github.com/alpaylan) in [#6256](https://github.com/PrefectHQ/fastmcp/pull/6256)
+* fix(middleware): map exception subclasses in ErrorHandlingMiddleware by [@zzstoatzz](https://github.com/zzstoatzz) and [@zurmag](https://github.com/zurmag) in [#6257](https://github.com/PrefectHQ/fastmcp/pull/6257)
+* fix(client): report a lost connection instead of 'Client is not connected' by [@zzstoatzz](https://github.com/zzstoatzz) and [@alex-feel](https://github.com/alex-feel) in [#6259](https://github.com/PrefectHQ/fastmcp/pull/6259)
+* fix(client): keep ClientGroup tool routes after the group context exits by [@zzstoatzz](https://github.com/zzstoatzz), [@hntrl](https://github.com/hntrl), and [@YingzuoLiu](https://github.com/YingzuoLiu) in [#6268](https://github.com/PrefectHQ/fastmcp/pull/6268)
+* Accept structured skill metadata and allowed-tools lists by [@jakekaplan](https://github.com/jakekaplan) in [#6292](https://github.com/PrefectHQ/fastmcp/pull/6292)
+* Preserve 4.1 skills type checks and resource-only manifest migration by [@zzstoatzz](https://github.com/zzstoatzz) in [#6305](https://github.com/PrefectHQ/fastmcp/pull/6305)
+### Docs πŸ“š
+* Consolidate skills docs into one Skills over MCP page by [@zzstoatzz](https://github.com/zzstoatzz) in [#6049](https://github.com/PrefectHQ/fastmcp/pull/6049)
+* Rewrite skills docs around Skill and SkillCatalogProvider by [@zzstoatzz](https://github.com/zzstoatzz) in [#6066](https://github.com/PrefectHQ/fastmcp/pull/6066)
+* Tighten skills docs examples by [@zzstoatzz](https://github.com/zzstoatzz) in [#6070](https://github.com/PrefectHQ/fastmcp/pull/6070)
+* Shorten the skills docs page by [@zzstoatzz](https://github.com/zzstoatzz) in [#6079](https://github.com/PrefectHQ/fastmcp/pull/6079)
+* Badge the skills page as 4.2.0 by [@zzstoatzz](https://github.com/zzstoatzz) in [#6083](https://github.com/PrefectHQ/fastmcp/pull/6083)
+* Consolidate skills examples around verified Skill values by [@zzstoatzz](https://github.com/zzstoatzz) in [#6093](https://github.com/PrefectHQ/fastmcp/pull/6093)
+* docs: add v4.2.0a1 changelog entries by [@zzstoatzz](https://github.com/zzstoatzz) in [#6105](https://github.com/PrefectHQ/fastmcp/pull/6105)
+* Add MCP tool annotations to get_file example by [@gl1tchdust](https://github.com/gl1tchdust) in [#5976](https://github.com/PrefectHQ/fastmcp/pull/5976)
+* Fix dead links in current documentation by [@zzstoatzz](https://github.com/zzstoatzz) and [@Wilson0511](https://github.com/Wilson0511) in [#6142](https://github.com/PrefectHQ/fastmcp/pull/6142)
+* docs: rename Horizon to FastMCP Gateway in current docs by [@parkedwards](https://github.com/parkedwards) in [#5653](https://github.com/PrefectHQ/fastmcp/pull/5653)
+* Document strict-mode handling of undeclared OpenAPI arguments by [@zzstoatzz](https://github.com/zzstoatzz) in [#6169](https://github.com/PrefectHQ/fastmcp/pull/6169)
+* docs: add v4.2.0a2 changelog entries by [@zzstoatzz](https://github.com/zzstoatzz) in [#6224](https://github.com/PrefectHQ/fastmcp/pull/6224)
+* docs(settings): explain what FASTMCP_DEBUG actually does by [@zzstoatzz](https://github.com/zzstoatzz) and [@ianw](https://github.com/ianw) in [#6255](https://github.com/PrefectHQ/fastmcp/pull/6255)
+* docs: pass referrers on outbound links, add organization schema and page descriptions by [@madureira-gabriel](https://github.com/madureira-gabriel) in [#6287](https://github.com/PrefectHQ/fastmcp/pull/6287)
+### Other Changes 🦾
+* chore(deps): Update dependency ruff to v0.17.2 by [@prefect-renovate](https://github.com/prefect-renovate) in [#6233](https://github.com/PrefectHQ/fastmcp/pull/6233)
+* chore(deps): Pin dependencies by [@prefect-renovate](https://github.com/prefect-renovate) in [#6064](https://github.com/PrefectHQ/fastmcp/pull/6064)
+## New Contributors
+* @adam-zovos made their first contribution in [#6039](https://github.com/PrefectHQ/fastmcp/pull/6039)
+* @alpaylan made their first contribution in [#6126](https://github.com/PrefectHQ/fastmcp/pull/6126)
+* @BlueLi66 made their first contribution in [#5716](https://github.com/PrefectHQ/fastmcp/pull/5716)
+* @eli-yip made their first contribution in [#5810](https://github.com/PrefectHQ/fastmcp/pull/5810)
+* @fprieto14 made their first contribution in [#6077](https://github.com/PrefectHQ/fastmcp/pull/6077)
+* @gaker made their first contribution in [#6168](https://github.com/PrefectHQ/fastmcp/pull/6168)
+* @gdut4140 made their first contribution in [#5727](https://github.com/PrefectHQ/fastmcp/pull/5727)
+* @gl1tchdust made their first contribution in [#5976](https://github.com/PrefectHQ/fastmcp/pull/5976)
+* @hntrl made their first contribution in [#6268](https://github.com/PrefectHQ/fastmcp/pull/6268)
+* @ianw made their first contribution in [#6255](https://github.com/PrefectHQ/fastmcp/pull/6255)
+* @KashifManzer made their first contribution in [#6119](https://github.com/PrefectHQ/fastmcp/pull/6119)
+* @keremoktener made their first contribution in [#6077](https://github.com/PrefectHQ/fastmcp/pull/6077)
+* @likecake made their first contribution in [#6191](https://github.com/PrefectHQ/fastmcp/pull/6191)
+* @mheidari98 made their first contribution in [#6242](https://github.com/PrefectHQ/fastmcp/pull/6242)
+* @mssaleh made their first contribution in [#6141](https://github.com/PrefectHQ/fastmcp/pull/6141)
+* @mumu-bird made their first contribution in [#5633](https://github.com/PrefectHQ/fastmcp/pull/5633)
+* @nosmile99 made their first contribution in [#6242](https://github.com/PrefectHQ/fastmcp/pull/6242)
+* @PennEwan made their first contribution in [#6200](https://github.com/PrefectHQ/fastmcp/pull/6200)
+* @prassu017 made their first contribution in [#6104](https://github.com/PrefectHQ/fastmcp/pull/6104)
+* @RS-ITACHI made their first contribution in [#6130](https://github.com/PrefectHQ/fastmcp/pull/6130)
+* @serhiizghama made their first contribution in [#5230](https://github.com/PrefectHQ/fastmcp/pull/5230)
+* @sonmaximum made their first contribution in [#6252](https://github.com/PrefectHQ/fastmcp/pull/6252)
+* @taltal-beep made their first contribution in [#6248](https://github.com/PrefectHQ/fastmcp/pull/6248)
+* @whoskn made their first contribution in [#6097](https://github.com/PrefectHQ/fastmcp/pull/6097)
+* @xubenqiang made their first contribution in [#6027](https://github.com/PrefectHQ/fastmcp/pull/6027)
+* @Yash-Tripath1 made their first contribution in [#6104](https://github.com/PrefectHQ/fastmcp/pull/6104)
+* @YingzuoLiu made their first contribution in [#6268](https://github.com/PrefectHQ/fastmcp/pull/6268)
+* @yongpange made their first contribution in [#6240](https://github.com/PrefectHQ/fastmcp/pull/6240)
+* @zurmag made their first contribution in [#6257](https://github.com/PrefectHQ/fastmcp/pull/6257)
+
+**Full Changelog**: [v4.1.6...v4.2.0a3](https://github.com/PrefectHQ/fastmcp/compare/v4.1.6...v4.2.0a3)
+
+</Update>
+
<Update label="v4.2.0a2" description="2026-11-01">
**[v4.2.0a2: Skill Waters Run Deep](https://github.com/PrefectHQ/fastmcp/releases/tag/v4.2.0a2)**
diff --git a/docs/updates.mdx b/docs/updates.mdx
index 67a0e56e0..96f684d2c 100644
--- a/docs/updates.mdx
+++ b/docs/updates.mdx
@@ -6,6 +6,16 @@ icon: "sparkles"
tag: NEW
---
+<Update label="FastMCP 4.2.0a3" description="November 3, 2026" tags={["Releases"]}>
+<Card
+title="FastMCP v4.2.0a3: A Particular Set of Skills"
+href="https://github.com/PrefectHQ/fastmcp/releases/tag/v4.2.0a3"
+cta="Read the release notes"
+>
+FastMCP 4.2.0a3 consolidates skills around `Skill`, `SkillCatalogProvider`, and the new strict `SkillsDirectoryProvider` in `fastmcp.skills.provider`. Directory loading validates each skill before publication, and skills with structured metadata or YAML `allowed-tools` lists are accepted without changing their values. This alpha also fixes stale proxy discovery caches, preserves OpenAPI schema references and explicit null values, and improves client connection recovery. Skills support remains experimental; this prerelease is intended for integration testing. If you import the 4.1 skills providers directly, they keep their behavior in 4.2 and now warn ahead of removal in 4.3. Move directory loading to `from fastmcp.skills.provider import SkillsDirectoryProvider`; its startup errors and the legacy providers' warnings identify folders that need fixing. For a single skill, use `Skill.from_directory(...)` with `SkillCatalogProvider` from `fastmcp.skills.provider`. `Client.list_skill_resources()` remains available for servers without the Skills extension. The old `experimental_skills=True` path redirects to the new provider for the base class and rejects subclasses to preserve access controls. Legacy `Skill` wire-model construction still works with a warning, wire entries retain `isinstance(entry, Skill)` behavior, and existing Pydantic `Skill` fields still validate wire payloads. Use `MCPSkill` for wire entries, annotations, and checks, and `Skill` for authoring. For manifest metadata on resource-only servers, read `skill://<name>/_manifest` with `client.read_resource()` and parse its JSON; `client.get_skill()` requires the Skills extension, while `client.read_skill()` downloads and validates the whole skill. Since a2, `ClientGroup` retains known tool routes after its context exits, OpenAPI tool inputs omit `readOnly` properties, and header and path parameters follow their declared simple serialization style. OAuth consent bindings survive concurrent approvals, exception middleware matches subclasses, and empty logging method filters mean β€œlog nothing.” Thanks to our 46 contributors, including 29 first-time contributors.
+</Card>
+</Update>
+
<Update label="FastMCP 4.2.0a2" description="November 1, 2026" tags={["Releases"]}>
<Card
title="FastMCP v4.2.0a2: Skill Waters Run Deep"