skills-ws 1.4.1 → 1.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Commit Media SARL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,11 +1,12 @@
-# SKILLS.ws
+# skills.ws
 
-77 expert agent skills for AI coding assistants.
+Agent skills for AI coding assistants. 81 skills across 8 categories — built for OpenClaw, Claude Code, Cursor, Codex, and any agent that supports the SKILL.md format.
 
-**Website:** [SKILLS.ws](https://skills.ws)
-**npm:** [npmjs.com/package/skills-ws](https://www.npmjs.com/package/skills-ws)
+**Website:** [skills.ws](https://skills.ws) | **npm:** [skills-ws](https://www.npmjs.com/package/skills-ws) | **Docs:** [llms-full.txt](https://skills.ws/llms-full.txt)
 
-## Install skills
+---
+
+## Quick Start
 
 ```bash
 npx skills-ws install          # interactive picker
@@ -14,32 +15,193 @@ npx skills-ws install all      # install everything
 npx skills-ws list             # list available skills
 ```
 
-## What are skills?
+Skills are `SKILL.md` files that give AI coding assistants specialized knowledge — workflows, checklists, code patterns, and domain expertise. Install a skill and your agent gains expert-level capability in that domain.
+
+---
+
+## Skills (81 across 8 categories)
+
+### Marketing (15)
+SEO/GEO, content strategy, copywriting, paid ads, email sequences, PR/media, influencer marketing, brand strategy, webinars, blog engine, and more.
+
+### Dev (16)
+Git workflow, CI/CD, API design, database design, testing, web performance, security hardening, prompt engineering, AI agent design, MVP launcher, Next.js stack.
+
+### Growth (10)
+Social media, community building, customer feedback, business development, cold outreach, competitor intelligence, affiliate marketing.
+
+### Operations (11)
+EU legal compliance (GDPR, AI Act, DSA), hiring/team building, project management, CRM, accounting, revenue ops.
 
-Skills are `SKILL.md` files that give AI coding assistants specialized knowledge — workflows, checklists, code patterns, and domain expertise. Compatible with OpenClaw, Claude Code, Cursor, Codex, and any agent that supports the SKILL.md format.
+### Conversion (8)
+Landing pages, signup flows, popups, A/B testing, pricing optimization, lead scoring, CRO, sales funnels.
 
-## Categories
+### Analytics (7)
+Google Analytics, Search Console, Bing/Yandex Webmaster, data analytics, retention analytics.
 
-- **Marketing** — SEO/GEO, content strategy, copywriting, paid ads, email sequences, PR/media, influencer, brand strategy, webinars, blog engine, social media kit
-- **Dev** — Git workflow, CI/CD, API design, database design, testing, web performance, security hardening, prompt engineering, AI agent building, MVP launcher, Next.js stack, Next.js performance, PostgreSQL, Docker, AWS deploy, monitoring, Stripe billing, auth
-- **Growth** — Social media, community building, customer feedback, business development, cold outreach, competitor intelligence, affiliate marketing, growth hacking, product-led growth, marketplace launch
-- **Conversion** — Landing pages, signup flows, popups, A/B testing, pricing optimization, lead scoring, CRO, sales funnels
-- **Analytics** — Google Analytics, Search Console, Bing/Yandex Webmaster, data analytics, retention analytics, marketing analytics, on-chain analytics
-- **Operations** — EU legal compliance (GDPR, AI Act, DSA), EU tax & accounting, hiring/team building, project management, CRM, revenue ops
-- **Web3** — Solidity dev, DeFi integration, smart contract auditor, wallet integration, Aleph Cloud self-deployment
-- **Design** — UI/UX Pro Max, landing page builder, design system, ASCII banner
+### Web3 (6)
+Blockchain deployment, Aleph Cloud, decentralized infrastructure.
+
+### Design (4)
+UI/UX Pro Max, landing page builder, ASCII banner.
+
+---
+
+## How Skills Work
+
+```
+┌─────────────────────────────────────────┐
+│            AI Coding Assistant           │
+│  (OpenClaw, Claude Code, Cursor, Codex) │
+│                                         │
+│  ┌───────────────────────────────────┐  │
+│  │          SKILL.md files           │  │
+│  │  Loaded into agent context on     │  │
+│  │  startup — gives the agent        │  │
+│  │  domain expertise, workflows,     │  │
+│  │  checklists, and code patterns    │  │
+│  └───────────────────────────────────┘  │
+└─────────────────────────────────────────┘
+```
+
+1. You install a skill via `npx skills-ws install <name>`
+2. A `SKILL.md` file is placed in your agent's skills directory
+3. Your AI assistant reads it on startup and gains that expertise
+4. Ask your assistant to do anything related to that domain — it now knows the best practices, patterns, and workflows
+
+Skills are **markdown only** — no executable code, no runtime dependencies, no supply chain risk.
+
+---
+
+## CLI Reference
+
+```bash
+# Interactive mode — browse and select skills
+npx skills-ws install
+
+# Install a specific skill
+npx skills-ws install seo-geo
+
+# Install multiple skills
+npx skills-ws install seo-geo copywriting ab-testing
+
+# Install all skills
+npx skills-ws install all
+
+# List available skills with categories
+npx skills-ws list
+
+# Install to a custom directory
+npx skills-ws install seo-geo --dir ./my-agent/skills
+```
+
+The CLI auto-detects your agent type (OpenClaw, Claude Code, Cursor, Codex) and installs to the correct directory.
+
+---
+
+## Website Features
+
+The [skills.ws](https://skills.ws) website provides:
+
+- **Searchable skill grid** — filter by category, search by name
+- **Individual skill pages** — full SKILL.md content rendered as Markdown
+- **One-click install commands** — copy `npx` command to clipboard
+- **Live npm download counter** — monthly download stats
+- **VirusTotal scan status** — every skill file is scanned
+
+### Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `/` | Focus search |
+| `Esc` | Clear search |
+
+---
 
 ## Development
 
 ```bash
+git clone https://github.com/san-npm/skills-ws.git
+cd skills-ws
 npm install
 npm run dev       # http://localhost:3000
 npm run build     # static export to out/
+npm run lint      # ESLint + Next.js linter
+```
+
+### Stack
+
+- **Next.js 14** — static export (SSG), App Router
+- **React 18** + TypeScript 5
+- **Tailwind CSS 3.4** — dark theme
+- **Three.js** — WebGL ASCII art background (homepage)
+- **react-markdown** + remark-gfm — SKILL.md rendering
+
+### Project Structure
+
+```
+skills-ws/
+├── app/                    # Next.js App Router
+│   ├── page.tsx            # Homepage — ASCII hero, skill grid, stats
+│   ├── skills/[name]/      # Dynamic skill detail pages (SSG)
+│   ├── docs/               # How agent skills work
+│   ├── cli/                # CLI reference
+│   ├── faq/                # FAQ with accordion
+│   └── sitemap.ts          # Dynamic XML sitemap
+├── components/             # React components
+│   ├── AsciiBackground.tsx # Three.js WebGL → ASCII canvas
+│   ├── SkillsGrid.tsx      # Searchable/filterable skill grid
+│   ├── SkillContent.tsx    # Markdown renderer
+│   ├── InstallBox.tsx      # Copy-to-clipboard install command
+│   └── NpmDownloads.tsx    # Live npm download counter
+├── lib/
+│   └── skills.ts           # Skill data access + TypeScript interfaces
+├── skills/                 # Raw SKILL.md files (81 directories)
+├── public/
+│   ├── skills.json         # Skills database (81 skills, all metadata + content)
+│   ├── llms.txt            # LLM-readable skill index
+│   ├── llms-full.txt       # Full content dump for LLMs
+│   ├── robots.txt          # Crawl directives
+│   └── install.sh          # Bash installer script
+└── skills.json             # Master skills database
 ```
 
+### Build Output
+
+Static export generates ~85 pages:
+- Homepage + docs + CLI + FAQ + 404
+- 81 individual skill detail pages
+- XML sitemap
+
+No server needed — deploy to any static host (Vercel, Netlify, GitHub Pages, S3).
+
+---
+
+## SEO & Structured Data
+
+- Dynamic XML sitemap with all skill pages
+- OpenGraph + Twitter Card meta tags
+- JSON-LD schemas: Organization, WebSite, SoftwareApplication, BreadcrumbList, FAQPage
+- Google Analytics 4 integration
+- `llms.txt` + `llms-full.txt` for AI crawlers
+- `robots.txt` with sitemap reference
+
+---
+
 ## Security
 
-See [SECURITY.md](SECURITY.md) for vulnerability reporting and security model.
+Skills are **markdown files only** — no executable code.
+
+- Zero runtime dependencies (no supply chain risk)
+- No `eval()`, `exec()`, or `child_process` patterns
+- All skills built in-house, no third-party content
+- VirusTotal scanning on all skill files
+- Environment-only credentials (nothing hardcoded)
+- npm package published with Sigstore provenance attestation
+
+See [SECURITY.md](SECURITY.md) for vulnerability reporting.
+
+---
 
 ## License
 

package/bin/cli.mjs

@@ -2,9 +2,8 @@
 
 import { readdir, readFile, copyFile, mkdir, stat } from "node:fs/promises";
 import { join, dirname } from "node:path";
-import { createInterface } from "node:readline";
-import { fileURLToPath } from "node:url";
 import readline from "node:readline";
+import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const SKILLS_DIR = join(__dirname, "..", "skills");
@@ -266,142 +265,121 @@ async function detectTarget() {
   return defaultTarget;
 }
 
-// ── Main ─────────────────────────────────────────────────────
-
-async function main() {
-  const args = process.argv.slice(2);
-  const skills = await getSkills();
-
-  await playBanner();
+// ── Interactive Picker ───────────────────────────────────────
 
-  if (args[0] === "list" || args[0] === "ls") {
-    for (const s of skills) {
-      process.stdout.write(`  ${GREEN}${s.name.padEnd(24)}${R}${DIM}${s.desc.slice(0, 55)}${R}\n`);
-    }
-    process.stdout.write(`\n  ${DIM}${skills.length} skills | npx skills-ws install <name>${R}\n\n`);
-    return;
+async function interactivePick(skills) {
+  for (let i = 0; i < skills.length; i++) {
+    process.stdout.write(
+      `  ${GRAY}${String(i + 1).padStart(2)}${R} ${GREEN}${skills[i].name.padEnd(24)}${R}${DIM}${skills[i].desc.slice(0, 50)}${R}\n`
+    );
   }
-
-  if (args[0] === "install" || args[0] === "add") {
-    const names = args.slice(1);
-
-    if (names.length === 0) {
-      for (let i = 0; i < skills.length; i++) {
-        process.stdout.write(
-          `  ${GRAY}${String(i + 1).padStart(2)}${R} ${GREEN}${skills[i].name.padEnd(24)}${R}${DIM}${skills[i].desc.slice(0, 50)}${R}\n`
-        );
-      }
-      process.stdout.write(`\n  ${YELLOW}Enter numbers or names (comma-separated), or 'all':${R}\n`);
-
-      const rl = createInterface({ input: process.stdin, output: process.stdout });
-      const answer = await new Promise((resolve) => rl.question(`  ${CYAN}> ${R}`, resolve));
-      rl.close();
-
-      if (answer.trim().toLowerCase() === "all") {
-        names.push(...skills.map((s) => s.name));
-      } else {
-        for (const part of answer.split(",").map((s) => s.trim()).filter(Boolean)) {
-          const num = parseInt(part);
-          if (!isNaN(num) && num >= 1 && num <= skills.length) names.push(skills[num - 1].name);
-          else names.push(part);
-        }
-      }
+  process.stdout.write(`\n  ${YELLOW}Enter numbers or names (comma-separated), or 'all':${R}\n`);
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await new Promise((resolve) => rl.question(`  ${CYAN}> ${R}`, resolve));
+  rl.close();
+
+  const names = [];
+  if (answer.trim().toLowerCase() === "all") {
+    names.push(...skills.map((s) => s.name));
+  } else {
+    for (const part of answer.split(",").map((s) => s.trim()).filter(Boolean)) {
+      const num = parseInt(part);
+      if (!isNaN(num) && num >= 1 && num <= skills.length) names.push(skills[num - 1].name);
+      else names.push(part);
     }
+  }
+  return names;
+}
 
-    if (names.length === 0) {
-      process.stdout.write(`  ${DIM}Nothing selected.${R}\n`);
-      return;
-    }
+async function installSkills(names, skills, customDir) {
+  if (names.length === 0) {
+    process.stdout.write(`  ${DIM}Nothing selected.${R}\n`);
+    return;
+  }
 
-    const target = await detectTarget();
-    process.stdout.write(`\n  ${DIM}${target}${R}\n\n`);
+  const target = customDir || await detectTarget();
+  process.stdout.write(`\n  ${DIM}${target}${R}\n\n`);
 
-    let installed = 0;
-    for (const name of names) {
-      const skill = skills.find((s) => s.name === name);
-      if (!skill) {
-        process.stdout.write(`  ${YELLOW}skip${R} ${name} ${DIM}(not found)${R}\n`);
-        continue;
-      }
-      await copyDir(skill.dir, join(target, name));
-      installed++;
+  let installed = 0;
+  for (const name of names) {
+    const skill = skills.find((s) => s.name === name);
+    if (!skill) {
+      process.stdout.write(`  ${YELLOW}skip${R} ${name} ${DIM}(not found)${R}\n`);
+      continue;
     }
+    await copyDir(skill.dir, join(target, name));
+    installed++;
+  }
 
-    await playInstallProgress(installed);
-    process.stdout.write("\n");
+  await playInstallProgress(installed);
+  process.stdout.write("\n");
 
-    for (const name of names) {
-      if (skills.find((s) => s.name === name)) {
-        process.stdout.write(`  ${GREEN}+${R} ${name}\n`);
-      }
+  for (const name of names) {
+    if (skills.find((s) => s.name === name)) {
+      process.stdout.write(`  ${GREEN}+${R} ${name}\n`);
     }
-    process.stdout.write(`\n  ${DIM}skills.ws${R}\n\n`);
-    return;
   }
+  process.stdout.write(`\n  ${DIM}skills.ws${R}\n\n`);
+}
 
-  // No args = interactive install (same as `install`)
-  if (!args[0] || args[0] === "help" || args[0] === "-h" || args[0] === "--help") {
-    if (args[0] === "help" || args[0] === "-h" || args[0] === "--help") {
-      process.stdout.write(`  ${B}Usage:${R}\n\n`);
-      process.stdout.write(`    ${CYAN}npx skills-ws${R}                    Interactive picker\n`);
-      process.stdout.write(`    ${CYAN}npx skills-ws list${R}              List all skills\n`);
-      process.stdout.write(`    ${CYAN}npx skills-ws install <name>${R}     Install specific skill(s)\n`);
-      process.stdout.write(`    ${CYAN}npx skills-ws install all${R}        Install everything\n`);
-      process.stdout.write(`\n  ${DIM}${skills.length} skills | skills.ws${R}\n\n`);
-      return;
-    }
-
-    // Interactive picker
-    for (let i = 0; i < skills.length; i++) {
-      process.stdout.write(
-        `  ${GRAY}${String(i + 1).padStart(2)}${R} ${GREEN}${skills[i].name.padEnd(24)}${R}${DIM}${skills[i].desc.slice(0, 50)}${R}\n`
-      );
-    }
-    process.stdout.write(`\n  ${YELLOW}Enter numbers or names (comma-separated), or 'all':${R}\n`);
+// ── Main ─────────────────────────────────────────────────────
 
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    const answer = await new Promise((resolve) => rl.question(`  ${CYAN}> ${R}`, resolve));
-    rl.close();
+async function main() {
+  const rawArgs = process.argv.slice(2);
+  const skills = await getSkills();
 
-    const names = [];
-    if (answer.trim().toLowerCase() === "all") {
-      names.push(...skills.map((s) => s.name));
+  // Parse --dir flag from anywhere in args
+  let customDir = null;
+  const args = [];
+  for (let i = 0; i < rawArgs.length; i++) {
+    if (rawArgs[i] === "--dir" && i + 1 < rawArgs.length) {
+      customDir = rawArgs[i + 1];
+      i++; // skip next
     } else {
-      for (const part of answer.split(",").map((s) => s.trim()).filter(Boolean)) {
-        const num = parseInt(part);
-        if (!isNaN(num) && num >= 1 && num <= skills.length) names.push(skills[num - 1].name);
-        else names.push(part);
-      }
+      args.push(rawArgs[i]);
     }
+  }
 
-    if (names.length === 0) {
-      process.stdout.write(`  ${DIM}Nothing selected.${R}\n`);
-      return;
+  await playBanner();
+
+  if (args[0] === "list" || args[0] === "ls") {
+    for (const s of skills) {
+      process.stdout.write(`  ${GREEN}${s.name.padEnd(24)}${R}${DIM}${s.desc.slice(0, 55)}${R}\n`);
     }
+    process.stdout.write(`\n  ${DIM}${skills.length} skills | npx skills-ws install <name>${R}\n\n`);
+    return;
+  }
 
-    const target = await detectTarget();
-    process.stdout.write(`\n  ${DIM}${target}${R}\n\n`);
+  if (args[0] === "install" || args[0] === "add") {
+    let names = args.slice(1);
 
-    let installed = 0;
-    for (const name of names) {
-      const skill = skills.find((s) => s.name === name);
-      if (!skill) {
-        process.stdout.write(`  ${YELLOW}skip${R} ${name} ${DIM}(not found)${R}\n`);
-        continue;
-      }
-      await copyDir(skill.dir, join(target, name));
-      installed++;
+    // Handle "all" keyword
+    if (names.includes("all")) {
+      names = skills.map((s) => s.name);
+    } else if (names.length === 0) {
+      names = await interactivePick(skills);
     }
 
-    await playInstallProgress(installed);
-    process.stdout.write("\n");
+    await installSkills(names, skills, customDir);
+    return;
+  }
 
-    for (const name of names) {
-      if (skills.find((s) => s.name === name)) {
-        process.stdout.write(`  ${GREEN}+${R} ${name}\n`);
-      }
-    }
-    process.stdout.write(`\n  ${DIM}skills.ws${R}\n\n`);
+  if (args[0] === "help" || args[0] === "-h" || args[0] === "--help") {
+    process.stdout.write(`  ${B}Usage:${R}\n\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws${R}                    Interactive picker\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws list${R}              List all skills\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws install <name>${R}     Install specific skill(s)\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws install all${R}        Install everything\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws install --dir .${R}    Install to custom directory\n`);
+    process.stdout.write(`\n  ${DIM}${skills.length} skills | skills.ws${R}\n\n`);
+    return;
+  }
+
+  // No args = interactive install
+  if (!args[0]) {
+    const names = await interactivePick(skills);
+    await installSkills(names, skills, customDir);
     return;
   }
 }

package/package.json

@@ -1,33 +1,9 @@
 {
   "name": "skills-ws",
-  "version": "1.4.1",
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start",
-    "lint": "next lint"
-  },
-  "dependencies": {
-    "@vercel/analytics": "^1.6.1",
-    "next": "14.2.35",
-    "react": "^18",
-    "react-dom": "^18",
-    "react-markdown": "^10.1.0",
-    "remark-gfm": "^4.0.1",
-    "three": "^0.183.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20",
-    "@types/react": "^18",
-    "@types/react-dom": "^18",
-    "@types/three": "^0.183.1",
-    "postcss": "^8",
-    "tailwindcss": "^3.4.1",
-    "typescript": "^5"
-  },
-  "description": "77 expert agent skills for AI coding assistants — marketing, growth, web3, dev, design & operations. Built for OpenClaw, Claude Code, Cursor, and Codex.",
+  "version": "1.5.1",
+  "description": "81 agent skills for AI coding assistants \u2014 marketing, growth, web3, dev, design & operations. Built for OpenClaw, Claude Code, Cursor, and Codex.",
   "bin": {
-    "skills-ws": "bin/cli.mjs"
+    "skills-ws": "./bin/cli.mjs"
   },
   "keywords": [
     "ai",
@@ -57,11 +33,24 @@
     "design-system",
     "auth"
   ],
+  "author": "Commit Media <bob@openletz.com> (https://openletz.com)",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/san-npm/skills-ws"
   },
   "homepage": "https://skills.ws",
-  "author": "skills.ws"
-}
+  "bugs": {
+    "url": "https://github.com/san-npm/skills-ws/issues"
+  },
+  "files": [
+    "bin/",
+    "skills/",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/skills/ai-agent-building/SKILL.md

@@ -24,7 +24,7 @@ LangGraph is the production-grade choice for complex agents. It gives you explic
 ### Basic Agent with Tool Calling
 
 ```python
-# pip install langgraph langchain-openai
+# pip install langgraph langchain-openai langgraph-checkpoint-sqlite
 from typing import Annotated, TypedDict
 from langgraph.graph import StateGraph, START, END
 from langgraph.graph.message import add_messages
@@ -306,8 +306,8 @@ def with_retry(max_retries: int = 3):
     return decorator
 
 @tool
-@with_timeout(30)
 @with_retry(3)
+@with_timeout(30)
 async def query_database(sql: str) -> str:
     """Execute a read-only SQL query against the analytics database.
 
@@ -659,23 +659,25 @@ def sanitize_user_input(text: str) -> str:
 ### Output Validation
 
 ```python
-from pydantic import BaseModel, validator
+from pydantic import BaseModel, field_validator
 
 class AgentResponse(BaseModel):
     answer: str
     sources: list[str]
     confidence: float
 
-    @validator("answer")
-    def no_system_leaks(cls, v):
+    @field_validator("answer")
+    @classmethod
+    def no_system_leaks(cls, v: str) -> str:
         forbidden = ["system prompt", "you are an AI", "as an AI language model"]
         for phrase in forbidden:
             if phrase.lower() in v.lower():
                 raise ValueError("Response contained forbidden content")
         return v
 
-    @validator("confidence")
-    def valid_range(cls, v):
+    @field_validator("confidence")
+    @classmethod
+    def valid_range(cls, v: float) -> float:
         if not 0 <= v <= 1:
             raise ValueError("Confidence must be between 0 and 1")
         return v
@@ -783,7 +785,7 @@ MCP is the standard for connecting agents to external tools. Instead of hardcodi
 ```typescript
 // mcp-server.ts — expose tools for any MCP-compatible agent
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import express from 'express';
 
 const server = new McpServer({ name: 'my-tools', version: '1.0.0' });
@@ -814,20 +816,16 @@ server.tool('create_ticket', 'Create a support ticket in Jira', {
   };
 });
 
-// SSE transport for remote connections
+// Streamable HTTP transport (replaces deprecated SSE transport)
 const app = express();
-const transports: Record<string, SSEServerTransport> = {};
+app.use(express.json());
 
-app.get('/mcp/sse', async (req, res) => {
-  const transport = new SSEServerTransport('/mcp/messages', res);
-  transports[transport.sessionId] = transport;
-  res.on('close', () => delete transports[transport.sessionId]);
+app.post('/mcp', async (req, res) => {
+  const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: undefined, // stateless
+  });
   await server.connect(transport);
-});
-
-app.post('/mcp/messages', async (req, res) => {
-  const sessionId = req.query.sessionId as string;
-  await transports[sessionId]?.handlePostMessage(req, res);
+  await transport.handleRequest(req, res);
 });
 
 app.listen(3100, () => console.log('MCP server on :3100'));