# Memberstack MCP

> Memberstack MCP gives your AI agent complete control over member authentication and e-commerce data. Use it to manage membership plans, look up user profiles, monitor promotions, and handle custom fields—all through natural conversation. It lets you query active coupons or pull detailed metadata on a specific user's subscription status without ever leaving your chat window.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** user-authentication, membership-management, access-control, subscription-billing, member-data

## Description

Need to track who belongs and what they paid for? This MCP connects your Memberstack account directly to your AI agent, letting you manage all member data through plain conversation. You can ask your agent to list every active member or search for a user by email to instantly check their subscription status. The system also lets you pull detailed information on all available membership plans and view which custom fields were set up for members. Plus, checking the latest coupons or monitoring marketing promotions is as simple as asking it. Getting this data stream through Vinkius makes sure your AI agent has access to everything needed, turning complex member workflows into simple conversations.

## Tools

### get_member_plans
Retrieves all possible membership plans associated with a specific user.

### get_plan
Fetches comprehensive details about one particular membership plan by its identifier.

### list_coupons
Displays a list of all discount coupons that are currently available for use.

### list_custom_fields
Lists every custom data field you have set up to track unique member information.

### list_members
Retrieves a list of all user accounts registered in your system.

### list_plans
Shows an overview of every membership plan currently configured in Memberstack.

### list_promotions
Provides a list and summary of all active promotional campaigns running right now.

### search_members
Searches for members by entering their email address to locate the correct user profile.

### get_application_info
Gathers high-level information about your overall Memberstack application configuration.

### get_member
Retrieves the full, detailed record for one specific member ID or profile.

## Prompt Examples

**Prompt:** 
```
List the last 5 members who joined.
```

**Response:** 
```
Retrieving members... I found your most recent users, including 'john.doe@example.com' and 'jane.smith@domain.com'.
```

**Prompt:** 
```
Show details for member ID 'mem_12345'.
```

**Response:** 
```
Inspecting member... Member 'mem_12345' is currently on the 'Pro Plan' and has been active since last month.
```

**Prompt:** 
```
What are my available membership plans?
```

**Response:** 
```
Querying plans... You have 3 plans configured: 'Free Tier', 'Monthly Pro', and 'Annual Enterprise'.
```

## Capabilities

### Retrieve Member Profiles
Find and pull detailed records for specific members or search the entire user base by email address.

### Audit Membership Plans
List all available membership plans, or get deep configuration details on a single plan's pricing structure.

### Manage Promotions and Offers
Check the status of active coupons and list all ongoing marketing promotions to see what’s running right now.

### Handle Custom User Data
List, view, and manage any custom fields or metadata attached to specific member accounts.

### Check Application Status
Get high-level information about your current Memberstack setup, verifying the app's configuration details.

## Use Cases

### Verifying a High-Value Customer's Access
An e-commerce manager needs to confirm if VIP user 'ceo@corp.com' has the necessary 'Enterprise Annual' plan status before granting them access to beta features. They ask their agent, who uses `search_members` and then `get_member`, confirming the correct subscription level in seconds.

### Auditing Plan Changes After an Update
The product team needs to check if a new paid tier was correctly configured. They ask their agent to use `list_plans` and then query specific details with `get_plan`, verifying the pricing structure before launching it.

### Handling Support Queries on Discounts
A support agent needs to tell a user, 'Your discount code is active.' They ask their agent to use `list_coupons` and then verify the details with the resulting data, providing accurate, immediate information.

### Onboarding New Data Fields
The ops team adds a new field for 'Industry Vertical'. Instead of manually updating every record, they use `list_custom_fields` to confirm the metadata structure is ready and available for agent interaction.

## Benefits

- Stop cross-referencing spreadsheets. You can use the `search_members` tool to instantly pull a user's full record, including their current plan and custom details, just by asking your agent.
- Never forget what plans you offer. Your AI client can list all membership plans or fetch detailed configs using `get_plan`, ensuring every team member knows exactly what tiers exist.
- Streamline promotional checks. Instead of navigating coupon tabs, ask the agent to use `list_coupons` and instantly see which discounts are active for your users' checkout process.
- Full visibility into user data. The MCP lets you list all members or grab a single profile using `get_member`, giving you immediate access to plan connection details.
- Keep track of unique data points. You can use `list_custom_fields` and related tools to manage metadata, making sure every niche piece of member info is accessible via conversation.

## How It Works

The bottom line is you get real-time access to all your member records without needing to copy and paste anything into a dashboard.

1. Subscribe to this MCP and provide your unique Memberstack Secret Key.
2. Your AI agent connects using that key, establishing a direct link to your member data sources.
3. You ask the agent questions like, 'What is our annual plan?' or 'Find out John Doe's membership details,' and it returns actionable data.

## Frequently Asked Questions

**How does Memberstack MCP help me find a specific user's plan?**
You use the `search_members` tool first to locate the user by email. Then, you can ask for the member details using `get_member`, which provides their current membership status and associated plans.

**Can I check if a coupon is working with Memberstack MCP?**
Yes. You use the `list_coupons` tool to see all available discount codes, ensuring that any promotion you mention is currently active in your system.

**What kind of data can I pull about membership plans using this MCP?**
You can list every plan offered using `list_plans` or get deep configuration details for one specific plan with the `get_plan` tool.

**Is Memberstack MCP only for e-commerce billing?**
No. While it handles payments, you can also use tools like `list_custom_fields` to manage non-billing metadata and track unique information about your member base.

**Does the Memberstack MCP help me list all my members?**
Yes. You use the `list_members` tool, which retrieves a roster of every user account registered in your system for auditing or reporting.