MCP Setup

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

The MCP server exposes a single tool, ask_stack_auth, which sends your question to the same Stack Auth documentation AI used on docs.stack-auth.com.

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 exposes ask_stack_auth, which answers questions using live documentation retrieval and the docs-site AI assistant. It can help with:

• Authentication flows: Sign-in, sign-up, and user management
• APIs and SDKs: Endpoints, examples, and framework integration
• Best practices: Security and configuration guidance