MCP Server

What Can You Do with the MCP Server?

The MCP server provides approximately 68 specialized tools that understand the Memberstack data model, handle multi-project contexts, and respect environment boundaries.

Installation & Setup

Prerequisites

• An MCP-compatible client (e.g., Claude Code, Cursor, Codex, Claude Desktop, Cline)
• An active Memberstack account with dashboard access
• Node.js installed on your machine to use the npx command

Step 1: Configure Your Client

Find your AI client below and follow the instructions to register the Memberstack MCP Server.

claude mcp add memberstack --scope user npx mcp-remote https://mcp.memberstack.com/mcp

codex mcp add memberstack -- npx mcp-remote https://mcp.memberstack.com/mcp

{
  "mcpServers": {
    "memberstack": {
      "command": "npx",
      "args": [ "mcp-remote", "https://mcp.memberstack.com/mcp" ]
    }
  }
}

{
  "mcpServers": {
    "memberstack": {
      "command": "npx",
      "args": [ "mcp-remote", "https://mcp.memberstack.com/mcp" ]
    }
  }
}

{
  "mcpServers": {
    "memberstack": {
      "command": "npx",
      "args": [ "mcp-remote", "https://mcp.memberstack.com/mcp" ]
    }
  }
}

mcpServers:
  memberstack:
    command: npx
    args:
      - mcp-remote
      - https://mcp.memberstack.com/mcp

Step 2: Authenticate with Memberstack

1. After configuring your client, start a new conversation.
2. Your client will detect the new server and prompt you to authenticate. A browser window will open.
3. Log in with your Memberstack dashboard credentials to authorize the connection.

Step 3: Verify the Connection

Test your connection by asking your AI assistant:

"List my Memberstack apps"

The assistant should use the listApps tool and show you the Memberstack projects you have access to.

Core Concepts

Apps (Projects)

An App in Memberstack is a complete project or workspace. It contains its own members, plans, data tables, and settings. You must select an app context before performing most operations.

Key Tools: listApps, switchApp, currentApp

Environments (LIVE vs. SANDBOX)

Each app has two isolated environments:

Key Tools: getMemberstackEnvironment, switchMemberstackEnvironment

Authentication & Sessions

After you authenticate via OAuth, the MCP server maintains your session, including your active app and environment. To log out or switch Memberstack accounts, you must clear your local session token.

To log out and re-authenticate:

1. Run the following command in your terminal:

rm -rf ~/.mcp-auth

1. Restart your client and start a new conversation.

Key Tool Groups

The MCP server's ~68 tools are organized into logical groups. Here's an overview of what each group can do.

App & Environment Management

Navigate your Memberstack account, list projects, switch between them, and toggle between SANDBOX and LIVE environments.

Tools: listApps, switchApp, switchMemberstackEnvironment

Member Management

Create, update, and delete members, manage plan assignments, update metadata, and handle bulk operations like imports and exports.

Tools: createMemberEmailPassword, getMembers, updateMember, addFreePlan, exportMembers, deleteMember

Subscription Plan Management

Create and manage subscription plans and pricing. Define plan details, create prices in Stripe, import existing Stripe products, and configure plan logic.

Tools: createPlan, getPlans, createPrice (requires LIVE mode), importStripeProduct

Data Tables

Build and manage custom databases within Memberstack. Create tables, define fields, and manage records. Perfect for member profiles, directories, or custom content.

Tools: createDataTable, createDataTableField, createDataRecord, getDataRecords

Gated Content

Control access to your website's content. Create content groups, protect specific URLs (including wildcards like /pro-content/*), and link subscription plans to grant access.

Tools: createRestrictedUrlGroup, createRestrictedUrl, linkPlansToRestrictedUrlGroup

Knowledge Search

Perform semantic searches across the entire Memberstack knowledge base, including help articles, blog posts, and developer docs.

Key Tool: memberstackKnowledgeSearch

Common Workflows & Examples

Workflow 1: First-Time Setup

1. List apps: "List my Memberstack apps"
2. Select an app: "Switch to the 'My Awesome Site' app"
3. Check environment: "What is my current Memberstack environment?"
4. Switch if needed: "Switch to SANDBOX for testing"

Uses: listApps, switchApp, getMemberstackEnvironment, switchMemberstackEnvironment

Workflow 2: Creating a Member in a Test Environment

1. Confirm SANDBOX: "Make sure I am in the SANDBOX environment"
2. Create a member: "Create a new member with email test@example.com and password 'SecurePassword123'"
3. Add a plan: "Find the 'Free Tier' plan and add it to test@example.com"
4. Verify creation: "Show me the details for the member with email test@example.com"

Uses: switchMemberstackEnvironment, createMemberEmailPassword, addFreePlan, getMembers

Workflow 3: Setting Up a Gated Content Rule

1. Create a content group: "Create a gated content group called 'Pro Articles'"
2. Add a protected URL: "Add the URL '/pro/*' to the 'Pro Articles' group"
3. Link a plan: "Grant access to the 'Pro Articles' group for anyone on the 'Pro Membership' plan"
4. Verify: "Show me the configuration for the 'Pro Articles' content group"

Uses: createRestrictedUrlGroup, createRestrictedUrl, linkPlansToRestrictedUrlGroup

Troubleshooting Common Issues

Complete Tool Reference

Here is a compact list of all available tools, organized by category.