Skip to main content
While FlashMCP provides standalone server capabilities, you can also integrate your FlashMCP server into existing web applications. This approach is useful for:
  • Adding MCP functionality to an existing website or API
  • Mounting MCP servers under specific URL paths
  • Combining multiple services in a single application
  • Leveraging existing authentication and middleware
Please note that all FlashMCP servers have a run() method that can be used to start the server. This guide focuses on integration with broader ASGI frameworks.

​
ASGI Server

FlashMCP servers can be created as Starlette ASGI apps for straightforward hosting or integration into existing applications. The first step is to obtain a Starlette application instance from your FlashMCP server using the http_app() method:
The http_app() method is new in FlashMCP 2.3.2. In older versions, use sse_app() for SSE transport or streamable_http_app() for Streamable HTTP transport.
from FlashMCP import FlashMCP

mcp = FlashMCP("MyServer")

@mcp.tool()
def hello(name: str) -> str:
    return f"Hello, {name}!"

# Get a Starlette app instance for Streamable HTTP transport (recommended)
http_app = mcp.http_app()

# For legacy SSE transport (deprecated)
sse_app = mcp.http_app(transport="sse")
Both approaches return a Starlette application that can be integrated with other ASGI-compatible web frameworks. The returned app stores the FlashMCP instance on app.state.FlashMCP_server, so you can access it from custom middleware or routes via request.app.state.FlashMCP_server. The MCP server’s endpoint is mounted at the root path /mcp for Streamable HTTP transport, and /sse for SSE transport, though you can change these paths by passing a path argument to the http_app() method: 
# For Streamable HTTP transport
http_app = mcp.http_app(path="/custom-mcp-path")

# For SSE transport (deprecated)
sse_app = mcp.http_app(path="/custom-sse-path", transport="sse")

​
Running the Server

To run the FlashMCP server, you can use the uvicorn ASGI server: 
from FlashMCP import FlashMCP
import uvicorn

mcp = FlashMCP("MyServer")

http_app = mcp.http_app()

if __name__ == "__main__":
    uvicorn.run(http_app, host="0.0.0.0", port=8000)
Or, from the command line: 
uvicorn path.to.your.app:http_app --host 0.0.0.0 --port 8000

​
Custom Middleware

New in version: 2.3.2
 You can add custom Starlette middleware to your FlashMCP ASGI apps by passing a list of middleware instances to the app creation methods: 
from FlashMCP import FlashMCP
from starlette.middleware import Middleware
from starlette.middleware.cors import CORSMiddleware

# Create your FlashMCP server
mcp = FlashMCP("MyServer")

# Define custom middleware
custom_middleware = [
    Middleware(CORSMiddleware, allow_origins=["*"]),
]

# Create ASGI app with custom middleware
http_app = mcp.http_app(middleware=custom_middleware)

​
Starlette Integration

New in version: 2.3.1
 You can mount your FlashMCP server in another Starlette application: 
from FlashMCP import FlashMCP
from starlette.applications import Starlette
from starlette.routing import Mount

# Create your FlashMCP server as well as any tools, resources, etc.
mcp = FlashMCP("MyServer")

# Create the ASGI app
mcp_app = mcp.http_app(path='/mcp')

# Create a Starlette app and mount the MCP server
app = Starlette(
    routes=[
        Mount("/mcp-server", app=mcp_app),
        # Add other routes as needed
    ],
    lifespan=mcp_app.lifespan,
)
The MCP endpoint will be available at /mcp-server/mcp of the resulting Starlette app.
For Streamable HTTP transport, you must pass the lifespan context from the FlashMCP app to the resulting Starlette app, as nested lifespans are not recognized. Otherwise, the FlashMCP server’s session manager will not be properly initialized.

​
Nested Mounts

You can create complex routing structures by nesting mounts: 
from FlashMCP import FlashMCP
from starlette.applications import Starlette
from starlette.routing import Mount

# Create your FlashMCP server as well as any tools, resources, etc.
mcp = FlashMCP("MyServer")

# Create the ASGI app
mcp_app = mcp.http_app(path='/mcp')

# Create nested application structure
inner_app = Starlette(routes=[Mount("/inner", app=mcp_app)])
app = Starlette(
    routes=[Mount("/outer", app=inner_app)],
    lifespan=mcp_app.lifespan,
)
In this setup, the MCP server is accessible at the /outer/inner/mcp path of the resulting Starlette app.
For Streamable HTTP transport, you must pass the lifespan context from the FlashMCP app to the outer Starlette app, as nested lifespans are not recognized. Otherwise, the FlashMCP server’s session manager will not be properly initialized.

​
FastAPI Integration

New in version: 2.3.1
 FastAPI is built on Starlette, so you can mount your FlashMCP server in a similar way: 
from FlashMCP import FlashMCP
from fastapi import FastAPI
from starlette.routing import Mount

# Create your FlashMCP server as well as any tools, resources, etc.
mcp = FlashMCP("MyServer")

# Create the ASGI app
mcp_app = mcp.http_app(path='/mcp')

# Create a FastAPI app and mount the MCP server
app = FastAPI(lifespan=mcp_app.lifespan)
app.mount("/mcp-server", mcp_app)
The MCP endpoint will be available at /mcp-server/mcp of the resulting FastAPI app.
For Streamable HTTP transport, you must pass the lifespan context from the FlashMCP app to the resulting FastAPI app, as nested lifespans are not recognized. Otherwise, the FlashMCP server’s session manager will not be properly initialized.

​
Custom Routes

In addition to adding your FlashMCP server to an existing ASGI app, you can also add custom web routes to your FlashMCP server, which will be exposed alongside the MCP endpoint. To do so, use the @custom_route decorator. Note that this is less flexible than using a full ASGI framework, but can be useful for adding simple endpoints like health checks to your standalone server. 
from FlashMCP import FlashMCP
from starlette.requests import Request
from starlette.responses import PlainTextResponse

mcp = FlashMCP("MyServer")

@mcp.custom_route("/health", methods=["GET"])
async def health_check(request: Request) -> PlainTextResponse:
    return PlainTextResponse("OK")
These routes will be included in the FlashMCP app when mounted in your web application.
⌘I