---
schema: rendered-html/v1
title: "Discord OAuth 🤝 FastMCP - FastMCP"
source_url: https://gofastmcp.com/integrations/discord
generated_at: 2026-06-11T19:42:06.095474+00:00
---




[FastMCP home page![light logo](images/gofastmcp__com__integrations__discord__wordmark.avif)![dark logo](images/gofastmcp__com__integrations__discord__wordmark-white.avif)](gofastmcp__com.md)







Auth

Discord OAuth 🤝 FastMCP



















  - [Auth0](gofastmcp__com__integrations__auth0.md)
  - [AuthKit](gofastmcp__com__integrations__authkit.md)
  - [AWS Cognito](gofastmcp__com__integrations__aws-cognito.md)
  - [Azure (Entra ID)](gofastmcp__com__integrations__azure.md)
  - [Descope](gofastmcp__com__integrations__descope.md)
  - [Discord](/integrations/discord)
  - [Eunomia Auth](gofastmcp__com__integrations__eunomia-authorization.md)
  - [GitHub](gofastmcp__com__integrations__github.md)
  - [Google](gofastmcp__com__integrations__google.md)
  - [Keycloak

    NEW](gofastmcp__com__integrations__keycloak.md)
  - [Oracle](gofastmcp__com__integrations__oci.md)
  - [Permit.io](gofastmcp__com__integrations__permit.md)
  - [PropelAuth](gofastmcp__com__integrations__propelauth.md)
  - [Scalekit](gofastmcp__com__integrations__scalekit.md)
  - [Supabase](gofastmcp__com__integrations__supabase.md)
  - [WorkOS](gofastmcp__com__integrations__workos.md)




- [Configuration](#configuration)
  - [Prerequisites](#prerequisites)
  - [Step 1: Create a Discord Application](#step-1-create-a-discord-application)
  - [Step 2: FastMCP Configuration](#step-2-fastmcp-configuration)
- [Testing](#testing)
  - [Running the Server](#running-the-server)
  - [Testing with a Client](#testing-with-a-client)
- [Discord Scopes](#discord-scopes)
- [Production Configuration](#production-configuration)

Auth

# Discord OAuth 🤝 FastMCP


Secure your FastMCP server with Discord OAuth


New in version `2.13.2`
This guide shows you how to secure your FastMCP server using **Discord OAuth**. Since Discord doesn’t support Dynamic Client Registration, this integration uses the [**OAuth Proxy**](gofastmcp__com__servers__auth__oauth-proxy.md) pattern to bridge Discord’s traditional OAuth with MCP’s authentication requirements.

## [​](#configuration) Configuration

### [​](#prerequisites) Prerequisites

Before you begin, you will need:

1. A **[Discord Account](https://discord.com/)** with access to create applications
2. Your FastMCP server’s URL (can be localhost for development, e.g., `http://localhost:8000`)

### [​](#step-1-create-a-discord-application) Step 1: Create a Discord Application

Create an application in the Discord Developer Portal to get the credentials needed for authentication:

1

Navigate to Discord Developer Portal

Go to the [Discord Developer Portal](https://discord.com/developers/applications).Click **“New Application”** and give it a name users will recognize (e.g., “My FastMCP Server”).

2

Configure OAuth2 Settings

In the left sidebar, click **“OAuth2”**.In the **Redirects** section, click **“Add Redirect”** and enter your callback URL:

- For development: `http://localhost:8000/auth/callback`
- For production: `https://your-domain.com/auth/callback`

The redirect URL must match exactly. The default path is `/auth/callback`, but you can customize it using the `redirect_path` parameter. Discord allows `http://localhost` URLs for development. For production, use HTTPS.

3

Save Your Credentials

On the same OAuth2 page, you’ll find:

- **Client ID**: A numeric string like `12345`
- **Client Secret**: Click “Reset Secret” to generate one

Store these credentials securely. Never commit them to version control. Use environment variables or a secrets manager in production.

### [​](#step-2-fastmcp-configuration) Step 2: FastMCP Configuration

Create your FastMCP server using the `DiscordProvider`, which handles Discord’s OAuth flow automatically:


from fastmcp.server.auth.providers.discord import DiscordProvider

auth_provider = DiscordProvider(
    client_id="12345",      # Your Discord Application Client ID
    client_secret="your-client-secret",    # Your Discord OAuth Client Secret
    base_url="http://localhost:8000",      # Must match your OAuth configuration

mcp = FastMCP(name="Discord Secured App", auth=auth_provider)

async def get_user_info() -> dict:
    """Returns information about the authenticated Discord user."""
    from fastmcp.server.dependencies import get_access_token

    token = get_access_token()
    return {
        "discord_id": token.claims.get("sub"),
        "username": token.claims.get("username"),
        "avatar": token.claims.get("avatar"),

## [​](#testing) Testing

### [​](#running-the-server) Running the Server

Start your FastMCP server with HTTP transport to enable OAuth flows:

fastmcp run server.py --transport http --port 8000

Your server is now running and protected by Discord OAuth authentication.

### [​](#testing-with-a-client) Testing with a Client

Create a test client that authenticates with your Discord-protected server:

test\_client.py

import asyncio

async def main():
    async with Client("http://localhost:8000/mcp", auth="oauth") as client:
        print("✓ Authenticated with Discord!")

        result = await client.call_tool("get_user_info")
        print(f"Discord user: {result['username']}")

    asyncio.run(main())

When you run the client for the first time:

1. Your browser will open to Discord’s authorization page
2. Sign in with your Discord account and authorize the app
3. After authorization, you’ll be redirected back
4. The client receives the token and can make authenticated requests

The client caches tokens locally, so you won’t need to re-authenticate for subsequent runs unless the token expires or you explicitly clear the cache.

## [​](#discord-scopes) Discord Scopes

Discord OAuth supports several scopes for accessing different types of user data:

| Scope | Description |
| --- | --- |
| `identify` | Access username, avatar, and discriminator (default) |
| `email` | Access the user’s email address |
| `guilds` | Access the user’s list of servers |
| `guilds.join` | Ability to add the user to a server |

To request additional scopes:

auth_provider = DiscordProvider(
    client_id="...",
    client_secret="...",
    base_url="http://localhost:8000",
    required_scopes=["identify", "email"],

## [​](#production-configuration) Production Configuration

For production deployments with persistent token management across server restarts, configure `jwt_signing_key` and `client_storage`:


import os
from fastmcp.server.auth.providers.discord import DiscordProvider
from key_value.aio.stores.redis import RedisStore
from key_value.aio.wrappers.encryption import FernetEncryptionWrapper
from cryptography.fernet import Fernet

auth_provider = DiscordProvider(
    client_id="12345",
    client_secret=os.environ["DISCORD_CLIENT_SECRET"],
    base_url="https://your-production-domain.com",

    jwt_signing_key=os.environ["JWT_SIGNING_KEY"],
    client_storage=FernetEncryptionWrapper(
        key_value=RedisStore(
            host=os.environ["REDIS_HOST"],
            port=int(os.environ["REDIS_PORT"])
        fernet=Fernet(os.environ["STORAGE_ENCRYPTION_KEY"])

mcp = FastMCP(name="Production Discord App", auth=auth_provider)

Parameters (`jwt_signing_key` and `client_storage`) work together to ensure tokens and client registrations survive server restarts. **Wrap your storage in `FernetEncryptionWrapper` to encrypt sensitive OAuth tokens at rest** - without it, tokens are stored in plaintext. Store secrets in environment variables and use a persistent storage backend like Redis for distributed deployments.For complete details on these parameters, see the [OAuth Proxy documentation](gofastmcp__com__servers__auth__oauth-proxy.md).

[Descope 🤝 FastMCP

Previous](gofastmcp__com__integrations__descope.md)[Eunomia Authorization 🤝 FastMCP

Next](gofastmcp__com__integrations__eunomia-authorization.md)






