/flow-nexus-platform

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**

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

**Login**

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

**Check Authentication Status**

mcp__flow-nexus__auth_status({ detailed: true })

**Logout**

mcp__flow-nexus__user_logout()

Password Management

**Request Password Reset**

mcp__flow-nexus__user_reset_password({
  email: "user@example.com"
})

**Update Password with Token**

mcp__flow-nexus__user_update_password({
  token: "reset_token_from_email",
  new_password: "new_secure_password"
})

**Verify Email**

mcp__flow-nexus__user_verify_email({
  token: "verification_token_from_email"
})

Profile Management

**Get User Profile**

mcp__flow-nexus__user_profile({
  user_id: "your_user_id"
})

**Update Profile**

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**

mcp__flow-nexus__user_stats({
  user_id: "your_user_id"
})

**Upgrade User Tier**

mcp__flow-nexus__user_upgrade({
  user_id: "your_user_id",
  tier: "pro" // pro, enterprise
})

---

Sandbox Management

Create & Configure Sandboxes

**Create Sandbox**

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**

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**

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**

mcp__flow-nexus__sandbox_list({
  status: "running" // running, stopped, all
})

**Get Sandbox Status**

mcp__flow-nexus__sandbox_status({
  sandbox_id: "sandbox_id"
})

**Upload File to Sandbox**

mcp__flow-nexus__sandbox_upload({
  sandbox_id: "sandbox_id",
  file_path: "/app/config/database.json",
  content: JSON.stringify(databaseConfig, null, 2)
})

**Get Sandbox Logs**

mcp__flow-nexus__sandbox_logs({
  sandbox_id: "sandbox_id",
  lines: 100 // max 1000
})

**Stop Sandbox**

mcp__flow-nexus__sandbox_stop({
  sandbox_id: "sandbox_id"
})

**Delete Sandbox**

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**

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**

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**

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**

mcp__flow-nexus__app_search({
  search: "authentication api",
  category: "backend",
  featured: true,
  limit: 20
})

**Get App Details**

mcp__flow-nexus__app_get({
  app_id: "app_id"
})

**List Templates*