Skip to content

davila7/claude-code-templates / cli-tool/components/skills/development/fastmcp-server

fastmcp-server

Verified

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.

FileKindSize
SKILL.mdskill md7.4 KB
references/authentication/full-oauth-server.mdmarkdown5.1 KB
references/authentication/oauth-proxy.mdmarkdown31.3 KB
references/authentication/oidc-proxy.mdmarkdown9.8 KB
references/authentication/remote-oauth.mdmarkdown14.0 KB
references/authentication/token-verification.mdmarkdown17.3 KB
references/authorization.mdmarkdown13.1 KB
references/context/background-tasks.mdmarkdown10.1 KB
references/context/dependency-injection.mdmarkdown12.4 KB
references/context/mcp-context.mdmarkdown16.7 KB
references/context/user-elicitation.mdmarkdown11.4 KB
references/features/client-logging.mdmarkdown3.3 KB
references/features/icons.mdmarkdown4.3 KB
references/features/lifespans.mdmarkdown3.6 KB
references/features/middleware.mdmarkdown28.9 KB
references/features/opentelemetry.mdmarkdown9.5 KB
references/features/pagination.mdmarkdown4.2 KB
references/features/progress-reporting.mdmarkdown2.2 KB
references/features/sampling.mdmarkdown19.6 KB
references/features/storage-backends.mdmarkdown9.4 KB
references/features/versioning.mdmarkdown25.9 KB
references/getting-started/installation.mdmarkdown3.8 KB
references/getting-started/quickstart.mdmarkdown12.7 KB
references/getting-started/upgrade-guide.mdmarkdown6.4 KB
references/providers/custom.mdmarkdown15.5 KB
references/providers/filesystem.mdmarkdown17.8 KB
references/providers/local.mdmarkdown3.9 KB
references/providers/skills.mdmarkdown11.0 KB
references/server/resources-and-templates.mdmarkdown56.1 KB
references/server/server-class.mdmarkdown8.1 KB
references/server/tools.mdmarkdown41.3 KB

references/authentication/full-oauth-server.md

View on GitHub
# Full OAuth Server

> Build a self-contained authentication system where your FastMCP server manages users, issues tokens, and validates them.

> **Warning:** **This is an extremely advanced pattern that most users should avoid.** Building a secure OAuth 2.1 server requires deep expertise in authentication protocols, cryptography, and security best practices. The complexity extends far beyond initial implementation to include ongoing security monitoring, threat response, and compliance maintenance.

  **Use Remote OAuth instead** unless you have compelling requirements that external identity providers cannot meet, such as air-gapped environments or specialized compliance needs.


The Full OAuth Server pattern exists to support the MCP protocol specification's requirements. Your FastMCP server becomes both an Authorization Server and Resource Server, handling the complete authentication lifecycle from user login to token validation.

This documentation exists for completeness - the vast majority of applications should use external identity providers instead.

## OAuthProvider

FastMCP provides the `OAuthProvider` abstract class that implements the OAuth 2.1 specification. To use this pattern, you must subclass `OAuthProvider` and implement all required abstract methods.

> **Note:** `OAuthProvider` handles OAuth endpoints, protocol flows, and security requirements, but delegates all storage, user management, and business logic to your implementation of the abstract methods.


## Required Implementation

You must implement these abstract methods to create a functioning OAuth server:

### Client Management


  
    Retrieve client information by ID from your database.

    
      
        Client identifier to look up
      
    

    
      
        Client information object or `None` if client not found
      
    
  

  
    Store new client registration information in your database.

    
      
        Complete client registration information to store
      
    

    
      
        No return value
      
    
  


### Authorization Flow


  
    Handle authorization request and return redirect URL. Must implement user authentication and consent collection.

    
      
        OAuth client making the authorization request
      

      
        Authorization request parameters from the client
      
    

    
      
        Redirect URL to send the client to
      
    
  

  
    Load authorization code from storage by code string. Return `None` if code is invalid or expired.

    
      
        OAuth client attempting to use the authorization code
      

      
        Authorization code string to look up
      
    

    
      
        Authorization code object or `None` if not found
      
    
  


### Token Management


  
    Exchange authorization code for access and refresh tokens. Must validate code and create new tokens.

    
      
        OAuth client exchanging the authorization code
      

      
        Valid authorization code object to exchange
      
    

    
      
        New OAuth token containing access and refresh tokens
      
    
  

  
    Load refresh token from storage by token string. Return `None` if token is invalid or expired.

    
      
        OAuth client attempting to use the refresh token
      

      
        Refresh token string to look up
      
    

    
      
        Refresh token object or `None` if not found
      
    
  

  
    Exchange refresh token for new access/refresh token pair. Must validate scopes and token.

    
      
        OAuth client using the refresh token
      

      
        Valid refresh token object to exchange
      

      
        Requested scopes for the new access token
      
    

    
      
        New OAuth token with updated access and refresh tokens
      
    
  

  
    Load an access token by its token string.

    
      
        The access token to verify
      
    

    
      
        The access token object, or `None` if the token is invalid
      
    
  

  
    Revoke access or refresh token, marking it as invalid in storage.

    
      
        Token object to revoke and mark invalid
      
    

    
      
        No return value
      
    
  

  
    Verify bearer token for incoming requests. Return `AccessToken` if valid, `None` if invalid.

    
      
        Bearer token string from incoming request
      
    

    
      
        Access token object if valid, `None` if invalid or expired
      
    
  


Each method must handle storage, validation, security, and error cases according to the OAuth 2.1 specification. The implementation complexity is substantial and requires expertise in OAuth security considerations.

> **Warning:** **Security Notice:** OAuth server implementation involves numerous security considerations including PKCE, state parameters, redirect URI validation, token binding, replay attack prevention, and secure storage requirements. Mistakes can lead to serious security vulnerabilities.


> ## Documentation Index
> Fetch the complete documentation index at: https://gofastmcp.com/llms.txt
> Use this file to discover all available pages before exploring further.
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall