{"full_name":"PrefectHQ/fastmcp","owner":"PrefectHQ","name":"fastmcp","shard":"1","url":"https://github.com/PrefectHQ/fastmcp","description":"🚀 The fast, Pythonic way to build MCP servers and clients.","homepage":"https://gofastmcp.com","topics":["model-context-protocol","fastmcp","mcp","agents","llms","mcp-clients","mcp-servers","mcp-tools","python"],"tag_pages":["agents","llms","mcp","model-context-protocol","python"],"language":"Python","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/39270919?v=4","created_at":"2024-11-30T01:47:40Z","pushed_at":"2026-11-16T09:24:19Z","metrics":{"stars":28569,"forks":2612,"watchers":120,"issues":2326,"prs":3835,"releases":147,"issues_open":158,"issues_closed":2168,"prs_open":79,"prs_closed":738,"prs_merged":3018,"discussions":278},"growth":{},"history":{"dates":["2026-11-16"],"stars":[28569],"forks":[2612],"watchers":[120],"issues_open":[158],"prs_open":[79]},"boards":{},"same_owner":[],"issues":[{"number":2647,"title":"[Client] Correlation for elicitation and sampling requests to tool calls","comments":8,"created_at":"2025-12-18T18:31:43Z"},{"number":2358,"title":"Disable rich tracebacks by default","comments":7,"created_at":"2025-11-03T20:58:49Z"},{"number":4901,"title":"OAuthProxy: client refresh tokens are rotated with no grace period, causing permanent session loss under concurrent /token requests","comments":6,"created_at":"2026-08-25T03:40:35Z"},{"number":4299,"title":"Feature: full customization of the OAuth consent page (renderer/template hook) beyond name/icon/website","comments":7,"created_at":"2026-06-07T11:10:11Z"},{"number":6443,"title":"Upgrade checks failing on main branch","comments":5,"created_at":"2026-11-11T02:08:39Z"},{"number":6153,"title":"OAuthProxy: no way to limit CIMD to trusted domains","comments":5,"created_at":"2026-10-29T14:04:07Z"},{"number":5098,"title":"from_openapi: cookie parameters with array/object values send Python repr strings","comments":5,"created_at":"2026-09-13T12:52:13Z"},{"number":4920,"title":"v4 beta: out-of-band `tools/list_changed` is silently dropped on the `2026-07-28` era (delivered on `2025-11-25`)","comments":5,"created_at":"2026-08-27T08:51:49Z"}],"discussions":[{"number":6490,"title":"Review MCP config changes in PRs with Permission Delta","comments":0,"category":"Show and tell","created_at":"2026-11-14T19:11:20Z"},{"number":6459,"title":"mcp-slim: Zero-dependency MCP stdio proxy & CLI profiler (-50% to -98.7% schema tokens, $ref inlining, SecretGuard)","comments":2,"category":"Show and tell","created_at":"2026-11-12T02:29:22Z"},{"number":6448,"title":"Wavefunction Field: open starter jobs and MCP tools for cross-agent workflows","comments":0,"category":"Show and tell","created_at":"2026-11-11T16:34:03Z"},{"number":6384,"title":"FastMCP client example: free CAD-to-print advice before a manufacturing request","comments":1,"category":"Show and tell","created_at":"2026-11-09T23:43:54Z"},{"number":6348,"title":"Chinese deep-dive: FastMCP 4.1.6 — turning a 2,400-row ledger into MCP tools","comments":0,"category":"Show and tell","created_at":"2026-11-07T18:12:02Z"},{"number":6346,"title":"A client-only FastMCP 4 example: search and read EVM RPC docs","comments":0,"category":"Show and tell","created_at":"2026-11-07T11:44:02Z"},{"number":6343,"title":"Cloud Alter Ego: a remote MCP connector for your rules and work history, stored in your own cloud files","comments":0,"category":"Show and tell","created_at":"2026-11-07T08:17:40Z"},{"number":6226,"title":"tokenjuice: local shell-result compaction middleware for FastMCP and proxies","comments":1,"category":"Show and tell","created_at":"2026-11-02T00:26:25Z"}],"latest_release":{"name":"v4.2.0: Mad Skills","tag":"v4.2.0","published_at":"2026-11-13T17:07:01Z","body":"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.\n\n```python\nfrom fastmcp import FastMCP, Skill\nfrom fastmcp.skills.provider import SkillCatalogProvider\n\ndeploy = Skill.from_directory(\"skills/deploy\")\n\nmcp = FastMCP(\"Team Skills\")\nmcp.add_provider(SkillCatalogProvider([deploy]))\n```\n\nAny client can read a skill's files as ordinary resources. Clients that speak the experimental [Skills extension](https://modelcontextprotocol.io/seps/2640-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](https://gofastmcp.com/docs/servers/skills) cover the details.\n\nDependencies 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.\n\n### Before upgrading\n\n- Python 3.11 or newer is required.\n- 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](https://gofastmcp.com/docs/servers/skills) include a migration table.\n- `Skill` is now the class you author with. The wire model that used that name is `MCPSkill`; the old import works until 4.3.\n\nThanks to our 120 contributors, including 46 first-time contributors.\n\n<details>\n<summary>Every change in this release</summary>\n\n<!-- Release notes generated using configuration in .github/release.yml at main -->\n\n\n### Breaking Changes ⚠️\n* Make Skill a storage-neutral object with folders as one loader by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6065\n* Require Python 3.11 by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6377\n### Enhancements ✨\n* Rename the resource-era list_skills helper to list_skill_summaries by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6051\n* Discover skills through mounted servers by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6067\n* Share Prefab renderer resources across equivalent tools by @jlowin, @fprieto14, and @keremoktener in https://github.com/PrefectHQ/fastmcp/pull/6077\n* Export Skill from fastmcp by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6071\n* Add skills discovery to ClientGroup by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6072\n* Add --skills to fastmcp list by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6073\n* Add Client.read_skill and tighten skills docs by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6087\n* Verify and export skills with resource-manifest fallback by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6086\n* Forward Skills discovery through proxies by @jakekaplan in https://github.com/PrefectHQ/fastmcp/pull/5788\n* Share strict skill snapshot projection by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6089\n* Use scoped local tests and leave full suites to CI by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6094\n* Share ClientGroup skill client lookup by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/6101\n* Share filesystem skill supporting-file reads by @zzstoatzz in https://github.com/PrefectHQ/fastmcp/pull/610","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}