Changelog¶

All notable Litestar MCP changes are summarized here. Entries are grouped by release and focus on user-visible behavior, public API changes, compatibility notes, and important protocol fixes.

Recent Updates¶

0.7.3¶

Released: 2026-06-24

Features¶

add tool-call observability callbacks#: Adds MCPConfig.before_tool_call and MCPConfig.after_tool_call hooks around tools/call dispatch for audit, metrics, and tracing use cases. The after hook receives either the result or exception plus elapsed dispatch duration, and hook failures are logged without changing tool-call behavior.

References: https://github.com/cofin/litestar-mcp/issues/68

Bugfixes¶

exclude Dishka-resolved provider params from tool inputs#: Litestar Provide(...) factory parameters whose annotated type can be resolved from app.state.dishka_container are no longer emitted as MCP tool arguments. Ordinary provider-declared inputs, such as pagination and filter values, still appear in schemas and dispatch.

References: https://github.com/cofin/litestar-mcp/issues/67

0.7.2¶

Released: 2026-06-11

Bugfixes¶

include provider-declared query parameters in MCP schemas#: Query parameters declared on Litestar dependency providers now appear in MCP tool input schemas and are forwarded during tool execution, so provider-backed pagination and aliases are discoverable and callable by MCP clients.

References: https://github.com/cofin/litestar-mcp/issues/64, https://github.com/cofin/litestar-mcp/pull/65

0.7.1¶

Released: 2026-06-09

Bugfixes¶

fix published project URLs#: Corrects package metadata links so the project URL points at the GitHub repository and the documentation URL points at the published docs site.

References: https://github.com/cofin/litestar-mcp/pull/60
return 202 for accepted Streamable HTTP notifications#: Accepted JSON-RPC notifications over MCP Streamable HTTP now return 202 Accepted with an empty body, matching the MCP transport requirement for accepted JSON-RPC notifications and responses sent via POST.

References: https://github.com/cofin/litestar-mcp/issues/61
apply filters to direct tool and resource invocation#: include_* and exclude_* filters now gate direct tools/call and resources/read invocation in addition to list responses. A filtered tool, resource, or resource template is treated like an unknown name or URI. Filters narrow the MCP exposure surface; Litestar guards and auth middleware remain the access-control boundary.

References: https://github.com/cofin/litestar-mcp/issues/62

0.7.0¶

Released: 2026-06-07

Features¶

paginate MCP list methods#: Adds opaque cursor pagination for MCP list methods so clients can page through tools, resources, resource templates, and prompts using nextCursor.

References: https://github.com/cofin/litestar-mcp/issues/47, https://github.com/cofin/litestar-mcp/pull/58

Bugfixes¶

converge handler signature introspection#: Uses the same handler-signature introspection path for schema generation and execution-time argument handling, reducing drift between advertised input schemas and accepted call arguments.

References: https://github.com/cofin/litestar-mcp/issues/49, https://github.com/cofin/litestar-mcp/pull/58
document the MCP primitive error contract#: Locks and documents the primitive-level error contract for tools, resources, and prompts. Handler HTTP status is preserved in error data where relevant instead of minting non-standard JSON-RPC codes.

References: https://github.com/cofin/litestar-mcp/issues/48, https://github.com/cofin/litestar-mcp/pull/58

Other changes¶

document MCP Prompts end-to-end#: Adds Prompts coverage across the usage guide, API reference, README, and task-manager example.

References: https://github.com/cofin/litestar-mcp/issues/56, https://github.com/cofin/litestar-mcp/pull/58

0.6.0¶

Released: 2026-06-04

Features¶

add MCP Prompts support#: Adds MCP Prompts support, including prompt discovery and retrieval via prompts/list and prompts/get.

References: https://github.com/cofin/litestar-mcp/pull/46

Bugfixes¶

unwrap Annotated parameters in input schemas#: Unwraps Annotated[T, Parameter(...)] declarations when generating MCP tool input schemas so Litestar parameter metadata does not hide the underlying value type.

References: https://github.com/cofin/litestar-mcp/issues/52, https://github.com/cofin/litestar-mcp/pull/53

Other changes¶

update for Litestar 3 deprecations#: Updates runtime, docs, and tests for Litestar 3 deprecation paths.

References: https://github.com/cofin/litestar-mcp/pull/54

0.5.1¶

Released: 2026-04-19

Bugfixes¶

restore full Litestar execution parity#: Runs MCP tool execution through the full Litestar request lifecycle for hooks, renamed fields, and path-parameter coercion.

References: https://github.com/cofin/litestar-mcp/issues/41, https://github.com/cofin/litestar-mcp/issues/42, https://github.com/cofin/litestar-mcp/issues/43, https://github.com/cofin/litestar-mcp/pull/44

0.5.0¶

Released: 2026-04-19

Features¶

add consumer-readiness features#: Adds structured tool/resource descriptions, resource templates, resources/templates/list, completion/complete, injectable JWKS cache support, and well-known discovery documents.

References: https://github.com/cofin/litestar-mcp/pull/40

Other changes¶

refresh docs and examples for consumer usage#: Raises the supported Python floor to 3.10, renames bundled examples to hello_world and task_manager, adds example tests and snippet markers, and updates docs to prefer Litestar route kwargs such as mcp_tool="name".

References: https://github.com/cofin/litestar-mcp/pull/40
remove scope enforcement and auth extra#breaking: Removes inline scope enforcement so scopes are discovery metadata and Litestar guards are the access-control surface. The legacy auth extra was removed and auth dependencies now install with the core package.

References: https://github.com/cofin/litestar-mcp/pull/40

0.4.0¶

Released: 2026-04-16

Features¶

switch to Streamable HTTP#: Replaces the legacy REST endpoint surface with MCP Streamable HTTP, using GET /mcp for SSE and POST /mcp for JSON-RPC requests.

References: https://github.com/cofin/litestar-mcp/pull/32

Other changes¶

add database integration test matrix#: Adds database-backed integration coverage for Advanced Alchemy, SQLSpec, Dishka, and auth-mode combinations.

References: https://github.com/cofin/litestar-mcp/pull/34

0.3.0¶

Released: 2026-03-22

Features¶

align with MCP JSON-RPC, transport, and auth specs#: Adds MCP spec compliance for JSON-RPC 2.0, Streamable HTTP, and OAuth auth bridging.

References: https://github.com/cofin/litestar-mcp/pull/13

0.2.2¶

Released: 2025-09-30

Bugfixes¶

remove duplicate CLI pass_context decorator#: Removes a duplicate pass_context decorator from CLI commands.

References: https://github.com/cofin/litestar-mcp/pull/6

0.2.1¶

Released: 2025-09-28

Features¶

add Litestar CLI plugin integration#: Implements Litestar CLI plugin integration.

References: https://github.com/cofin/litestar-mcp/pull/5

0.2.0¶

Released: 2025-09-27

Features¶

add CLI interface#: Adds the initial command-line interface.

References: https://github.com/cofin/litestar-mcp/pull/4

0.1.0¶

Released: 2025-09-06

Features¶

initial release#: Adds the initial Litestar MCP plugin with route marking via mcp_tool and mcp_resource kwargs, automatic route discovery, REST-based MCP endpoints, OpenAPI schema exposure, MCPConfig, and support for tools and resources.

References: