# Clerk MCP

> The Clerk MCP gives your AI client total control over user authentication and multi-tenant management. You manage users, organizations, and session data programmatically through natural language commands. It handles everything from creating new accounts via invitation to listing deep user metadata and coordinating complex team setups for any application.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Tags:** authentication, user-management, sso, multi-factor-auth, session-handling, user-profiles

## Description

This connector lets you treat user authentication like a conversation with an expert architect. Instead of digging into dashboards or running brittle scripts, your AI client manages the whole lifecycle—from onboarding new teams to checking who has access to what. You can list every registered user, grab detailed profiles for specific people, and even monitor entire multi-tenant organizations to keep track of team boundaries. It makes managing complex access controls feel simple. When you connect this MCP via Vinkius, your agent instantly gains the ability to handle invitations, ensuring new users get directed exactly where they need to go. This moves user management out of manual clicks and into direct command execution.

## Tools

### create_auth_invitation
Sends a new user invitation via email, including a custom redirect link.

### create_auth_organization
Establishes a brand-new multi-tenant structure or organization within your application.

### get_auth_user_details
Retrieves the full profile, metadata, and current status for one specific user account.

### list_auth_invitations
Fetches a list of all pending or past invitations associated with your system.

### list_auth_organizations
Retrieves an overview and slug for every active organization in the system.

### list_auth_users
Generates a comprehensive list of all user accounts currently registered.

## Prompt Examples

**Prompt:** 
```
List all registered users in my Clerk application.
```

**Response:** 
```
I've retrieved your user directory. You currently have 5 registered users, including 'John Doe' (ID: user_123) and 'Jane Smith'. Would you like the full profile metadata for any of them?
```

**Prompt:** 
```
Send an invitation to 'newuser@example.com' with redirect to 'https://vinkius.com/start'.
```

**Response:** 
```
Invitation dispatched! I've successfully sent an email invite to newuser@example.com. The invitation ID is 'inv_456'. I'll alert you as soon as they complete their registration.
```

**Prompt:** 
```
Show all active organizations and their slugs.
```

**Response:** 
```
Accessing multi-tenant data... You have 2 active organizations: 'Vinkius Enterprise' (Slug: vinkius-ent) and 'Beta Testers'. Would you like me to check for any pending invites within these teams?
```

## Capabilities

### Get User Details
Retrieve deep profiles and metadata for specific users within your application.

### List All Users
Generate a full directory listing of every account registered in the system.

### Manage Organizations
View and create multi-tenant environments to scope team collaboration and access rules.

### Create Invitations
Send custom user invitations via email, tracking them with specific redirect URLs.

### List Invitations
Check the status and details of all pending or historical user invitations.

## Use Cases

### Auditing Team Access
The security team needs to know every user in the 'Enterprise' organization. They ask their agent to run `list_auth_users` filtered by that slug, getting a real-time list of accounts and their specific roles.

### Onboarding New Clients
A sales rep needs to bring on a new client company. They ask the agent to first run `create_auth_organization` for the new entity, then immediately use `create_auth_invitation` for the primary contact.

### Debugging User Issues
A customer reports their profile data is wrong. The support agent asks the AI to run `get_auth_user_details`, instantly pulling up the accurate, detailed metadata to diagnose the issue immediately.

## Benefits

- Stop manually checking user tables. Use `list_auth_users` to get a complete directory of every registered account in seconds.
- Coordinate complex team setups by using `list_auth_organizations` to monitor all active multi-tenant environments at once.
- Speed up onboarding with `create_auth_invitation`. Send out trackable, custom invites without writing any email logic.
- Deep dive into user status. The `get_auth_user_details` tool provides instant access to a user's full profile and metadata for reporting.
- Keep your system clean by using `list_auth_invitations` to monitor who was invited, when, and if they completed registration.

## How It Works

The bottom line is that your AI acts as a dedicated auth architect, letting you manage user data without leaving your chat interface.

1. Subscribe to this MCP on Vinkius.
2. Retrieve your Secret Key from the Clerk Dashboard's API Keys section.
3. Start giving natural language commands to your AI client (Claude, Cursor, etc.) to manage users and organizations.

## Frequently Asked Questions

**How do I check who belongs to which team using list_auth_users?**
The agent lists all users and provides their associated organization or tenant slug. This helps you understand the full scope of your user base across multiple groups.

**Can I use create_auth_organization to set up a new client account?**
Yes, running `create_auth_organization` establishes the multi-tenant boundary for an entirely new company or department within your application's architecture.

**What is the difference between list_auth_invitations and list_auth_users?**
`list_auth_invitations` shows who was invited but hasn't signed up yet. `list_auth_users` only lists accounts that are fully active and registered.

**Do I need get_auth_user_details to check a user's full profile?**
Yes, `get_auth_user_details` is the dedicated tool for retrieving deep, high-fidelity metadata about any specific person in your system.

**How do I use list_auth_organizations to check all my multi-tenant environments?**
It immediately returns a directory of every organization you've created. This is vital for understanding your entire tenant structure and coordinating access control across multiple distinct client setups.

**Are there rate limits when I use create_auth_invitation for mass onboarding?**
The MCP handles standard API throttling, but if you process a large batch of invites, it's best practice to implement your own retry logic. The system will return specific error codes that tell you exactly which calls failed and why.

**What information do I get when I use get_auth_user_details for security checks?**
You receive the user's full metadata, including their current authentication status. This allows your agent to verify if an account is active or if its credentials need immediate attention.

**If I run create_auth_organization, does it affect my existing users or data?**
No, running this command creates a completely isolated new environment. It establishes a clean container for a new client setup without touching any of your pre-existing organizations or user records.

**How do I find my Clerk Secret Key?**
Log in to the [**Clerk Dashboard**](https://dashboard.clerk.com/), select your application, and navigate to **API Keys** in the sidebar.

**Can I manage organizations via AI?**
Yes! The `create_auth_organization` and `list_auth_organizations` tools allow your agent to manage B2B tenants and teams programmatically.

**How do I send a user invitation?**
Use the `create_auth_invitation` tool and provide the recipient's email address. You can also specify an optional redirect URL for the signup flow.