seedflip-mcp 0.1.1 → 0.1.2

package/README.md

@@ -1,6 +1,20 @@
 # SeedFlip MCP Server
 
-Gives AI agents access to 100+ curated design systems. When an agent needs a design direction, it calls SeedFlip instead of guessing colors and fonts.
+> Give your AI coding agent design taste. 100+ curated design systems, zero guessing.
+
+When an AI agent needs a design direction, it calls SeedFlip instead of guessing colors and fonts. Works with Claude Desktop, Cursor, Claude Code, Windsurf, and any MCP-compatible tool.
+
+## Install
+
+```bash
+npm install -g seedflip-mcp
+```
+
+Or run directly with no install:
+
+```bash
+npx -y seedflip-mcp
+```
 
 ## Setup
 
@@ -13,30 +27,43 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
   "mcpServers": {
     "seedflip": {
       "command": "npx",
-      "args": ["tsx", "/Users/LUKE/design-shuffle/mcp/src/index.ts"]
+      "args": ["-y", "seedflip-mcp"]
     }
   }
 }
 ```
 
-### Claude Code
+### Cursor
 
-Add to `.claude/settings.json` or run:
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "seedflip": {
+      "command": "npx",
+      "args": ["-y", "seedflip-mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
 
 ```bash
-claude mcp add seedflip -- npx tsx /Users/LUKE/design-shuffle/mcp/src/index.ts
+claude mcp add seedflip -- npx -y seedflip-mcp
 ```
 
-### Cursor
+### Windsurf
 
-Add to `.cursor/mcp.json`:
+Add to your MCP config:
 
 ```json
 {
   "mcpServers": {
     "seedflip": {
       "command": "npx",
-      "args": ["tsx", "/Users/LUKE/design-shuffle/mcp/src/index.ts"]
+      "args": ["-y", "seedflip-mcp"]
     }
   }
 }
@@ -48,16 +75,16 @@ Add to `.cursor/mcp.json`:
 
 Get a curated design system by reference, vibe, or style.
 
+- **Brand references:** "Stripe", "Vercel", "Linear", "GitHub", "Notion", "Supabase", "Spotify", "Framer", "Resend", "Superhuman", "Raycast", "Arc"
+- **Style descriptors:** "dark minimal", "brutalist", "warm editorial", "neon cyberpunk", "elegant luxury"
+- **Export formats:** `tokens` (default), `tailwind`, `css`, `shadcn`
+- **Multiple results:** Set `count: 3` to get top 3 matches
+
 ```
-query: "Stripe"           → Returns the Stripe-inspired seed
-query: "dark minimal"     → Returns a dark, minimal seed
-query: "brutalist"        → Returns a brutalist seed
-query: "warm editorial"   → Returns a warm editorial seed
-format: "tailwind"        → Returns a ready-to-use tailwind.config.ts
-format: "css"             → Returns CSS custom properties
-format: "shadcn"          → Returns shadcn/ui theme
-format: "tokens"          → Returns all values with design brief (default)
-count: 3                  → Returns top 3 matches
+"get me a design system like Stripe"
+"dark minimal SaaS theme in tailwind format"
+"warm editorial blog design"
+"give me 3 options for a developer tool"
 ```
 
 ### `list_design_seeds`
@@ -70,10 +97,21 @@ tag: "brutalist"  → All brutalist seeds
 tag: "warm"       → All warm-toned seeds
 ```
 
-## Updating Seeds
+## What You Get
 
-After adding/changing seeds in `src/lib/seeds.ts`, run:
+Each seed includes production-ready values for:
 
-```bash
-npx tsx mcp/scripts/extract-seeds.mjs
-```
+- **Typography:** Heading + body font pairing, weights, letter spacing
+- **Colors:** Background, surface, text, accent, muted, border, gradient
+- **Shape:** Border radius (sm, default, xl)
+- **Depth:** Box shadows
+- **Design brief:** AI-ready prompt describing the full aesthetic
+
+## Why
+
+Every vibe-coded app looks the same because AI agents don't have design vocabulary. They default to the same zinc palette, the same rounded corners, the same "modern minimalist" output. SeedFlip gives them 100+ curated design directions pulled from real, proven brands.
+
+## Links
+
+- [seedflip.co](https://seedflip.co) — Try it in the browser
+- [npm](https://www.npmjs.com/package/seedflip-mcp) — Package page

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "seedflip-mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
+  "mcpName": "io.github.bockenstette1/seedflip",
   "description": "MCP server for SeedFlip — 100+ curated design systems for AI agents. When your agent needs a design direction, it calls SeedFlip instead of guessing.",
   "type": "module",
   "bin": {