Starstruk Logo MarkStarstruk

v3.0.6

agno-agi/agnov3.0.6Sep 4, 2026by kausmeows

AI Summary

This release focuses on enhancing Model Context Protocol (MCP) capabilities with stateless serving and protocol negotiation, while adding file upload support and various bug fixes to AgentOS.

Key Highlights

  • Stateless MCP serving allows multi-instance deployments without session affinity.
  • MCP protocol era negotiation enables support for legacy and modern sessionless protocols.
  • New AgentOS MCP Server Card exposes served tools and metadata.
  • Support added for .zip and .eml file uploads in AgentOS.
  • Bedrock integration now supports passing custom async clients.

New Features

  • Stateless MCP serving using `MCPConfig(stateless=True)`
  • Protocol era selection via `MCPTools(protocol_mode=...)`
  • AgentOS MCP Server Card at `/mcp/server-card`
  • File upload support for .zip and .eml formats
  • Public route configuration via `AuthorizationConfig.excluded_route_paths`
  • Bedrock async client passthrough support

Full Release Notes

# **Changelog**

## New Features

- **Stateless MCP serving.** `MCPConfig(stateless=True)` serves `/mcp` without session tracking, so any replica can answer any request and a multi-instance deployment needs no session affinity. Costs server-initiated notifications and SSE resumability, so it stays off by default. See [cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/05_agent_os/14_mcp/stateless.py).
- **`MCPTools(protocol_mode=...)`** selects which MCP protocol era to negotiate. Defaults to `"legacy"`, preserving today's session-based behaviour; `"auto"` negotiates the newest era both sides support (sessionless from `2026-07-28`). Existing servers are unaffected — a modern server still accepts the legacy handshake. Internally, MCP clients are now built on `fastmcp.Client`. See [cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/mcp/protocol_mode.py).
- **AgentOS MCP Server Card** at `GET /mcp/server-card`, listing the served tools and carrying a configurable name, version and instructions.
- `.zip` and `.eml` file uploads in AgentOS. See [cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/05_agent_os/04_run_lifecycle/unpack_archives.py).
- **`AuthorizationConfig.excluded_route_paths`** marks custom routes public without disabling auth globally.
- **Bedrock**: pass your own async client to the model or embedder.

## **Bug Fixes**

- **Anthropic**: replay assistant turns verbatim so thinking blocks are no longer rejected.
- **Gemini**: resolve image MIME type instead of hard-coding `image/jpeg`.
- **RecursiveChunking**: stop emitting duplicate trailing chunks.
- **AG-UI**: send wire fields instead of `RunContext` to remote entities.
- **AG-UI**: expose streamed run errors.
- Pin `tree-sitter-language-pack<1.16` to unblock the chonkie code chunker.

## What's Changed
* [fix] Resolve Gemini image MIME type instead of hard-coding image/jpeg by @BlueX888 in https://github.com/agno-agi/agno/pull/9887
* fix: pin tree-sitter-language-pack<1.16 to unblock chonkie code chunker by @Himanshu040604 in https://github.com/agno-agi/agno/pull/9901
* feat: migrate MCP client and AgentOS server to mcp 2.x by @ProgrammerPlus1998 in https://github.com/agno-agi/agno/pull/9269
* [fix] expose streamed AG-UI run errors by @uuzzrm in https://github.com/agno-agi/agno/pull/9487
* feat: Support provided bedrock async client by @ddellspe-vl in https://github.com/agno-agi/agno/pull/9531
* fix: send wire fields instead of RunContext to remote entities over AG-UI by @Himanshu040604 in https://github.com/agno-agi/agno/pull/9909
* cookbook: add gemini-3.8-flash examples by @kausmeows in https://github.com/agno-agi/agno/pull/9916
* fix: stop RecursiveChunking from emitting duplicate trailing chunks by @devYRPauli in https://github.com/agno-agi/agno/pull/9919
* feat: name, version and instructions for the AgentOS MCP server by @ashpreetbedi in https://github.com/agno-agi/agno/pull/9930
* fix: replay Anthropic assistant turns verbatim so thinking blocks are not rejected by @ysolanky in https://github.com/agno-agi/agno/pull/9924
* feat: MCP Server Card at /mcp/server-card by @ashpreetbedi in https://github.com/agno-agi/agno/pull/9932
* feat: list the served tools on the MCP Server Card by @sannya-singal in https://github.com/agno-agi/agno/pull/9949
* feat: add AuthorizationConfig.excluded_route_paths for custom public routes by @kinKingen in https://github.com/agno-agi/agno/pull/9295
* feat: support .zip and .eml file uploads in AgentOS by @luisnmartins in https://github.com/agno-agi/agno/pull/9193
* chore: make AGENTS.md a symlink to CLAUDE.md by @ysolanky in https://github.com/agno-agi/agno/pull/9813
* feat: add stateless MCP transport and build MCP clients on `fastmcp.Client` by @sannya-singal in https://github.com/agno-agi/agno/pull/9927
* chore: Release v3.0.6 by @sannya-singal in https://github.com/agno-agi/agno/pull/9907

## New Contributors
* @BlueX888 made their first contribution in https://github.com/agno-agi/agno/pull/9887
* @uuzzrm made their first contribution in https://github.com/agno-agi/agno/pull/9487
* @ddellspe-vl made their first contribution in https://github.com/agno-agi/agno/pull/9531
* @kinKingen made their first contribution in https://github.com/agno-agi/agno/pull/9295

**Full Changelog**: https://github.com/agno-agi/agno/compare/v3.0.5...v3.0.6