README.md•4 kB
# 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/)
---