Skip to content

feat: evaluate component versioning for backward-compatible tool evolution #188

Description

@ichoosetoaccept

FastMCP 3.0 supports component versioning — serve @tool(version="2.0") alongside older versions from one codebase. This could help us evolve tool signatures without breaking existing agent workflows.

What's available:

  • @tool(version="2.0") decorator parameter
  • VersionFilter transform for automatic highest-version selection
  • Clients can request specific versions

Value: Would let us iterate on tool signatures (e.g. adding structured return types, changing parameters) without breaking agents pinned to older behavior.

Ref: https://github.com/PrefectHQ/fastmcp/releases/tag/v3.0.0

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions