@simplystack-org/mcp v1.0.5

SimplyStack MCP Server

Model Context Protocol server for SimplyStack - Bring SimplyStack's powerful backend services directly to your AI assistants like Cursor, Claude, and Windsurf.

What is This?

This MCP server allows AI assistants to interact with your SimplyStack projects, enabling:

• 🚀 Project Management - Create and manage SimplyStack projects
• 📝 Content Management - Create and manage blog posts
• 🔍 Logging - Create and search application logs
• 📁 File Storage - Manage and retrieve files
• 📧 Email Management - Send emails and manage configurations
• 👥 Lead Management - Capture and manage leads
• 📊 Analytics - Get insights and statistics

Quick Start

Step 1: Create Account & Get Personal Token

1. Create a SimplyStack account (if you don't have one):

   • Go to SimplyStack
   • Sign up for an account

2. Generate your Personal Access Token:

   • Go to Account Settings
   • Click "Generate New Token"
   • Copy the token (you'll need it for configuration)

💡 Personal Access Token: This allows you to create and list projects from your AI assistant.

Step 2: Configure Your AI Tool

Choose your preferred AI tool and add the MCP server configuration:

Cursor

Go to Settings → Features → MCP Servers and add:

{
  "name": "simplystack",
  "command": "npx",
  "args": [
    "-y",
    "@simplystack-org/mcp@latest",
    "--personal-token",
    "your_personal_token_here"
  ]
}

Windsurf

Go to Cascade → Configure and add:

{
  "mcpServers": {
    "simplystack": {
      "command": "npx",
      "args": [
        "-y",
        "@simplystack-org/mcp@latest",
        "--personal-token",
        "your_personal_token_here"
      ]
    }
  }
}

Claude Desktop

Edit your MCP configuration file:

{
  "mcpServers": {
    "simplystack": {
      "command": "npx",
      "args": [
        "-y",
        "@simplystack-org/mcp@latest",
        "--personal-token",
        "your_personal_token_here"
      ]
    }
  }
}

Step 3: Restart Your AI Tool

Restart your AI assistant to load the SimplyStack MCP server.

Step 4: Start Using!

Try asking your AI assistant:

• "Create a new SimplyStack project called 'My Blog'"
• "List all my SimplyStack projects"
• "Create a blog post about AI development"
• "Send an email to hello@example.com about our new features"

Authentication & Project Setup

SimplyStack uses a two-level authentication system:

1. Personal Access Token (Project Management)

• Purpose: Create and list projects
• Where to get: Account Settings
• Used for: Project creation, listing all projects

2. Project Token (Project Operations)

• Purpose: Manage content within a specific project (blogs, emails, storage, etc.)
• Where to get: SimplyStack Dashboard → Your Project → Settings → API Keys
• Used for: Blog posts, email sending, file storage, lead management

Setting Up Project Tokens

After creating or selecting a project, you'll need to configure its token:

1. Get the Project Token:

   • Go to SimplyStack Dashboard
   • Navigate to your project
   • Go to Settings → API Keys
   • Create a new API key

2. Configure in Your AI Assistant:

   • Tell your assistant: "Set the project secret for project project-id to your-project-token"

Usage Examples

Project Setup

You: "Create a new project called 'AI Newsletter' for my newsletter service"
AI: ✅ Creates project and sets it as active

You: "What's my current active project?"
AI: Shows current project details and available actions

Content Management

You: "Create a blog post titled 'Getting Started with AI' with content about AI basics"
AI: ✅ Creates blog post in active project

You: "List all my blog posts"
AI: Shows all blog posts with titles, status, and dates

Email & Lead Management

You: "Set up email configuration with sender name 'AI Newsletter'"
AI: ✅ Configures email system

You: "Send a welcome email to new.subscriber@example.com"
AI: ✅ Sends email and tracks in system

You: "Add john@example.com as a new lead from our landing page"
AI: ✅ Creates lead and optionally sends welcome email

Available Tools

Project Management

• create_simplystack_project - Create new projects
• list_user_projects - List all accessible projects
• set_active_project - Switch active project
• get_active_project - Get current project details
• set_project_secret - Configure project API keys
• get_project_context - View all projects and status

Content Management

• create_blog_post - Create blog posts
• list_blog_posts - List blog posts with filters
• get_blog_post - Get specific blog post
• update_blog_post - Update blog post content
• delete_blog_post - Delete blog posts

Storage Management

• list_storage_assets - List uploaded files
• get_storage_asset - Get file details and URLs
• get_file_url - Generate file URLs with transformations
• delete_storage_asset - Delete files

Logging

• create_log_entry - Create application logs
• search_logs - Search and filter logs
• get_log_entry - Get specific log entry

Email System

• setup_email_configuration - Configure email settings
• get_email_configuration - Get current email config
• update_email_configuration - Update email settings
• send_email - Send emails with templates
• get_emails - List sent emails
• get_email - Get specific email details

Lead Management

• create_lead - Add new leads with welcome emails
• get_leads - List leads with filters
• get_lead - Get specific lead details
• update_lead - Update lead information

Analytics

• get_email_stats - Get email and lead statistics

CLI Options

npx @simplystack-org/mcp [options]

Options:
  -t, --personal-token <token>  SimplyStack personal access token (required)
  -u, --base-url <url>          API base URL (default: production)
  --test                        Run in test mode (validates and exits)
  --debug                       Enable debug logging
  -h, --help                    Display help

Configuration Storage

Your projects and settings are automatically stored in:

• Location: ~/.simplystack/projects.json
• Auto-created: Yes, on first run
• Contains: Project contexts, active project, and project tokens

Error Handling

The MCP server provides helpful error messages and solutions:

❌ Cannot perform create_blog_post: No active project set.

🔧 SOLUTION:
1. Create a new project: use create_simplystack_project
2. Or select existing project: use set_active_project with project ID

Use get_project_context to see available projects.

Troubleshooting

"Personal token required"

• Solution: Get your token from Account Settings
• Make sure it's properly configured in your AI tool's MCP configuration

"No active project set"

• Solution: Create a new project or select an existing one
• Try: "Create a SimplyStack project called 'My Project'"
• Or: "Set active project to project-id"

"Project has no secret configured"

• Solution: Get your project token and configure it
• Get project token from: Dashboard → Your Project → Settings → API Keys
• Configure: "Set the project secret for project-id to your-project-token"

"API connectivity issues"

• Check: Verify your tokens are valid and not expired
• Check: Ensure you're connected to the internet
• Test: Try the test command: npx @simplystack-org/mcp --personal-token "your-token" --test

AI Tool Not Detecting MCP Server

• Restart your AI tool after adding the configuration
• Check that the configuration syntax is correct for your specific tool
• Verify the green indicator shows the server is connected

Support

• 📧 Email: support@simplystack.dev
• 🐛 Issues: GitHub Issues
• 📖 Documentation: SimplyStack Docs
• 💬 Community: SimplyStack Discord

Built with ❤️ by the SimplyStack team