Skip to main content

​
fastmcp.server.http

​
Functions

​
set_http_request 

set_http_request(request: Request) -> Generator[Request, None, None]

​
create_base_app 

create_base_app(routes: list[BaseRoute], middleware: list[Middleware], debug: bool = False, lifespan: Callable | None = None) -> StarletteWithLifespan
Create a base Starlette app with common middleware and routes. Args:
  • routes: List of routes to include in the app
  • middleware: List of middleware to include in the app
  • debug: Whether to enable debug mode
  • lifespan: Optional lifespan manager for the app
Returns:
  • A Starlette application

​
create_sse_app 

create_sse_app(server: FastMCP[LifespanResultT], message_path: str, sse_path: str, auth: AuthProvider | None = None, debug: bool = False, routes: list[BaseRoute] | None = None, middleware: list[Middleware] | None = None) -> StarletteWithLifespan
Return an instance of the SSE server app. Args:
  • server: The FastMCP server instance
  • message_path: Path for SSE messages
  • sse_path: Path for SSE connections
  • auth: Optional authentication provider (AuthProvider)
  • debug: Whether to enable debug mode
  • routes: Optional list of custom routes
  • middleware: Optional list of middleware
Returns: A Starlette application with RequestContextMiddleware

​
create_streamable_http_app 

create_streamable_http_app(server: FastMCP[LifespanResultT], streamable_http_path: str, event_store: EventStore | None = None, auth: AuthProvider | None = None, json_response: bool = False, stateless_http: bool = False, debug: bool = False, routes: list[BaseRoute] | None = None, middleware: list[Middleware] | None = None) -> StarletteWithLifespan
Return an instance of the StreamableHTTP server app. Args:
  • server: The FastMCP server instance
  • streamable_http_path: Path for StreamableHTTP connections
  • event_store: Optional event store for session management
  • auth: Optional authentication provider (AuthProvider)
  • json_response: Whether to use JSON response format
  • stateless_http: Whether to use stateless mode (new transport per request)
  • debug: Whether to enable debug mode
  • routes: Optional list of custom routes
  • middleware: Optional list of middleware
Returns:
  • A Starlette application with StreamableHTTP support

​
Classes

​
StreamableHTTPASGIApp

ASGI application wrapper for Streamable HTTP server transport.

​
StarletteWithLifespan

Methods:

​
lifespan 

lifespan(self) -> Lifespan[Starlette]

​
RequestContextMiddleware

Middleware that stores each request in a ContextVar