@vailent/pulse-mcp 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,113 @@
+# @vailent/pulse-mcp
+
+Pulse MCP server for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Manage pods, features, workstreams, bugs, and more — all from your terminal.
+
+## Quick Setup (2 minutes)
+
+### 1. Create an npm account (skip if you have one)
+
+```bash
+npm adduser
+```
+
+Follow the prompts to create your account at [npmjs.com](https://www.npmjs.com/signup).
+
+### 2. Get added to the Vailent npm org
+
+Ask Sal to invite you using your npm username. You'll get an email — accept the invite.
+
+### 3. Log in to the Vailent scope
+
+```bash
+npm login --scope=@vailent
+```
+
+### 4. Add to Claude Code
+
+Run this once from any directory:
+
+```bash
+claude mcp add pulse-dev -- npx -y @vailent/pulse-mcp
+```
+
+### 5. Verify it works
+
+Open Claude Code and ask:
+
+```
+what pods exist?
+```
+
+You should see a list of active pods. That's it — you're connected.
+
+## What You Can Do
+
+Talk to Claude naturally — the MCP tools handle the rest.
+
+| Ask Claude... | What happens |
+|---|---|
+| "What pods exist?" | Lists all active pods with members |
+| "Show me features for this week" | Lists features by pod and week |
+| "Create a feature called Auth Revamp in pod X" | Creates a new feature |
+| "What bugs are open?" | Lists open bugs with priority |
+| "Show me pending suggestions" | Lists AI suggestions needing review |
+| "Give me my daily briefing" | AI-generated focus items for today |
+| "What happened this week?" | Searches activity history |
+| "Show the team roster" | Lists team members and pod assignments |
+| "What feature requests came in?" | Lists feature requests by source |
+
+### All 11 Tools
+
+| Tool | Description |
+|---|---|
+| `pulse_pods` | List, get, create, update pods |
+| `pulse_pod_members` | Manage pod membership (add, remove, update roles) |
+| `pulse_features` | List, get, create, update features with phase/step tracking |
+| `pulse_workstreams` | Manage workstreams (projects) |
+| `pulse_requests` | View and manage feature requests |
+| `pulse_bugs` | View and manage bug reports |
+| `pulse_suggestions` | Review, approve, reject AI suggestions |
+| `pulse_events` | Query the activity event stream |
+| `pulse_history` | Search across all historical data |
+| `pulse_briefing` | Generate AI daily briefing by role |
+| `pulse_team` | View team members and assignments |
+
+## Troubleshooting
+
+### "Tool not found" or MCP not connecting
+
+Make sure the server is registered:
+```bash
+claude mcp list
+```
+
+You should see `pulse-dev` in the list. If not, re-run step 4.
+
+### "Missing Supabase credentials" error
+
+This shouldn't happen — the dev database is preconfigured. If it does, set these env vars:
+
+```bash
+export PULSE_SUPABASE_URL=https://eppugcfjlqovlauykzfe.supabase.co
+export PULSE_SUPABASE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImVwcHVnY2ZqbHFvdmxhdXlremZlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzQwNTg2NTYsImV4cCI6MjA4OTYzNDY1Nn0.x9u7sSKnSlTFRWCu--D8zt81IuOmoXXHG3fb3kcRvBc
+```
+
+### Need to update to the latest version
+
+```bash
+npx -y @vailent/pulse-mcp@latest
+```
+
+Or clear the npx cache:
+```bash
+npx clear-npx-cache && claude mcp remove pulse-dev && claude mcp add pulse-dev -- npx -y @vailent/pulse-mcp
+```
+
+## Advanced: Custom Supabase Instance
+
+To point at a different Supabase project, set these env vars before running Claude Code:
+
+```bash
+export PULSE_SUPABASE_URL=https://your-project.supabase.co
+export PULSE_SUPABASE_KEY=your-anon-key
+```

package/dist/server.js

@@ -40386,12 +40386,11 @@ function shouldShowDeprecationWarning() {
 if (shouldShowDeprecationWarning()) console.warn("\u26A0\uFE0F  Node.js 18 and below are deprecated and will no longer be supported in future versions of @supabase/supabase-js. Please upgrade to Node.js 20 or later. For more information, visit: https://github.com/orgs/supabase/discussions/37217");
 
 // lib/supabase.ts
+var DEFAULT_URL = "https://eppugcfjlqovlauykzfe.supabase.co";
+var DEFAULT_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImVwcHVnY2ZqbHFvdmxhdXlremZlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzQwNTg2NTYsImV4cCI6MjA4OTYzNDY1Nn0.x9u7sSKnSlTFRWCu--D8zt81IuOmoXXHG3fb3kcRvBc";
 function getAdminClient() {
-  const url2 = process.env.PULSE_SUPABASE_URL || process.env.NEXT_PUBLIC_SUPABASE_URL;
-  const key = process.env.PULSE_SUPABASE_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY;
-  if (!url2 || !key) {
-    throw new Error("Missing Supabase credentials. Set PULSE_SUPABASE_URL + PULSE_SUPABASE_KEY (or NEXT_PUBLIC_SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY)");
-  }
+  const url2 = process.env.PULSE_SUPABASE_URL || process.env.NEXT_PUBLIC_SUPABASE_URL || DEFAULT_URL;
+  const key = process.env.PULSE_SUPABASE_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY || DEFAULT_KEY;
   return createClient(url2, key);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vailent/pulse-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Pulse MCP server — manage pods, features, workstreams, bugs, and more from Claude Code",
   "type": "module",
   "bin": {
@@ -23,13 +23,14 @@
     "typescript": "^5"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "keywords": ["mcp", "pulse", "project-management", "claude-code"],
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
-    "url": "https://github.com/salcatch/pulse.git",
+    "url": "https://github.com/vailent-technology/pulse.git",
     "directory": "src/mcp"
   }
 }