Skip to content

v4.2.0: Mad Skills

Latest

Choose a tag to compare

@zzstoatzz zzstoatzz released this 13 Nov 17:07
5e71792

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.

Every change in this release

Breaking Changes ⚠️

Enhancements ✨

Security 🔒

  • Verify advertised skill frontmatter when reading content by @zzstoatzz in #6090
  • Check skill limits before reading directory and remote files by @zzstoatzz in #6092
  • fix: preserve _list_query_params in FastMCPProviderResourceTemplate.wrap by @RS-ITACHI in #6130
  • Read composite action inputs from env and pin actions by digest by @gaker in #6168
  • Scope the /marvin App token to the permissions it uses by @zzstoatzz in #6206
  • Require patched Authlib in client and server extras by @zzstoatzz and @zhuweid in #6337
  • Update example locks past the schema-parsing security fix by @zzstoatzz in #6339
  • Redact passwords from the worker's backend URL by @jaeminbird and @mbishflavien in #6113
  • fix(auth): collapse a repeated iss in the client redirect by @shi-felix and @alpaylan in #6352
  • Normalize raw-string redirect URIs through AnyUrl before validation by @uhhgxg and @alpaylan in #6315
  • fix(auth): include DNS in SSRF deadline by @mikamikasuki in #5509
  • fix(transforms): enforce wall-clock timeout and external callback limit in MontySandboxProvider and CodeMode by @Pyhroff in #6063

Fixes 🐞

Docs 📚

Examples & Contrib 💡

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 #5990

Other Changes 🦾

  • chore(deps): Update dependency ruff to v0.17.2 by @prefect-renovate[bot] in #6233
  • chore(deps): Pin dependencies by @prefect-renovate[bot] in #6064
  • Require patched joserfc by @zzstoatzz in #6371
  • Keep colon-terminated prose lines in docstring tool descriptions by @zzstoatzz, @jlx1999s, and @ptrailblazer89 in #6372
  • chore(deps): Update dependency oauthlib to v4.0.1 [SECURITY] by @prefect-renovate[bot] in #6367
  • chore(deps): Update dependency node to v26 by @prefect-renovate[bot] in #6234
  • chore(deps): Update dependency prefect to v3.9.1 by @prefect-renovate[bot] in #6232
  • Keep completion from suggesting values for hidden references by @zzstoatzz and @pvliesdonk in #6450
New contributors

Full Changelog: v4.1.4...v4.2.0