Stack Auth
WelcomeGuides
SDKComponentsAPI Reference
OverviewFAQ
Getting Started
SetupComponentsUsersProductionExample-pages
Apps
API KeysEmailsOAuthOrgs and TeamsRBAC PermissionsWebhooks
Concepts
Backend IntegrationCustom User DataJWT Tokens
OAuth Providers
Stack AppTeam SelectionUser Onboarding
Customization
Custom PagesCustom StylesDark ModeInternationalization
Page Examples
Other
CLI AuthenticationSelf-hostSupabaseConvexMCP Setup
Stack Auth Docs

MCP Setup

+
MCP

Set up Stack Auth's Model Context Protocol (MCP) server to get intelligent code assistance in your development environment.

Configure Stack Auth MCP in Cursor IDE for enhanced code assistance.

CursorAdd to Cursor

Manual Installation

Add the following to your mcp.json file:

mcp.json
    {
      "mcpServers": {
        "stack-auth": {
          "url": "https://mcp.stack-auth.com/"
        }
      }
    }

Configure Stack Auth MCP in VSCode IDE for enhanced code assistance.

VSCodeAdd to VS Code

Manual Installation

Open a terminal and run the following command:

Terminal
  code --add-mcp '{"type":"http","name":"stack-auth","url":"https://mcp.stack-auth.com/"}'

Then, from inside VS Code, open the .vscode/mcp.json file and click "Start server".

Open a terminal and run the following command:

Terminal
  claude mcp add --transport http stack-auth https://mcp.stack-auth.com/

From within Claude Code, you can use the /mcp command to get more information about the server.

Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector.

Enter the name as stack-auth and the remote MCP server URL as https://mcp.stack-auth.com/.

Copy the following JSON to your Windsurf MCP config file:

mcp.json
    {
      "mcpServers": {
        "stack-auth": {
          "serverUrl": "https://mcp.stack-auth.com/"
        }
      }
    }

In Team, Enterprise, and Edu workspaces, only workspace owners and admins have permission to set this.

Navigate to Settings > Connectors Add a custom connector with the server URL: https://mcp.stack-auth.com

After this, it should be visible in Composer > Deep research Tool.

Connectors can only be used with Deep Research

Add the following JSON to your Gemini CLI configuration file (~/.gemini/settings.json):

settings.json
    {
      "mcpServers": {
        "stack-auth": {
         "httpUrl": "https://mcp.stack-auth.com/",
         "headers": {
          "Accept": "application/json, text/event-stream"
         }
        }
      }
    }

Markdown Instructions

If you want to include instructions for all clients in your project's README.md file, feel free to copy the following markdown:

<details name="mcp-install-instructions">
<summary>Cursor</summary>

#### Installation Link
[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=stack-auth&config=eyJ1cmwiOiJodHRwczovL21jcC5zdGFjay1hdXRoLmNvbS8ifQ==)

#### Manual Installation
Add the following to your `mcp.json` file:

```json
{
"mcpServers": {
  "stack-auth": {
    "url": "https://mcp.stack-auth.com/"
  }
}
}
```
</details>

<details name="mcp-install-instructions">
<summary>VSCode</summary>

#### Installation Link
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visual-studio-code&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode:mcp/install?%7B%22type%22%3A%22http%22%2C%22name%22%3A%22stack-auth%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.stack-auth.com%2F%22%7D)

#### Manual Installation
Open a terminal and run the following command:

```
code --add-mcp '{"type":"http","name":"stack-auth","url":"https://mcp.stack-auth.com/"}'
```

Then, from inside VS Code, open the .vscode/mcp.json file and click "Start server".
</details>

<details name="mcp-install-instructions">
<summary>Claude Code</summary>

Open a terminal and run the following command:
```
claude mcp add --transport http stack-auth https://mcp.stack-auth.com/
```
From within Claude Code, you can use the `/mcp` command to get more information about the server.
</details>

<details name="mcp-install-instructions">
<summary>Claude Desktop</summary>

Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector.

Enter the name as `stack-auth` and the remote MCP server URL as `https://mcp.stack-auth.com/`.
</details>

<details name="mcp-install-instructions">
<summary>Windsurf</summary>

Copy the following JSON to your Windsurf MCP config file:
```json
{
"mcpServers": {
  "stack-auth": {
    "serverUrl": "https://mcp.stack-auth.com/"
  }
}
}
```
</details>

<details name="mcp-install-instructions">
<summary>ChatGPT</summary>

*Note: In Team, Enterprise, and Edu workspaces, only workspace owners and admins have permission*

- Navigate to **Settings > Connectors**
- Add a custom connector with the server URL: `https://mcp.stack-auth.com/`
- It should then be visible in the Composer > Deep research tool
- You may need to add the server as a source

*Connectors can only be used with **Deep Research***
</details>

<details name="mcp-install-instructions">
<summary>Gemini CLI</summary>

Add the following JSON to your Gemini CLI configuration file (`~/.gemini/settings.json`):
```json
{
"mcpServers": {
  "stack-auth": {
    "httpUrl": "https://mcp.stack-auth.com/",
    "headers": {
      "Accept": "application/json, text/event-stream"
    }
  }
}
}
```
</details>

by [![Hypr MCP](https://hyprmcp.com/hyprmcp_20px.svg)](https://hyprmcp.com/)

Features

The Stack Auth MCP server provides:

  • Authentication Flow Assistance: Get help implementing sign-in, sign-up, and user management
  • API Documentation: Access Stack Auth API documentation and examples
  • Code Generation: Generate boilerplate code for common authentication patterns
  • Best Practices: Receive guidance on security best practices and implementation patterns
Previous PageConvex

On this page

Markdown InstructionsFeatures

Stack Auth AI

Experimental: AI responses may not always be accurate—please verify important details.

For the most accurate information, please join our Discord or email us.

How can I help?

Ask me about Stack Auth while you browse the docs.