FastMCP 3.0 Server Development
Complete reference for building production-ready MCP (Model Context Protocol) servers with FastMCP 3.0 - the fast, Pythonic framework for connecting LLMs to tools and data.
When to use this skill
Use FastMCP Server when:
- Creating a new MCP server in Python
- Adding tools, resources, or prompts to an MCP server
- Implementing authentication (OAuth, OIDC, token verification)
- Setting up middleware for logging, rate limiting, or authorization
- Configuring providers (local, filesystem, skills, custom)
- Building production MCP servers with telemetry and storage
- Upgrading from FastMCP 2.x to 3.0
Key areas covered:
- Tools & Resources (CORE): Decorators, validation, return types, templates
- Context & DI (CORE): MCP context, dependency injection, background tasks
- Authentication (SECURITY): OAuth, OIDC, token verification, proxy patterns
- Authorization (SECURITY): Scope-based and role-based access control
- Middleware (ADVANCED): Request/response pipeline, built-in middleware
- Providers (ADVANCED): Local, filesystem, skills, and custom providers
- Features (ADVANCED): Pagination, sampling, storage, OpenTelemetry, versioning
Quick reference
Core patterns
Create a server with tools:
from fastmcp import FastMCP
mcp = FastMCP("MyServer")
@mcp.tool
def add(a: int, b: int) -> int:
"""Add two numbers"""
return a + b
Create a resource:
@mcp.resource("data://config")
def get_config() -> dict:
"""Return server configuration"""
return {"version": "1.0", "debug": False}
Create a resource template:
@mcp.resource("users://{user_id}/profile")
def get_user_profile(user_id: str) -> dict:
"""Get a user's profile by ID"""
return fetch_user(user_id)
Create a prompt:
@mcp.prompt
def review_code(code: str, language: str = "python") -> str:
"""Review code for best practices"""
return f"Review this {language} code:\n\n{code}"
Run the server:
if __name__ == "__main__":
mcp.run()
# Or with transport options:
# mcp.run(transport="sse", host="0.0.0.0", port=8000)
Using context in tools
from fastmcp import FastMCP, Context
mcp = FastMCP("MyServer")
@mcp.tool
def process_data(uri: str, ctx: Context) -> str:
"""Process data with logging and progress"""
ctx.info(f"Processing {uri}")
ctx.report_progress(0, 100)
data = ctx.read_resource(uri)
ctx.report_progress(100, 100)
return f"Processed: {data}"
Authentication setup
from fastmcp import FastMCP
from fastmcp.server.auth import BearerAuthProvider
auth = BearerAuthProvider(
jwks_uri="https://your-provider/.well-known/jwks.json",
audience="your-api",
issuer="https://your-provider/"
)
mcp = FastMCP("SecureServer", auth=auth)
Key concepts
Tools
Functions exposed as executable capabilities for LLMs. Decorated with @mcp.tool. Support Pydantic validation, async, custom return types, and annotations (readOnlyHint, destructiveHint).
Resources & Templates
Static or dynamic data sources identified by URIs. Resources use fixed URIs (data://config), templates use parameterized URIs (users://{id}/profile). Support MIME types, annotations, and wildcard parameters.
Context
The Context object provides access to MCP features within tools/resources: logging, progress reporting, resource access, LLM sampling, user elicitation, and session state.
Dependency Injection
Inject values into tool/resource functions using Depends(). Supports HTTP requests, access tokens, custom dependencies, and generator-based cleanup patterns.
Providers
Control where components come from. LocalProvider (default, decorator-based), FileSystemProvider (load from Python files on disk), SkillsProvider (packaged bundles), or custom providers.
Authentication & Authorization
Multiple auth patterns: token verification (JWT, JWKS), OAuth proxy, OIDC proxy, remote OAuth, and full OAuth server. Authorization via scopes on components and middleware.
Middleware
Intercept and modify requests/responses. Built-in middleware for rate limiting, error handling, logging, and response size limits. Custom middleware via @mcp.middleware.
Using the references
Detailed documentation is organized in the references/ folder:
Getting Started
- getting-started/installation.md - Install FastMCP, optional dependencies, verify setup
- getting-started/upgrade-guide.md - Migrate from FastMCP 2.x to 3.0
- getting-started/quickstart.md - First server, tools, resources, prompts, running
Server
- server/server-class.md - FastMCP server configuration, transport options, tag filtering
- server/tools.md - Tool decorator, parameters, validation, return types, annotations
- server/resources-and-templates.md - Resources, templates, URIs, wildcards, MIME types
Context
- context/mcp-context.md - Context object, logging, progress, resource access, sampling
- context/background-tasks.md - Long-running operations with task support
- context/dependency-injection.md - Depends(), custom deps, HTTP request, access tokens
- context/user-elicitation.md - Request structured input from users during execution
Features
- features/icons.md - Custom icons for tools, resources, prompts, and servers
- features/lifespans.md - Server lifecycle management and startup/shutdown hooks
- features/client-logging.md - Send log messages to MCP clients
- features/middleware.md - Request/response pipeline, built-in and custom middleware
- features/pagination.md - Paginate large component lists
- features/progress-reporting.md - Report progress for long-running operations
- features/sampling.md - Request LLM completions from the client
- features/storage-backends.md - Memory, file, and Redis storage for caching and tokens
- features/opentelemetry.md - Distributed tracing and observability
- features/versioning.md - Version components and filter by version ranges
Authentication
- authentication/token-verification.md - JWT, JWKS, introspection, static keys, custom
- authentication/remote-oauth.md - Delegate auth to upstream OAuth provider
- authentication/oauth-proxy.md - Full OAuth proxy with PKCE, client management
- authentication/oidc-proxy.md - OpenID Connect proxy with auto-discovery
- authentication/full-oauth-server.md - Complete built-in OAuth server
Authorization
- authorization.md - Scope-based access control, middleware authorization, patterns
Providers
- providers/local.md - Default provider, decorator-based component registration
- providers/filesystem.md - Load components from Python files on disk
- providers/skills.md - Package and distribute component bundles
- providers/custom.md - Build custom providers for any component source
Version history
v1.0.0 (February 2026)
- Initial release covering FastMCP 3.0 (release candidate)
- 30 reference files across 7 categories
- Complete coverage of tools, resources, context, auth, providers, and features
Converted and distributed by TomeVault | Claim this content
1---2name: fastmcp-server3description: Complete guide for building MCP servers with FastMCP 3.0 - tools, resources, authentication, providers, middleware, and deployment. Use when creating Python MCP servers or integrating AI models with external tools and data.4version: 1.0.05author: FastMCP Community6license: MIT7tags: [FastMCP, MCP, Python, AI, Tools, Server, Authentication, Providers]8dependencies: []9metadata:10 source: https://skillmd.com/skills/mahabdalla/fastmcp-server11---1213# FastMCP 3.0 Server Development1415Complete reference for building production-ready MCP (Model Context Protocol) servers with FastMCP 3.0 - the fast, Pythonic framework for connecting LLMs to tools and data.1617## When to use this skill1819**Use FastMCP Server when:**20- Creating a new MCP server in Python21- Adding tools, resources, or prompts to an MCP server22- Implementing authentication (OAuth, OIDC, token verification)23- Setting up middleware for logging, rate limiting, or authorization24- Configuring providers (local, filesystem, skills, custom)25- Building production MCP servers with telemetry and storage26- Upgrading from FastMCP 2.x to 3.02728**Key areas covered:**29- **Tools & Resources** (CORE): Decorators, validation, return types, templates30- **Context & DI** (CORE): MCP context, dependency injection, background tasks31- **Authentication** (SECURITY): OAuth, OIDC, token verification, proxy patterns32- **Authorization** (SECURITY): Scope-based and role-based access control33- **Middleware** (ADVANCED): Request/response pipeline, built-in middleware34- **Providers** (ADVANCED): Local, filesystem, skills, and custom providers35- **Features** (ADVANCED): Pagination, sampling, storage, OpenTelemetry, versioning3637## Quick reference3839### Core patterns4041**Create a server with tools:**42```python43from fastmcp import FastMCP4445mcp = FastMCP("MyServer")4647@mcp.tool48def add(a: int, b: int) -> int:49 """Add two numbers"""50 return a + b51```5253**Create a resource:**54```python55@mcp.resource("data://config")56def get_config() -> dict:57 """Return server configuration"""58 return {"version": "1.0", "debug": False}59```6061**Create a resource template:**62```python63@mcp.resource("users://{user_id}/profile")64def get_user_profile(user_id: str) -> dict:65 """Get a user's profile by ID"""66 return fetch_user(user_id)67```6869**Create a prompt:**70```python71@mcp.prompt72def review_code(code: str, language: str = "python") -> str:73 """Review code for best practices"""74 return f"Review this {language} code:\n\n{code}"75```7677**Run the server:**78```python79if __name__ == "__main__":80 mcp.run()8182# Or with transport options:83# mcp.run(transport="sse", host="0.0.0.0", port=8000)84```8586### Using context in tools8788```python89from fastmcp import FastMCP, Context9091mcp = FastMCP("MyServer")9293@mcp.tool94def process_data(uri: str, ctx: Context) -> str:95 """Process data with logging and progress"""96 ctx.info(f"Processing {uri}")97 ctx.report_progress(0, 100)98 data = ctx.read_resource(uri)99 ctx.report_progress(100, 100)100 return f"Processed: {data}"101```102103### Authentication setup104105```python106from fastmcp import FastMCP107from fastmcp.server.auth import BearerAuthProvider108109auth = BearerAuthProvider(110 jwks_uri="https://your-provider/.well-known/jwks.json",111 audience="your-api",112 issuer="https://your-provider/"113)114115mcp = FastMCP("SecureServer", auth=auth)116```117118## Key concepts119120### Tools121Functions exposed as executable capabilities for LLMs. Decorated with `@mcp.tool`. Support Pydantic validation, async, custom return types, and annotations (readOnlyHint, destructiveHint).122123### Resources & Templates124Static or dynamic data sources identified by URIs. Resources use fixed URIs (`data://config`), templates use parameterized URIs (`users://{id}/profile`). Support MIME types, annotations, and wildcard parameters.125126### Context127The `Context` object provides access to MCP features within tools/resources: logging, progress reporting, resource access, LLM sampling, user elicitation, and session state.128129### Dependency Injection130Inject values into tool/resource functions using `Depends()`. Supports HTTP requests, access tokens, custom dependencies, and generator-based cleanup patterns.131132### Providers133Control where components come from. `LocalProvider` (default, decorator-based), `FileSystemProvider` (load from Python files on disk), `SkillsProvider` (packaged bundles), or custom providers.134135### Authentication & Authorization136Multiple auth patterns: token verification (JWT, JWKS), OAuth proxy, OIDC proxy, remote OAuth, and full OAuth server. Authorization via scopes on components and middleware.137138### Middleware139Intercept and modify requests/responses. Built-in middleware for rate limiting, error handling, logging, and response size limits. Custom middleware via `@mcp.middleware`.140141## Using the references142143Detailed documentation is organized in the `references/` folder:144145### Getting Started146- **getting-started/installation.md** - Install FastMCP, optional dependencies, verify setup147- **getting-started/upgrade-guide.md** - Migrate from FastMCP 2.x to 3.0148- **getting-started/quickstart.md** - First server, tools, resources, prompts, running149150### Server151- **server/server-class.md** - FastMCP server configuration, transport options, tag filtering152- **server/tools.md** - Tool decorator, parameters, validation, return types, annotations153- **server/resources-and-templates.md** - Resources, templates, URIs, wildcards, MIME types154155### Context156- **context/mcp-context.md** - Context object, logging, progress, resource access, sampling157- **context/background-tasks.md** - Long-running operations with task support158- **context/dependency-injection.md** - Depends(), custom deps, HTTP request, access tokens159- **context/user-elicitation.md** - Request structured input from users during execution160161### Features162- **features/icons.md** - Custom icons for tools, resources, prompts, and servers163- **features/lifespans.md** - Server lifecycle management and startup/shutdown hooks164- **features/client-logging.md** - Send log messages to MCP clients165- **features/middleware.md** - Request/response pipeline, built-in and custom middleware166- **features/pagination.md** - Paginate large component lists167- **features/progress-reporting.md** - Report progress for long-running operations168- **features/sampling.md** - Request LLM completions from the client169- **features/storage-backends.md** - Memory, file, and Redis storage for caching and tokens170- **features/opentelemetry.md** - Distributed tracing and observability171- **features/versioning.md** - Version components and filter by version ranges172173### Authentication174- **authentication/token-verification.md** - JWT, JWKS, introspection, static keys, custom175- **authentication/remote-oauth.md** - Delegate auth to upstream OAuth provider176- **authentication/oauth-proxy.md** - Full OAuth proxy with PKCE, client management177- **authentication/oidc-proxy.md** - OpenID Connect proxy with auto-discovery178- **authentication/full-oauth-server.md** - Complete built-in OAuth server179180### Authorization181- **authorization.md** - Scope-based access control, middleware authorization, patterns182183### Providers184- **providers/local.md** - Default provider, decorator-based component registration185- **providers/filesystem.md** - Load components from Python files on disk186- **providers/skills.md** - Package and distribute component bundles187- **providers/custom.md** - Build custom providers for any component source188189## Version history190191**v1.0.0** (February 2026)192- Initial release covering FastMCP 3.0 (release candidate)193- 30 reference files across 7 categories194- Complete coverage of tools, resources, context, auth, providers, and features195196---197> Converted and distributed by [TomeVault](https://tomevault.io) | [Claim this content](https://tomevault.io/claim/davila7/claude-code-templates)