AuthJoy MCP Server

AI-powered authentication tools for Claude and AI assistants.

Quick Start

Option 1: Browser Login (Recommended)

npx @authjoyio/mcp login

Then add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "authjoy": {
      "command": "npx",
      "args": ["@authjoyio/mcp", "serve"]
    }
  }
}

Option 2: API Key

{
  "mcpServers": {
    "authjoy": {
      "command": "npx",
      "args": ["@authjoyio/mcp"],
      "env": {
        "AUTHJOY_API_KEY": "aj_live_xxxxx",
        "AUTHJOY_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

What Can Claude Do With This?

Ask Claude things like:

• "Add email/password authentication to my app"
• "Help me implement Google social login"
• "Set up MFA for my users"
• "Explain how magic link auth works"
• "Check for security risks in my auth setup"

Tool Presets

Focus on what you need with presets:

| Preset | Tools | Best For | | ------------ | ------------------------------------------- | --------------------- | | simple | signup, signin, social auth, password reset | Getting started | | saas | simple + magic links, user management | SaaS apps | | enterprise | all core + MFA, sessions, audit tools | Enterprise apps | | full | Everything | Full access (default) |

Use a preset:

{
  "args": ["@authjoyio/mcp", "serve", "--preset=saas"]
}

CLI Commands

| Command | Description | | -------- | ------------------------ | | login | Authenticate via browser | | logout | Clear stored credentials | | serve | Start MCP server | | status | Show auth status | | config | View/edit settings |

# Check your status
npx @authjoyio/mcp status

# Change default preset
npx @authjoyio/mcp config --set defaultPreset=saas

# View config
npx @authjoyio/mcp config --list

Available Tools

Core Authentication

• user_signup - Register new users
• user_signin - Email/password login
• social_auth_url - Google, GitHub, etc.
• magic_link_send - Passwordless login
• password_reset_request - Send reset email
• password_reset_confirm - Complete reset

User Management

• user_get - Get user profile
• user_update - Update profile
• user_delete - Delete account

Multi-Factor Auth

• mfa_enroll - Enable MFA
• mfa_verify - Verify codes
• mfa_unenroll - Disable MFA

Sessions

• session_list - List active sessions
• session_revoke - Revoke session
• session_revoke_all - Sign out everywhere

AI-Powered Tools

• explain_auth_flow - Step-by-step implementation guides
• check_risky_users - Find security risks
• suggest_improvements - Security recommendations
• audit_activity - Recent auth events

Configuration

Credentials are stored in ~/.authjoy/config.json after login.

Environment variables (override stored config):

• AUTHJOY_API_KEY - Your API key
• AUTHJOY_TENANT_ID - Your tenant ID
• AUTHJOY_API_URL - API URL (default: https://api.authjoy.io)

Learn More

• AuthJoy Documentation
• MCP Protocol
• Get API Key

License

MIT