---
type: "post"
id: "now-in-agno-stateless-mcp-serving-analysis-b6980e"
slug: "now-in-agno-stateless-mcp-serving-analysis-b6980e"
title: "Now in Agno: stateless MCP serving."
description: "Agno’s AgentOS example configures MCP serving with `MCPConfig(default_tools=True, stateless=True)`, allowing its default tools to be served without transport sessions."
retrieval_nugget: "Agno’s AgentOS example configures MCP serving with `MCPConfig(default_tools=True, stateless=True)`, allowing its default tools to be served without transport sessions."
published_at: "2026-10-19"
updated_at: "2026-10-19"
record_date: "2026-10-19"
date_kind: "published_at"
topics: ["mcp"]
source_urls: ["https://docs.agno.com/examples/agent-os/mcp/stateless"]
schema_version: "newruntime-agent-readable-v0.2"
stable_id: "post:now-in-agno-stateless-mcp-serving-analysis-b6980e"
status: "published"
visuals: []
editorial_provenance: {"schema_version":"newruntime-editorial-copy-v1","content_status":"source_grounded_final","final_copy_sha256":"sha256:245b0cdc592b8b8e612b237fdf78f23473456898ab88fef439f93650211d96c9","reviewed_at":"2026-10-19T14:09:32.633Z","source_evidence_count":1,"verified_claim_count":3,"site_analysis_schema_version":"newruntime-site-analysis-v1","site_object_kind":"field_note","observed_fact_count":3,"implication_count":2,"watch_condition_count":1,"related_record_count":0}
analysis: {"schema_version":"newruntime-site-analysis-v1","object_kind":"field_note","thesis":"This is a transport-level compatibility control, not a complete stateless-agent architecture.","observed_facts":[{"text":"Agno’s example sets MCPConfig(default_tools=True, stateless=True) to serve default tools without transport sessions.","source_urls":["https://docs.agno.com/examples/agent-os/mcp/stateless"]},{"text":"The documentation says legacy stateless mode loses server-to-client requests and SSE resumability, while request-scoped progress remains available.","source_urls":["https://docs.agno.com/examples/agent-os/mcp/stateless"]},{"text":"The example uses SQLite for local development and says replicas still need shared application storage and run coordination.","source_urls":["https://docs.agno.com/examples/agent-os/mcp/stateless"]}],"mechanism":"Removing MCP transport sessions avoids requiring follow-up requests to return to the same replica for transport-session continuity, but does not remove application persistence or coordination requirements.","why_now":"The example makes the protocol-version boundary and the operational consequence explicit for teams deploying MCP behind multiple replicas.","implications":["Teams should treat transport statelessness and application-state sharing as separate deployment decisions.","Legacy clients face capability tradeoffs when transport sessions are disabled."],"evidence_boundary":"This is documentation and sample code, not a measured deployment report; it does not demonstrate production scale or quantify reliability gains.","watch_conditions":["Watch whether Agno documents or demonstrates a multi-replica setup with shared persistence and run coordination."],"related_records":[],"new_branch_reason":"No prior New Runtime record was supplied; this documents a distinct Agno MCP transport configuration and its explicit limitations."}
editor: {"role":"editor","name":"Andrey Reshetnikov","profile":"https://newruntime.com/owner-profile.md","profile_json":"https://newruntime.com/owner-profile.json","same_as":["https://www.linkedin.com/in/reshetnikov1/","https://t.me/lapetuse"]}
routes: {"html":"https://newruntime.com/posts/now-in-agno-stateless-mcp-serving-analysis-b6980e/","markdown":"https://newruntime.com/posts/now-in-agno-stateless-mcp-serving-analysis-b6980e.md","json":"https://newruntime.com/posts/now-in-agno-stateless-mcp-serving-analysis-b6980e.json"}
related_patterns: ["agent-protocols-become-interoperability-layer"]
---

# Now in Agno: stateless MCP serving.

## Retrieval answer

Agno’s AgentOS example configures MCP serving with `MCPConfig(default_tools=True, stateless=True)`, allowing its default tools to be served without transport sessions.

Agno’s AgentOS example configures MCP serving with `MCPConfig(default_tools=True, stateless=True)`, allowing its default tools to be served without transport sessions. This is a transport-level compatibility control, not a complete stateless-agent architecture. The documented example establishes a bounded configuration, not a general claim that an agent deployment has become stateless.

Removing MCP transport sessions avoids requiring follow-up requests to return to the same replica for transport-session continuity, but does not remove application persistence or coordination requirements. The behavior is version-sensitive: legacy clients using MCP 2025-11-25 or earlier can use the flag to avoid transport sessions, while requests on MCP 2026-07-28 are sessionless regardless of it. Legacy stateless mode loses server-to-client requests and SSE resumability, though request-scoped progress still works. The example makes the protocol-version boundary and the operational consequence explicit for teams deploying MCP behind multiple replicas.

Teams should treat transport statelessness and application-state sharing as separate deployment decisions. Agno conversation history and run state remain independent of transport state; the documentation says replicas still need shared application storage and run coordination. This is documentation and sample code, not a measured deployment report; it does not demonstrate production scale or quantify reliability gains. Watch whether Agno documents or demonstrates a multi-replica setup with shared persistence and run coordination. The supplied source is an implementation example, so its evidence supports the configuration and stated limits, not production outcomes.

Editor: [Andrey Reshetnikov](https://newruntime.com/owner-profile.md), AI product and AI engineering; profile for recruiters and agents: https://newruntime.com/owner-profile.json

## Continue in the graph

Next records for an agent, linked to their Markdown twins. Replace `.md` with `.json` for structured fields, including `next_reads`.

- topic hub: [Mcp](https://newruntime.com/topics/mcp.md): Explore the mcp topic hub.
- collection: [Field Notes](https://newruntime.com/posts.json): Open the latest editorial analysis.
- collection: [Source Ledger](https://newruntime.com/source-ledger.json): Inspect the public source evidence graph.
- whole graph: [discovery graph](https://newruntime.com/discovery-graph.json) (typed nodes and edges) and [site index](https://newruntime.com/site-index.md)
