FastMCP 4.2 serves agent skills from the server. A skill used to live in a folder on each machine, so every agent kept its own copy and an update meant asking everyone to reinstall. Now the server holds one copy next to the tools the skill describes, and a deploy updates every agent that reads it.
from fastmcp import FastMCP, Skill
from fastmcp.skills.provider import SkillCatalogProvider
deploy = Skill.from_directory("skills/deploy")
mcp = FastMCP("Team Skills")
mcp.add_provider(SkillCatalogProvider([deploy]))
Any client can read a skill's files as ordinary resources. Clients that speak the experimental Skills extension also get skills/list, with a hashed manifest for each skill. Few hosts support it yet, so FastMCP's client fills in: Client.read_skill() checks every file's size and digest, and to_directory() installs a skill into an agent's local skills folder. Skills work with the rest of FastMCP: they're namespaced under mounts, pass through proxies, list across a ClientGroup, and respect AuthMiddleware. The skills docs cover the details.
Dependencies can now be declared in the annotation, as in Annotated[dict, Depends(get_config)], so the parameter keeps its real type, and a dependency can own the tool argument it reads through CallArgument. The rest of the release is fixes across OpenAPI, proxies, auth, telemetry and tasks. Thirteen community PRs merged during the cycle were reverted before release and are not listed here.
Before upgrading
- Python 3.11 or newer is required.
- The 4.1 skills API is deprecated and will be removed in 4.3. The old providers in
fastmcp.server.providers.skills and helpers in fastmcp.utilities.skills still work and warn with their replacement. The skills docs include a migration table.
Skill is now the class you author with. The wire model that used that name is MCPSkill; the old import works until 4.3.
Thanks to our 120 contributors, including 46 first-time contributors.
<details>
<summary>Every change in this release</summary>
<!-- Release notes generated using configuration in .github/release.yml at main -->
Breaking Changes ⚠️
- Make Skill a storage-neutral object with folders as one loader by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6065
- Require Python 3.11 by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6377
Enhancements ✨
- Rename the resource-era list_skills helper to list_skill_summaries by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6051
- Discover skills through mounted servers by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6067
- Share Prefab renderer resources across equivalent tools by @jlowin, @fprieto14, and @keremoktener in https://github.com/PrefectHQ/fastmcp/pull/6077
- Export Skill from fastmcp by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6071
- Add skills discovery to ClientGroup by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6072
- Add --skills to fastmcp list by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6073
- Add Client.read_skill and tighten skills docs by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6087
- Verify and export skills with resource-manifest fallback by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6086
- Forward Skills discovery through proxies by @jakekaplan in https://github.com/PrefectHQ/fastmcp/pull/5788
- Share strict skill snapshot projection by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6089
- Use scoped local tests and leave full suites to CI by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6094
- Share ClientGroup skill client lookup by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6101
- Share filesystem skill supporting-file reads by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6102
- Deliver concurrent triage reviews, draft fixes and mutation proposals by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6116
- Post Marvin's dedupe and too-long comments from workflow steps by @gaker in https://github.com/PrefectHQ/fastmcp/pull/6170
- Remove the unused triage mutation batch by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6208
- Restore the status site by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6216
- Add agno, Agent Framework, and OpenAI Agents SDK to downstream smoke by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6222
- Close external PRs until their author is assigned again by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6227
- Let private triage sweeps run without the Sol reviewer by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6229
- Add named model tiers to the agentic triage plans by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6228
- Add reproducible public triage leads to backlog dashboard by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6293
- Add a strict SkillsDirectoryProvider to fastmcp.skills.provider by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6278
- Point experimental_skills at the new provider and drop alpha-only skills code by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6279
- Deprecate the 4.1 skills API for removal in 4.3 by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6280
- Add app restart to the smart home Fire TV example by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6356
- Add a workflow that deploys agentic triage to Prefect Cloud by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6380
- Support Annotated dependencies by @zzstoatzz and @Kludex in https://github.com/PrefectHQ/fastmcp/pull/6378
- Post triage outcomes instead of run starts, and skip maintainer events by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6382
- Support npm_config_registry override in fastmcp dev apps by @Abhi2939 and @ezz3r in https://github.com/PrefectHQ/fastmcp/pull/5969
- Bump the conformance pin to 0.2.0-alpha.12 and check it weekly by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6424
- Make background task execution TTL configurable by @zzstoatzz and @carterthayer in https://github.com/PrefectHQ/fastmcp/pull/6428
- Drop --isolated from the ty pre-commit hook by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6430
- Set gen_ai.operation.name on tools/call spans by @zzstoatzz, @swantzter, and @CaselIT in https://github.com/PrefectHQ/fastmcp/pull/6429
- Let a dependency's CallArgument own a tool argument by @zzstoatzz and @Kludex in https://github.com/PrefectHQ/fastmcp/pull/6438
- Remove private dead code and type-check the companion packages by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6454
- Add SkillManifestProvider to serve skills without loading their files by @jakekaplan in https://github.com/PrefectHQ/fastmcp/pull/6465
Security 🔒
- Verify advertised skill frontmatter when reading content by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6090
- Check skill limits before reading directory and remote files by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6092
- fix: preserve _list_query_params in FastMCPProviderResourceTemplate.wrap by @RS-ITACHI in https://github.com/PrefectHQ/fastmcp/pull/6130
- Read composite action inputs from env and pin actions by digest by @gaker in https://github.com/PrefectHQ/fastmcp/pull/6168
- Scope the /marvin App token to the permissions it uses by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6206
- Require patched Authlib in client and server extras by @zzstoatzz and @zhuweid in https://github.com/PrefectHQ/fastmcp/pull/6337
- Update example locks past the schema-parsing security fix by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6339
- Redact passwords from the worker's backend URL by @jaeminbird and @mbishflavien in https://github.com/PrefectHQ/fastmcp/pull/6113
- fix(auth): collapse a repeated
iss in the client redirect by @shi-felix and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6352
- Normalize raw-string redirect URIs through AnyUrl before validation by @uhhgxg and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6315
- fix(auth): include DNS in SSRF deadline by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5509
- fix(transforms): enforce wall-clock timeout and external callback limit in MontySandboxProvider and CodeMode by @Pyhroff in https://github.com/PrefectHQ/fastmcp/pull/6063
Fixes 🐞
- Make the version-check InvalidURL regression independent of proxy parsing by @HootRock in https://github.com/PrefectHQ/fastmcp/pull/6048
- Build the Prefab renderer page on read, not on resources/list by @adam-zovos in https://github.com/PrefectHQ/fastmcp/pull/6039
- Install mounted skills under their own name in sync_skills by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6078
- Stage skill exports before replacing installed files by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6091
- fix: Prefix backend hash addresses with double underscores by @jlowin and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/6100
- Rebind pre-4.2 Prefab backend addresses through 4.2 proxies by @jakekaplan in https://github.com/PrefectHQ/fastmcp/pull/6108
- Isolate and bound triage verification by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6109
- Improve OpenAPI upstream error details by @zzstoatzz and @mssaleh in https://github.com/PrefectHQ/fastmcp/pull/6141
- Compare JSON const and enum values by JSON equality by @prassu017 and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6126
- Bound Skills proxy backend pagination by @prassu017 and @Yash-Tripath1 in https://github.com/PrefectHQ/fastmcp/pull/6104
- fix: forward script arguments in FastMCPStdioTransport by @KashifManzer and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/6119
- Return invalid params for prompts/get with a missing required argument by @asasemahmed and @xubenqiang in https://github.com/PrefectHQ/fastmcp/pull/6027
- Fix kept-alive stdio transports ignoring client timeouts by @HootRock in https://github.com/PrefectHQ/fastmcp/pull/6156
- perf(schema): skip unnecessary reference sibling restoration by @andreivince in https://github.com/PrefectHQ/fastmcp/pull/6161
- fix(cli): prefer Claude Code project servers by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5522
- fix(cli): preserve JSON content block fields by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5530
- Keep schema definitions when hydrating a wrapped tool result by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5927
- Reject undeclared OpenAPI tool arguments under strict input validation by @prassu017 and @mssaleh in https://github.com/PrefectHQ/fastmcp/pull/6140
- fix(resources): reverse hostless URIs through Namespace unchanged by @serhiizghama and @andreivince in https://github.com/PrefectHQ/fastmcp/pull/5230
- fix(openapi): preserve timeouts so the server maps them to the actionable message by @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5847
- Keep posted review receipts on partial delivery and reject differing reviews by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6178
- Drop client context holds left by finished tasks by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6205
- Let clients with different timeouts share a kept-alive stdio session by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6223
- fix(cli): preserve explicit null in generated tool commands by @likecake in https://github.com/PrefectHQ/fastmcp/pull/6191
- Honor empty tag inclusion filters in multi-server configs by @PennEwan in https://github.com/PrefectHQ/fastmcp/pull/6200
- fix(mcp-config): reuse one OAuth client per configured server by @kbkb628 and @whoskn in https://github.com/PrefectHQ/fastmcp/pull/6097
- Fix and quiet the triage alerts from 2026-11-02 by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6235
- fix(tasks): send task IDs in routing headers by @eli-yip in https://github.com/PrefectHQ/fastmcp/pull/5810
- fix(middleware): treat an empty methods allowlist as "log nothing" by @gdut4140 in https://github.com/PrefectHQ/fastmcp/pull/5727
- Fix namespaced file resource reads while preserving URI normalization by @BlueLi66 in https://github.com/PrefectHQ/fastmcp/pull/5716
- fix(server): pass typed list request messages to list middleware hooks by @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5732
- Stop OpenAPI end-to-end tests from hitting the network by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6249
- fix(auth): Preserve browser consent bindings across concurrent OAuth approvals by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5541
- fix(openapi): serialize header and path parameters per the simple style by @Harsh23Kashyap in https://github.com/PrefectHQ/fastmcp/pull/5091
- Fall back to method and path when an OpenAPI name slugs to nothing by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5699
- Convert OpenAPI 3.0 boolean exclusive bounds to numeric bounds by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5697
- Rewrite component refs under not, if/then/else and similar keywords by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5698
- fix(openapi): keep media-type $defs beside component schemas by @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5709
- Omit readOnly properties from OpenAPI tool input schemas by @AarnavNoble in https://github.com/PrefectHQ/fastmcp/pull/5753
- fix: name root self-references after the generated root class by @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5671
- fix(proxy): keep stale list results out of cache by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5521
- Match Claude Code project keys by path on Windows by @zzstoatzz and @yongpange in https://github.com/PrefectHQ/fastmcp/pull/6240
- Stop preloading the server before launching the Inspector by @zzstoatzz and @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/6241
- Cull expired OAuth state from the default OAuthProxy file store by @zzstoatzz, @nosmile99, and @mheidari98 in https://github.com/PrefectHQ/fastmcp/pull/6242
- Reuse the stdio session after a cancelled startup by @zzstoatzz and @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/6243
- Match Gemini function responses to tool-use IDs by @zzstoatzz and @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/6244
- Replace parent type keywords when an ArgTransform changes the type by @zzstoatzz, @syf2211, @HootRock, and @chrikrah in https://github.com/PrefectHQ/fastmcp/pull/6246
- Expire idle per-client rate limiters by @zzstoatzz and @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/6247
- Match resource templates that spell out a literal query by @zzstoatzz and @arieleven in https://github.com/PrefectHQ/fastmcp/pull/6248
- fix(openapi): preserve explicit null in nullable JSON body properties by @mumu-bird in https://github.com/PrefectHQ/fastmcp/pull/5633
- Keep OpenAPI refs that point into a component schema intact by @zzstoatzz and @AarnavNoble in https://github.com/PrefectHQ/fastmcp/pull/6245
- fix(telemetry): record mounted and nested server spans as INTERNAL by @zzstoatzz and @sonmaximum in https://github.com/PrefectHQ/fastmcp/pull/6252
- fix(client): identify as fastmcp in clientInfo by default by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6254
- fix(openapi): keep both values when a query object property matches another parameter by @zzstoatzz and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6256
- fix(middleware): map exception subclasses in ErrorHandlingMiddleware by @zzstoatzz and @zurmag in https://github.com/PrefectHQ/fastmcp/pull/6257
- fix(client): report a lost connection instead of 'Client is not connected' by @zzstoatzz and @alex-feel in https://github.com/PrefectHQ/fastmcp/pull/6259
- fix(client): keep ClientGroup tool routes after the group context exits by @zzstoatzz, @hntrl, and @YingzuoLiu in https://github.com/PrefectHQ/fastmcp/pull/6268
- Accept structured skill metadata and allowed-tools lists by @jakekaplan in https://github.com/PrefectHQ/fastmcp/pull/6292
- Preserve 4.1 skills type checks and resource-only manifest migration by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6305
- Fix generated CLIs for tools named app, console or Client by @andreivince in https://github.com/PrefectHQ/fastmcp/pull/6056
- Disambiguate colliding parameter flags in generate-cli by @mohitdixit02 and @andreivince in https://github.com/PrefectHQ/fastmcp/pull/6311
- fix: preserve CRLF descriptions in generated CLI parameter help by @chris00234 in https://github.com/PrefectHQ/fastmcp/pull/6075
- fix(agentic): repair baseline collection verification by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6313
- Reject non-positive event retention limits by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5535
- fix(search): rebuild the BM25 index when the tool name set changes by @shi-felix in https://github.com/PrefectHQ/fastmcp/pull/6282
- fix(tools): keep hidden parameter factories out of visible defaults by @shi-felix in https://github.com/PrefectHQ/fastmcp/pull/6283
- fix(auth): accept private-use scheme redirect URIs in CIMD documents by @ColePBryan in https://github.com/PrefectHQ/fastmcp/pull/6335
- Report the stop reason from sampling handlers when no tools are offered by @AarnavNoble in https://github.com/PrefectHQ/fastmcp/pull/6342
- fix(auth): preserve empty authority on custom-scheme redirect URIs by @codesphere-u and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6347
- Declare items.type on multi-select list shorthand elicitations by @zzstoatzz, @shi-felix, @Vivek1898, and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6361
- Mask prompt handler exceptions when mask_error_details=True by @pratyu2h and @maxmorrish in https://github.com/PrefectHQ/fastmcp/pull/6277
- Send {} for required OpenAPI object bodies with no fields by @rome-xi and @wang1299 in https://github.com/PrefectHQ/fastmcp/pull/6340
- fix(client): keep the response cache inert on legacy connections (#6298) by @xunWhale and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6321
- Encode manifest paths in download_skill URIs by @zzstoatzz, @67-luck, and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/6376
- Fix skill discovery for nested supporting files by @mahekara28 and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6310
- fix: keep additionalProperties on object schemas without a type by @bfs2021 and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6127
- Fix hydration of mutually recursive schema types by @zzstoatzz, @wozhenbang2004, and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6394
- Isolate filesystem component construction failures by @PennEwan in https://github.com/PrefectHQ/fastmcp/pull/6210
- fix(config): apply tool transforms before tag filters on single servers by @AP24110011695 and @arjunprabhulal in https://github.com/PrefectHQ/fastmcp/pull/6214
- fix(tools): isolate mutable defaults in transformed tool calls by @priy-anshugupta in https://github.com/PrefectHQ/fastmcp/pull/6184
- fix(openapi): make resource templates for non-identifier path parameters readable by @AP24110011695 and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6187
- fix(json-schema): keep tools/list working when a root $ref resolves to a boolean schema by @AP24110011695 and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6185
- Document that a custom httpx_client_factory owns its timeout by @asasemahmed and @himanshuchawla0807-gif in https://github.com/PrefectHQ/fastmcp/pull/5923
- Stop PingMiddleware erroring when the client has no back-channel by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5901
- Store sessionless client log levels on the connection by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5899
- Send the whole body when a body $ref with siblings cannot be flattened by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5893
- Pass the transport to the fastmcp-remote proxy so it forwards server-initiated requests by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5885
- fix(cli): forward path, stateless and log-level to SDK MCPServer servers by @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5870
- fix(client): preserve a caller-provided OAuth httpx client factory when verify is set by @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5849
- fix(prompts): resolve postponed annotations when rendering by @67-luck and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5803
- fix(openapi): hydrate data for wrapped non-object responses with validate_output=False by @nosmile99 and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5784
- Carry prompt argument titles through PromptArgument and proxies by @AarnavNoble in https://github.com/PrefectHQ/fastmcp/pull/5749
- Relay the client's sampling result unchanged through proxies by @AarnavNoble in https://github.com/PrefectHQ/fastmcp/pull/5747
- fix(tasks): let async-generator tools run as background tasks by @gdut4140 in https://github.com/PrefectHQ/fastmcp/pull/5730
- Honor Code Mode search limits after BM25 ranking by @Winoren and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5715
- Keep the client timeout from capping the HTTP read timeout by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5690
- fix(auth): avoid rereading failed authorization forms by @pei711 and @JordanAfolabiLaw in https://github.com/PrefectHQ/fastmcp/pull/5570
- Fix unbounded Apps dev log retention by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5549
- Bound error-stat cardinality in ErrorHandlingMiddleware by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5537
- fix(auth): preserve GitHub sessions across transient verification failures by @sui-ni2 and @benjohngf in https://github.com/PrefectHQ/fastmcp/pull/4881
- Expect the extended read timeout in the factory timeout test by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6395
- Accept intake's contribution route in the triage review check by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6405
- fix(auth): keep revocation ownership separate from user identity by @zzstoatzz, @BlueX888, and @67-luck in https://github.com/PrefectHQ/fastmcp/pull/6404
- Authenticate and pin the schema download in the OpenAPI performance test by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6177
- Use renamed argument names in transformed tool validation errors by @kartikmadan11 in https://github.com/PrefectHQ/fastmcp/pull/6158
- Preserve invalid defaults for omitted JSON Schema fields by @totoyang and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6133
- Validate positional array prefixes separately from their tails by @PennEwan and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6146
- Fix resource templates with multiple query expressions by @xiong-wei1 in https://github.com/PrefectHQ/fastmcp/pull/6061
- fix(json-schema): decode RFC 6901 escapes when extracting $defs names by @AP24110011695 and @RS-ITACHI in https://github.com/PrefectHQ/fastmcp/pull/6180
- Drop backend serverInfo from proxied tool and prompt results by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5911
- fix(telemetry): record exceptions once per span by @DMomplaisir in https://github.com/PrefectHQ/fastmcp/pull/5861
- fix(resources): honor Pydantic field aliases in resource templates by @anh-nguyenn and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/6054
- fix(auth): authorize hashed app-tool names and synthesized Prefab resources by @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5841
- fix(server): serialize structured prompt arguments before middleware by @67-luck and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5805
- fix(client): stop validating version-pinned call_tool results against the highest version's schema by @gdut4140 in https://github.com/PrefectHQ/fastmcp/pull/5725
- Preserve typed additional properties in hydrated tool results by @PrathmeshPawar2110, @yannvr, @BlueX888, and @hulkbig in https://github.com/PrefectHQ/fastmcp/pull/5779
- fix(server): serve Mcp-Param validation from a wire-schema cache by @akushonkamen and @anormang1992 in https://github.com/PrefectHQ/fastmcp/pull/5666
- Fix #5563: OTel: prefer
AccessToken.subject over client_id for enduser.id by @nandanadileep and @omikader in https://github.com/PrefectHQ/fastmcp/pull/5565
- fix: decode URI fragments before schema reference hydration by @HuaTNA in https://github.com/PrefectHQ/fastmcp/pull/5561
- Fix #5559: Configuration helpers still discard explicit port=0 by @nandanadileep and @dream-star-end in https://github.com/PrefectHQ/fastmcp/pull/5562
- Preserve or explicitly reject images in sampling tool results by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5554
- fix(client): close partial group connections on cancellation by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5519
- fix(cli): resolve config paths beside fastmcp.json by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5511
- fix(tools): reject non-finite floats at the JSON serialization boundary by @akushonkamen and @YogaSakti in https://github.com/PrefectHQ/fastmcp/pull/5665
- Make the partial-construction stdio test fast and strict by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6433
- test: isolate consent checks and preserve OpenAPI download budget by @Larry-Labs in https://github.com/PrefectHQ/fastmcp/pull/5664
- fix(client): validate accepted elicitation content by @mikamikasuki in https://github.com/PrefectHQ/fastmcp/pull/5513
- fix:
session: UserSession on a resource or resource template fails at registration by @xixi-box and @arjunprabhulal in https://github.com/PrefectHQ/fastmcp/pull/6198
- fix(cli): parse JSON for non-string unions and accept null in call args by @Christian-Sidak and @BHAWESHBHASKAR in https://github.com/PrefectHQ/fastmcp/pull/6012
- Forward URL-mode elicitation through the proxy by @Kushal9889 in https://github.com/PrefectHQ/fastmcp/pull/5980
- Let context list calls run outside a request by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5903
- Keep ResourceLink content on prompt messages by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5897
- Accept WorkOS tokens when required_scopes is set by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5881
- fix(openapi): JSON-encode object form fields in urlencoded request bodies by @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5851
- Keep task config and execution on transformed tools by @Winoren and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5793
- fix(proxy): relay non-object tool results across MCP versions by @Lpk124 and @maxime-gautre in https://github.com/PrefectHQ/fastmcp/pull/5763
- Fix #5706: Resource template with a level-3 operator such as {&size} is listed but can never be read by @nandanadileep and @chrikrah in https://github.com/PrefectHQ/fastmcp/pull/5711
- fix(server): fall back to the highest authorized version on direct lookup by @gshklovs and @CoralGarden52 in https://github.com/PrefectHQ/fastmcp/pull/5169
- Resolve deferred defaults by alias and keep unverified GitHub scopes out of the cache by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6417
- Drop unpinned ping from auth example clients by @zzstoatzz and @stephaneberle9 in https://github.com/PrefectHQ/fastmcp/pull/6418
- Call a re-versioned tool by its transformed version by @zzstoatzz and @MayankTamakuwala in https://github.com/PrefectHQ/fastmcp/pull/6419
- Apply logging/setLevel to mounted servers over HTTP sessions by @zzstoatzz and @alpaylan in https://github.com/PrefectHQ/fastmcp/pull/6421
- Reconnect StdioTransport when reused on a different event loop by @zzstoatzz and @dsfaccini in https://github.com/PrefectHQ/fastmcp/pull/6425
- Forward list-changed notifications through ProxyClient by @zzstoatzz, @chrikrah, and @ldlda in https://github.com/PrefectHQ/fastmcp/pull/6426
- Report JSON-RPC error codes and request ids on telemetry spans by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6427
- Stop the SSE endpoint sending a second response after its stream by @zzstoatzz and @JonZeolla in https://github.com/PrefectHQ/fastmcp/pull/6431
- Bypass proxy env when fastmcp dev apps lists tools by @zzstoatzz and @AlyLanier in https://github.com/PrefectHQ/fastmcp/pull/6422
- fix(context): allow background task logging without a session by @67-luck and @BlueX888 in https://github.com/PrefectHQ/fastmcp/pull/5806
- fix(skills): follow empty pagination cursors when listing skills by @67-luck in https://github.com/PrefectHQ/fastmcp/pull/6473
- Fix the CLI .js deprecation warning and a dead error-message link by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6453
- Ignore stray ResourceWarnings in CLI OAuth warning checks by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6474
- Accept a sync tool timeout that fires before its thread starts by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6475
- Drop GC ResourceWarnings at the assertion in CLI OAuth warning checks by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6481
Docs 📚
- Consolidate skills docs into one Skills over MCP page by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6049
- Rewrite skills docs around Skill and SkillCatalogProvider by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6066
- Tighten skills docs examples by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6070
- Shorten the skills docs page by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6079
- Badge the skills page as 4.2.0 by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6083
- Consolidate skills examples around verified Skill values by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6093
- docs: add v4.2.0a1 changelog entries by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6105
- Add MCP tool annotations to get_file example by @gl1tchdust in https://github.com/PrefectHQ/fastmcp/pull/5976
- Fix dead links in current documentation by @zzstoatzz and @Wilson0511 in https://github.com/PrefectHQ/fastmcp/pull/6142
- docs: rename Horizon to FastMCP Gateway in current docs by @parkedwards in https://github.com/PrefectHQ/fastmcp/pull/5653
- Document strict-mode handling of undeclared OpenAPI arguments by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6169
- docs: add v4.2.0a2 changelog entries by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6224
- docs(settings): explain what FASTMCP_DEBUG actually does by @zzstoatzz and @ianw in https://github.com/PrefectHQ/fastmcp/pull/6255
- docs: pass referrers on outbound links, add organization schema and page descriptions by @madureira-gabriel in https://github.com/PrefectHQ/fastmcp/pull/6287
- docs: add v4.2.0a3 changelog entries by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6306
- docs: preserve docs routing metadata and release guidance by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6320
- Correct how tools docs describe bytes return values by @DivyaNarahari97 in https://github.com/PrefectHQ/fastmcp/pull/6275
- docs: add v4.2.0a4 changelog entries by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6388
- docs: correct the server pages against main by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6406
- docs: correct the client pages against main by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6407
- docs: correct the apps pages against main by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6409
- docs: correct getting started, CLI and deployment pages against main by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6410
- docs: correct the integration pages against main by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6408
- docs: label the current docs version v4 by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6411
- docs: explain root_path for SSE behind a prefix-stripping proxy by @zzstoatzz and @KnittelK in https://github.com/PrefectHQ/fastmcp/pull/6215
- docs: keep the search shortcut hint off the button edge by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6413
- docs: clarify tool errors and middleware transformations by @rasokiwayami and @jeffsawatzky in https://github.com/PrefectHQ/fastmcp/pull/5566
- docs: server-level component changes don't notify clients by @zzstoatzz and @Ngtvu1752 in https://github.com/PrefectHQ/fastmcp/pull/6423
- docs: badge 4.2.0 features and add the 4.1 → 4.2 upgrade guide by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6436
- Pre-4.2 polish: stale docs, examples and docstrings by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6452
- docs: add v4.2.0a5 changelog entries by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6469
- Update docs logo to new FastMCP wordmark by @ninadewane in https://github.com/PrefectHQ/fastmcp/pull/6462
- docs: add v4.2.0 changelog entries by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6482
Examples & Contrib 💡
- Register templated MCPMixin resources as resource templates by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5895
- Keep structured content on bulk tool results by @asasemahmed in https://github.com/PrefectHQ/fastmcp/pull/5917
Dependencies 📦
- build(deps): bump mcp from 1.28.1 to 1.30.0 in /examples/testing_demo in the uv group across 1 directory by @dependabot[bot] in https://github.com/PrefectHQ/fastmcp/pull/5990
Other Changes 🦾
- chore(deps): Update dependency ruff to v0.17.2 by @prefect-renovate[bot] in https://github.com/PrefectHQ/fastmcp/pull/6233
- chore(deps): Pin dependencies by @prefect-renovate[bot] in https://github.com/PrefectHQ/fastmcp/pull/6064
- Require patched joserfc by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6371
- Keep colon-terminated prose lines in docstring tool descriptions by @zzstoatzz, @jlx1999s, and @ptrailblazer89 in https://github.com/PrefectHQ/fastmcp/pull/6372
- chore(deps): Update dependency oauthlib to v4.0.1 [SECURITY] by @prefect-renovate[bot] in https://github.com/PrefectHQ/fastmcp/pull/6367
- chore(deps): Update dependency node to v26 by @prefect-renovate[bot] in https://github.com/PrefectHQ/fastmcp/pull/6234
- chore(deps): Update dependency prefect to v3.9.1 by @prefect-renovate[bot] in https://github.com/PrefectHQ/fastmcp/pull/6232
- Keep completion from suggesting values for hidden references by @zzstoatzz and @pvliesdonk in https://github.com/PrefectHQ/fastmcp/pull/6450
</details>
<details>
<summary>New contributors</summary>
- @adam-zovos made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6039
- @fprieto14 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6077
- @keremoktener made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6077
- @gl1tchdust made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5976
- @Yash-Tripath1 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6104
- @ianw made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6255
- @hntrl made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6268
- @YingzuoLiu made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6268
- @mohitdixit02 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6311
- @chris00234 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6075
- @67-luck made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6376
- @mahekara28 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6310
- @DMomplaisir made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5861
- @KnittelK made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6215
- @kartikmadan11 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6158
- @totoyang made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6133
- @xiong-wei1 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6061
- @anh-nguyenn made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6054
- @yannvr made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5779
- @akushonkamen made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5666
- @anormang1992 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5666
- @jeffsawatzky made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5566
- @rasokiwayami made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5566
- @omikader made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5565
- @dream-star-end made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5562
- @YogaSakti made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5665
- @Pyhroff made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6063
- @Larry-Labs made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5664
- @xixi-box made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6198
- @BHAWESHBHASKAR made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6012
- @Christian-Sidak made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6012
- @Kushal9889 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5980
- @Abhi2939 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5969
- @ezz3r made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5969
- @Lpk124 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5763
- @maxime-gautre made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5763
- @gshklovs made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/5169
- @ninadewane made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6462
- @MayankTamakuwala made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6419
- @Ngtvu1752 made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6423
- @dsfaccini made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6425
- @ldlda made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6426
- @carterthayer made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6428
- @AlyLanier made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6422
- @CaselIT made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6429
- @swantzter made their first contribution in https://github.com/PrefectHQ/fastmcp/pull/6429
</details>
Full Changelog: https://github.com/PrefectHQ/fastmcp/compare/v4.1.4...v4.2.0