---
name: flow-nexus-platform
description: |
  Comprehensive Flow Nexus platform management - authentication, sandboxes, app deployment, payments, and challenges
---

# Flow Nexus Platform Management

Comprehensive platform management for Flow Nexus - covering authentication, sandbox execution, app deployment, credit management, and coding challenges.

## Table of Contents
1. [Authentication & User Management](#authentication--user-management)
2. [Sandbox Management](#sandbox-management)
3. [App Store & Deployment](#app-store--deployment)
4. [Payments & Credits](#payments--credits)
5. [Challenges & Achievements](#challenges--achievements)
6. [Storage & Real-time](#storage--real-time)
7. [System Utilities](#system-utilities)

---

## Authentication & User Management

### Registration & Login

**Register New Account**
```javascript
mcp__flow-nexus__user_register({
  email: "user@example.com",
  password: "secure_password",
  full_name: "Your Name",
  username: "unique_username" // optional
})
```

**Login**
```javascript
mcp__flow-nexus__user_login({
  email: "user@example.com",
  password: "your_password"
})
```

**Check Authentication Status**
```javascript
mcp__flow-nexus__auth_status({ detailed: true })
```

**Logout**
```javascript
mcp__flow-nexus__user_logout()
```

### Password Management

**Request Password Reset**
```javascript
mcp__flow-nexus__user_reset_password({
  email: "user@example.com"
})
```

**Update Password with Token**
```javascript
mcp__flow-nexus__user_update_password({
  token: "reset_token_from_email",
  new_password: "new_secure_password"
})
```

**Verify Email**
```javascript
mcp__flow-nexus__user_verify_email({
  token: "verification_token_from_email"
})
```

### Profile Management

**Get User Profile**
```javascript
mcp__flow-nexus__user_profile({
  user_id: "your_user_id"
})
```

**Update Profile**
```javascript
mcp__flow-nexus__user_update_profile({
  user_id: "your_user_id",
  updates: {
    full_name: "Updated Name",
    bio: "AI Developer and researcher",
    github_username: "yourusername",
    twitter_handle: "@yourhandle"
  }
})
```

**Get User Statistics**
```javascript
mcp__flow-nexus__user_stats({
  user_id: "your_user_id"
})
```

**Upgrade User Tier**
```javascript
mcp__flow-nexus__user_upgrade({
  user_id: "your_user_id",
  tier: "pro" // pro, enterprise
})
```

---

## Sandbox Management

### Create & Configure Sandboxes

**Create Sandbox**
```javascript
mcp__flow-nexus__sandbox_create({
  template: "node", // node, python, react, nextjs, vanilla, base, claude-code
  name: "my-sandbox",
  env_vars: {
    API_KEY: "your_api_key",
    NODE_ENV: "development",
    DATABASE_URL: "postgres://..."
  },
  install_packages: ["express", "cors", "dotenv"],
  startup_script: "npm run dev",
  timeout: 3600, // seconds
  metadata: {
    project: "my-project",
    environment: "staging"
  }
})
```

**Configure Existing Sandbox**
```javascript
mcp__flow-nexus__sandbox_configure({
  sandbox_id: "sandbox_id",
  env_vars: {
    NEW_VAR: "value"
  },
  install_packages: ["axios", "lodash"],
  run_commands: ["npm run migrate", "npm run seed"],
  anthropic_key: "sk-ant-..." // For Claude Code integration
})
```

### Execute Code

**Run Code in Sandbox**
```javascript
mcp__flow-nexus__sandbox_execute({
  sandbox_id: "sandbox_id",
  code: `
    console.log('Hello from sandbox!');
    const result = await fetch('https://api.example.com/data');
    const data = await result.json();
    return data;
  `,
  language: "javascript",
  capture_output: true,
  timeout: 60, // seconds
  working_dir: "/app",
  env_vars: {
    TEMP_VAR: "override"
  }
})
```

### Manage Sandboxes

**List Sandboxes**
```javascript
mcp__flow-nexus__sandbox_list({
  status: "running" // running, stopped, all
})
```

**Get Sandbox Status**
```javascript
mcp__flow-nexus__sandbox_status({
  sandbox_id: "sandbox_id"
})
```

**Upload File to Sandbox**
```javascript
mcp__flow-nexus__sandbox_upload({
  sandbox_id: "sandbox_id",
  file_path: "/app/config/database.json",
  content: JSON.stringify(databaseConfig, null, 2)
})
```

**Get Sandbox Logs**
```javascript
mcp__flow-nexus__sandbox_logs({
  sandbox_id: "sandbox_id",
  lines: 100 // max 1000
})
```

**Stop Sandbox**
```javascript
mcp__flow-nexus__sandbox_stop({
  sandbox_id: "sandbox_id"
})
```

**Delete Sandbox**
```javascript
mcp__flow-nexus__sandbox_delete({
  sandbox_id: "sandbox_id"
})
```

### Sandbox Templates

- **node**: Node.js environment with npm
- **python**: Python 3.x with pip
- **react**: React development setup
- **nextjs**: Next.js full-stack framework
- **vanilla**: Basic HTML/CSS/JS
- **base**: Minimal Linux environment
- **claude-code**: Claude Code integrated environment

### Common Sandbox Patterns

**API Development Sandbox**
```javascript
mcp__flow-nexus__sandbox_create({
  template: "node",
  name: "api-development",
  install_packages: [
    "express",
    "cors",
    "helmet",
    "dotenv",
    "jsonwebtoken",
    "bcrypt"
  ],
  env_vars: {
    PORT: "3000",
    NODE_ENV: "development"
  },
  startup_script: "npm run dev"
})
```

**Machine Learning Sandbox**
```javascript
mcp__flow-nexus__sandbox_create({
  template: "python",
  name: "ml-training",
  install_packages: [
    "numpy",
    "pandas",
    "scikit-learn",
    "matplotlib",
    "tensorflow"
  ],
  env_vars: {
    CUDA_VISIBLE_DEVICES: "0"
  }
})
```

**Full-Stack Development**
```javascript
mcp__flow-nexus__sandbox_create({
  template: "nextjs",
  name: "fullstack-app",
  install_packages: [
    "prisma",
    "@prisma/client",
    "next-auth",
    "zod"
  ],
  env_vars: {
    DATABASE_URL: "postgresql://...",
    NEXTAUTH_SECRET: "secret"
  }
})
```

---

## App Store & Deployment

### Browse & Search

**Search Applications**
```javascript
mcp__flow-nexus__app_search({
  search: "authentication api",
  category: "backend",
  featured: true,
  limit: 20
})
```

**Get App Details**
```javascript
mcp__flow-nexus__app_get({
  app_id: "app_id"
})
```

**List Templates**
```javascript
mcp__flow-nexus__app_store_list_templates({
  category: "web-api",
  tags: ["express", "jwt", "typescript"],
  limit: 20
})
```

**Get Template Details**
```javascript
mcp__flow-nexus__template_get({
  template_name: "express-api-starter",
  template_id: "template_id" // alternative
})
```

**List All Available Templates**
```javascript
mcp__flow-nexus__template_list({
  category: "backend",
  template_type: "starter",
  featured: true,
  limit: 50
})
```

### Publish Applications

**Publish App to Store**
```javascript
mcp__flow-nexus__app_store_publish_app({
  name: "JWT Authentication Service",
  description: "Production-ready JWT authentication microservice with refresh tokens",
  category: "backend",
  version: "1.0.0",
  source_code: sourceCodeString,
  tags: ["auth", "jwt", "express", "typescript", "security"],
  metadata: {
    author: "Your Name",
    license: "MIT",
    repository: "github.com/username/repo",
    homepage: "https://yourapp.com",
    documentation: "https://docs.yourapp.com"
  }
})
```

**Update Application**
```javascript
mcp__flow-nexus__app_update({
  app_id: "app_id",
  updates: {
    version: "1.1.0",
    description: "Added OAuth2 support",
    tags: ["auth", "jwt", "oauth2", "express"],
    source_code: updatedSourceCode
  }
})
```

### Deploy Templates

**Deploy Template**
```javascript
mcp__flow-nexus__template_deploy({
  template_name: "express-api-starter",
  deployment_name: "my-production-api",
  variables: {
    api_key: "your_api_key",
    database_url: "postgres://user:pass@host:5432/db",
    redis_url: "redis://localhost:6379"
  },
  env_vars: {
    NODE_ENV: "production",
    PORT: "8080",
    LOG_LEVEL: "info"
  }
})
```

### Analytics & Management

**Get App Analytics**
```javascript
mcp__flow-nexus__app_analytics({
  app_id: "your_app_id",
  timeframe: "30d" // 24h, 7d, 30d, 90d
})
```

**View Installed Apps**
```javascript
mcp__flow-nexus__app_installed({
  user_id: "your_user_id"
})
```

**Get Market Statistics**
```javascript
mcp__flow-nexus__market_data()
```

### App Categories

- **web-api**: RESTful APIs and microservices
- **frontend**: React, Vue, Angular applications
- **full-stack**: Complete end-to-end applications
- **cli-tools**: Command-line utilities
- **data-processing**: ETL pipelines and analytics
- **ml-models**: Pre-trained machine learning models
- **blockchain**: Web3 and blockchain applications
- **mobile**: React Native and mobile apps

### Publishing Best Practices

1. **Documentation**: Include comprehensive README with setup instructions
2. **Examples**: Provide usage examples and sample configurations
3. **Testing**: Include test suite and CI/CD configuration
4. **Versioning**: Use semantic versioning (MAJOR.MINOR.PATCH)
5. **Licensing**: Add clear license information (MIT, Apache, etc.)
6. **Deployment**: Include Docker/docker-compose configurations
7. **Migrations**: Provide upgrade guides for version updates
8. **Security**: Document security considerations and best practices

### Revenue Sharing

- Earn rUv credits when others deploy your templates
- Set pricing (0 for free, or credits for premium)
- Track usage and earnings via analytics
- Withdraw credits or use for Flow Nexus services

---

## Payments & Credits

### Balance & Credits

**Check Credit Balance**
```javascript
mcp__flow-nexus__check_balance()
```

**Check rUv Balance**
```javascript
mcp__flow-nexus__ruv_balance({
  user_id: "your_user_id"
})
```

**View Transaction History**
```javascript
mcp__flow-nexus__ruv_history({
  user_id: "your_user_id",
  limit: 100
})
```

**Get Payment History**
```javascript
mcp__flow-nexus__get_payment_history({
  limit: 50
})
```

### Purchase Credits

**Create Payment Link**
```javascript
mcp__flow-nexus__create_payment_link({
  amount: 50 // USD, minimum $10
})
// Returns secure Stripe payment URL
```

### Auto-Refill Configuration

**Enable Auto-Refill**
```javascript
mcp__flow-nexus__configure_auto_refill({
  enabled: true,
  threshold: 100,  // Refill when credits drop below 100
  amount: 50       // Purchase $50 worth of credits
})
```

**Disable Auto-Refill**
```javascript
mcp__flow-nexus__configure_auto_refill({
  enabled: false
})
```

### Credit Pricing

**Service Costs:**
- **Swarm Operations**: 1-10 credits/hour
- **Sandbox Execution**: 0.5-5 credits/hour
- **Neural Training**: 5-50 credits/job
- **Workflow Runs**: 0.1-1 credit/execution
- **Storage**: 0.01 credits/GB/day
- **API Calls**: 0.001-0.01 credits/request

### Earning Credits

**Ways to Earn:**
1. **Complete Challenges**: 10-500 credits per challenge
2. **Publish Templates**: Earn when others deploy (you set pricing)
3. **Referral Program**: Bonus credits for user invites
4. **Daily Login**: Small daily bonus (5-10 credits)
5. **Achievements**: Unlock milestone rewards (50-1000 credits)
6. **App Store Sales**: Revenue share from paid templates

**Earn Credits Programmatically**
```javascript
mcp__flow-nexus__app_store_earn_ruv({
  user_id: "your_user_id",
  amount: 100,
  reason: "Completed expert algorithm challenge",
  source: "challenge" // challenge, app_usage, referral, etc.
})
```

### Subscription Tiers

**Free Tier**
- 100 free credits monthly
- Basic sandbox access (2 concurrent)
- Limited swarm agents (3 max)
- Community support
- 1GB storage

**Pro Tier ($29/month)**
- 1000 credits monthly
- Priority sandbox access (10 concurrent)
- Unlimited swarm agents
- Advanced workflows
- Email support
- 10GB storage
- Early access to features

**Enterprise Tier (Custom Pricing)**
- Unlimited credits
- Dedicated compute resources
- Custom neural models
- 99.9% SLA guarantee
- Priority 24/7 support
- Unlimited storage
- White-label options
- On-premise deployment

### Cost Optimization Tips

1. **Use Smaller Sandboxes**: Choose appropriate templates (base vs full-stack)
2. **Optimize Neural Training**: Tune hyperparameters, reduce epochs
3. **Batch Operations**: Group workflow executions together
4. **Clean Up Resources**: Delete unused sandboxes and storage
5. **Monitor Usage**: Check `user_stats` regularly
6. **Use Free Templates**: Leverage community templates
7. **Schedule Off-Peak**: Run heavy jobs during low-cost periods

---

## Challenges & Achievements

### Browse Challenges

**List Available Challenges**
```javascript
mcp__flow-nexus__challenges_list({
  difficulty: "intermediate", // beginner, intermediate, advanced, expert
  category: "algorithms",
  status: "active", // active, completed, locked
  limit: 20
})
```

**Get Challenge Details**
```javascript
mcp__flow-nexus__challenge_get({
  challenge_id: "two-sum-problem"
})
```

### Submit Solutions

**Submit Challenge Solution**
```javascript
mcp__flow-nexus__challenge_submit({
  challenge_id: "challenge_id",
  user_id: "your_user_id",
  solution_code: `
    function twoSum(nums, target) {
      const map = new Map();
      for (let i = 0; i < nums.length; i++) {
        const complement = target - nums[i];
        if (map.has(complement)) {
          return [map.get(complement), i];
        }
        map.set(nums[i], i);
      }
      return [];
    }
  `,
  language: "javascript",
  execution_time: 45 // milliseconds (optional)
})
```

**Mark Challenge as Complete**
```javascript
mcp__flow-nexus__app_store_complete_challenge({
  challenge_id: "challenge_id",
  user_id: "your_user_id",
  submission_data: {
    passed_tests: 10,
    total_tests: 10,
    execution_time: 45,
    memory_usage: 2048 // KB
  }
})
```

### Leaderboards

**Global Leaderboard**
```javascript
mcp__flow-nexus__leaderboard_get({
  type: "global", // global, weekly, monthly, challenge
  limit: 100
})
```

**Challenge-Specific Leaderboard**
```javascript
mcp__flow-nexus__leaderboard_get({
  type: "challenge",
  challenge_id: "specific_challenge_id",
  limit: 50
})
```

### Achievements & Badges

**List User Achievements**
```javascript
mcp__flow-nexus__achievements_list({
  user_id: "your_user_id",
  category: "speed_demon" // Optional filter
})
```

### Challenge Categories

- **algorithms**: Classic algorithm problems (sorting, searching, graphs)
- **data-structures**: DS implementation (trees, heaps, tries)
- **system-design**: Architecture and scalability challenges
- **optimization**: Performance and efficiency problems
- **security**: Security-focused vulnerabilities and fixes
- **ml-basics**: Machine learning fundamentals
- **distributed-systems**: Concurrency and distributed computing
- **databases**: Query optimization and schema design

### Challenge Difficulty Rewards

- **Beginner**: 10-25 credits
- **Intermediate**: 50-100 credits
- **Advanced**: 150-300 credits
- **Expert**: 400-500 credits
- **Master**: 600-1000 credits

### Achievement Types

- **Speed Demon**: Complete challenges in record time
- **Code Golf**: Minimize code length
- **Perfect Score**: 100% test pass rate
- **Streak Master**: Complete challenges N days in a row
- **Polyglot**: Solve in multiple languages
- **Debugger**: Fix broken code challenges
- **Optimizer**: Achieve top performance benchmarks

### Tips for Success

1. **Start Simple**: Begin with beginner challenges to build confidence
2. **Review Solutions**: Study top solutions after completing
3. **Optimize**: Aim for both correctness and performance
4. **Daily Practice**: Complete daily challenges for bonus credits
5. **Community**: Engage with discussions and learn from others
6. **Track Progress**: Monitor achievements and leaderboard position
7. **Experiment**: Try multiple approaches to problems

---

## Storage & Real-time

### File Storage

**Upload File**
```javascript
mcp__flow-nexus__storage_upload({
  bucket: "my-bucket", // public, private, shared, temp
  path: "data/users.json",
  content: JSON.stringify(userData, null, 2),
  content_type: "application/json"
})
```

**List Files**
```javascript
mcp__flow-nexus__storage_list({
  bucket: "my-bucket",
  path: "data/", // prefix filter
  limit: 100
})
```

**Get Public URL**
```javascript
mcp__flow-nexus__storage_get_url({
  bucket: "my-bucket",
  path: "data/report.pdf",
  expires_in: 3600 // seconds (default: 1 hour)
})
```

**Delete File**
```javascript
mcp__flow-nexus__storage_delete({
  bucket: "my-bucket",
  path: "data/old-file.json"
})
```

### Storage Buckets

- **public**: Publicly accessible files (CDN-backed)
- **private**: User-only access with authentication
- **shared**: Team collaboration with ACL
- **temp**: Auto-deleted after 24 hours

### Real-time Subscriptions

**Subscribe to Database Changes**
```javascript
mcp__flow-nexus__realtime_subscribe({
  table: "tasks",
  event: "INSERT", // INSERT, UPDATE, DELETE, *
  filter: "status=eq.pending AND priority=eq.high"
})
```

**List Active Subscriptions**
```javascript
mcp__flow-nexus__realtime_list()
```

**Unsubscribe**
```javascript
mcp__flow-nexus__realtime_unsubscribe({
  subscription_id: "subscription_id"
})
```

### Execution Monitoring

**Subscribe to Execution Stream**
```javascript
mcp__flow-nexus__execution_stream_subscribe({
  stream_type: "claude-flow-swarm", // claude-code, claude-flow-swarm, claude-flow-hive-mind, github-integration
  deployment_id: "deployment_id",
  sandbox_id: "sandbox_id" // alternative
})
```

**Get Stream Status**
```javascript
mcp__flow-nexus__execution_stream_status({
  stream_id: "stream_id"
})
```

**List Generated Files**
```javascript
mcp__flow-nexus__execution_files_list({
  stream_id: "stream_id",
  created_by: "claude-flow", // claude-code, claude-flow, git-clone, user
  file_type: "javascript" // filter by extension
})
```

**Get File Content from Execution**
```javascript
mcp__flow-nexus__execution_file_get({
  file_id: "file_id",
  file_path: "/path/to/file.js" // alternative
})
```

---

## System Utilities

### Queen Seraphina AI Assistant

**Seek Guidance from Seraphina**
```javascript
mcp__flow-nexus__seraphina_chat({
  message: "How should I architect a distributed microservices system?",
  enable_tools: true, // Allow her to create swarms, deploy code, etc.
  conversation_history: [
    { role: "user", content: "I need help with system architecture" },
    { role: "assistant", content: "I can help you design that. What are your requirements?" }
  ]
})
```

Queen Seraphina is an advanced AI assistant with:
- Deep expertise in distributed systems
- Ability to create swarms and orchestrate agents
- Code deployment and architecture design
- Multi-turn conversation with context retention
- Tool usage for hands-on assistance

### System Health & Monitoring

**Check System Health**
```javascript
mcp__flow-nexus__system_health()
```

**View Audit Logs**
```javascript
mcp__flow-nexus__audit_log({
  user_id: "your_user_id", // optional filter
  limit: 100
})
```

### Authentication Management

**Initialize Authentication**
```javascript
mcp__flow-nexus__auth_init({
  mode: "user" // user, service
})
```

---

## Quick Start Guide

### Step 1: Register & Login

```javascript
// Register
mcp__flow-nexus__user_register({
  email: "dev@example.com",
  password: "SecurePass123!",
  full_name: "Developer Name"
})

// Login
mcp__flow-nexus__user_login({
  email: "dev@example.com",
  password: "SecurePass123!"
})

// Check auth status
mcp__flow-nexus__auth_status({ detailed: true })
```

### Step 2: Configure Billing

```javascript
// Check current balance
mcp__flow-nexus__check_balance()

// Add credits
const paymentLink = mcp__flow-nexus__create_payment_link({
  amount: 50 // $50
})

// Setup auto-refill
mcp__flow-nexus__configure_auto_refill({
  enabled: true,
  threshold: 100,
  amount: 50
})
```

### Step 3: Create Your First Sandbox

```javascript
// Create development sandbox
const sandbox = mcp__flow-nexus__sandbox_create({
  template: "node",
  name: "dev-environment",
  install_packages: ["express", "dotenv"],
  env_vars: {
    NODE_ENV: "development"
  }
})

// Execute code
mcp__flow-nexus__sandbox_execute({
  sandbox_id: sandbox.id,
  code: 'console.log("Hello Flow Nexus!")',
  language: "javascript"
})
```

### Step 4: Dep