SparkUI

// Settings → Developer → Edit Config
{
  "mcpServers": {
    "sparkui": {
      "command": "npx",
      "args": ["@limeade-labs/sparkui", "mcp"],
      "env": {
        "SPARKUI_URL": "https://your-sparkui-server.com",
        "SPARKUI_TOKEN": "spk_your_token"
      }
    }
  }
}

// Restart Claude. Try: "Create a poll asking my team about lunch"

claude mcp add sparkui \
  -e SPARKUI_URL=https://your-sparkui-server.com \
  -e SPARKUI_TOKEN=spk_your_token \
  -- npx @limeade-labs/sparkui mcp

# Try: "Build me a feedback form for the new feature"

// Configure → Actions → Add Action
// Import OpenAPI spec from your server:

Schema URL: https://your-sparkui-server.com/api/openapi.json

// Set Authentication → API Key → Bearer token
// Header: Authorization | Value: Bearer spk_your_token

// Your GPT gets: push (templates), compose (components), templates (list)
// Try: "Create a checkout page for my $29.99 product"

// Add SparkUI as a function declaration:
{
  "name": "sparkui_push",
  "description": "Generate an interactive web UI",
  "parameters": {
    "template": { "type": "string" },
    "data": { "type": "object" }
  }
}

// Handler forwards to: POST https://your-server.com/api/push
// Returns a URL → Gemini shares it with the user

{
  "mcpServers": {
    "sparkui": {
      "command": "npx",
      "args": ["@limeade-labs/sparkui", "mcp"],
      "env": {
        "SPARKUI_URL": "https://your-sparkui-server.com",
        "SPARKUI_TOKEN": "spk_your_token"
      }
    }
  }
}

// Also works with .windsurf/mcp.json — same format.
// Try: "Create a comparison table for these 3 API options"

curl -X POST https://your-sparkui-server.com/api/push \
  -H "Authorization: Bearer spk_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "poll",
    "data": {
      "question": "Where should we eat?",
      "options": ["Thai", "Pizza", "Sushi", "Tacos"]
    }
  }'

# → { "url": "/s/abc123", "fullUrl": "https://..." }
# Share the link. Listen on WebSocket for results.