Better Auth MCP Server

# Better Auth MCP Server [](https://smithery.ai/server/@dabhivijay2478/auth) A modern **Model Context Protocol (MCP) server** for the [Better Auth](https://better-auth.com/docs) authentication framework. This server provides **developer-friendly tools, searchable documentation, ready-to-use integrations, and configuration generators** for authentication providers, database adapters, and plugins. --- ## ✨ Highlights - 📚 **Full Documentation Access** – categorized, searchable, and framework-specific examples - 🔐 **Authentication Providers** – Email/Password, Google, GitHub, Apple, Microsoft, Facebook, and more - 🗄️ **Database Adapters** – PostgreSQL, MySQL, SQLite, MongoDB, Prisma, Drizzle - 🔧 **Plugins & Extensions** – OTP, Magic Link, 2FA, Passkey, Organization Management, API Tokens - ⚙️ **Smart Tools** – Config generation, validation, migration guides, and framework integration - 🔒 **Security Built-in** – CSRF protection, secure cookies, rate limiting, WebAuthn/Passkeys, 2FA --- ## 🚀 Quick Start ### Install via Smithery (Recommended) ```bash npx -y @smithery/cli install @dabhivijay2478/auth --client claude ```` ### Manual Setup ```bash git clone <repository-url> cd better-auth-mcp-server npm install npm run build ``` Update `claude_desktop_config.json`: ```json { "mcpServers": { "better-auth": { "command": "node", "args": ["path/to/dist/index.js"], "env": { "NODE_ENV": "production" } } } } ``` --- ## 🛠️ Core Tools ### Documentation * `list_better_auth_features` – List all available features and plugins * `get_feature_details` – Get details for a specific feature or plugin * `search_better_auth` – Search Better Auth documentation ### Integrations * `get_integration_guide` – Framework-specific setup (Next.js, Nuxt, Remix, SvelteKit, Expo, etc.) * `get_auth_examples` – Code snippets and usage examples ### Advanced Context * `target_llms_context` – Access **Better Auth LLMs.txt** for comprehensive context --- ## 📦 Usage Examples ### 1. Generate a Complete Auth Config ```javascript const setup = await generate_auth_config({ providers: ["email-password", "google", "github"], adapter: "postgresql", plugins: ["magic-link", "two-factor"], framework: "nextjs" }); console.log(setup.serverConfig); ``` ### 2. Get Provider Config ```javascript const google = await get_auth_provider_config({ provider_name: "google" }); console.log(google.setupSteps); ``` ### 3. Validate Config ```javascript const validation = await validate_auth_setup({ config: "your auth.ts config here", framework: "nextjs" }); console.log(validation); ``` --- ## 🔐 Security Features * **CSRF Protection** – Safe request handling * **Session Security** – Rotation, expiration, validation * **Passkeys & WebAuthn** – FIDO2 support * **Two-Factor Auth** – TOTP, backup codes * **Rate Limiting** – Prevent abuse * **Password Security** – Strong hashing and validation --- ## 🏗️ Architecture * **Language:** TypeScript (ES2022 target) * **Validation:** Zod schemas * **Protocol:** Model Context Protocol (MCP) * **Code Generation:** Production-ready configs and migration scripts * **Error Handling:** Detailed and recoverable --- ## 🤝 Contributing 1. Clone repo 2. Install dependencies: `npm install` 3. Build: `npm run build` 4. Update `src/index.ts` with new features When Better Auth adds features: * Extend **AUTH\_PROVIDERS**, **DATABASE\_ADAPTERS**, **PLUGINS** * Add documentation mappings * Write tool handlers * Test thoroughly --- ## 📄 License MIT License – see LICENSE file --- ## 🔗 Resources * [Better Auth Docs](https://better-auth.com/docs) * [Smithery Package](https://smithery.ai/server/@dabhivijay2478/auth) * [MCP Protocol](https://modelcontextprotocol.io/) * [TypeScript Docs](https://www.typescriptlang.org/) ---