@spotnik/superplanner-mcp 0.1.1

package/README.md

@@ -0,0 +1,66 @@
+# @spotnik/superplanner-mcp
+
+MCP server for [SuperPlanner](https://superplanner.monday.app). Works with any MCP-compatible client: Claude Desktop, Cursor, Windsurf, Continue, and more.
+
+Full documentation: [docs.spot-nik.com/superplanner/mcp](https://docs.spot-nik.com/superplanner/mcp)
+
+## Requirements
+
+- Node.js 18+
+- A SuperPlanner API token (`sp_...`) — generate one in SuperPlanner → Settings → API Tokens
+
+## Setup
+
+The server is launched via `npx` — no global install needed. Configure your MCP client to run it with your token and region.
+
+### Claude Desktop
+
+`claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "superplanner": {
+      "command": "npx",
+      "args": ["-y", "@spotnik/superplanner-mcp", "--token", "sp_xxx", "--region", "us"]
+    }
+  }
+}
+```
+
+### Cursor
+
+`.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "superplanner": {
+      "command": "npx",
+      "args": ["-y", "@spotnik/superplanner-mcp", "--token", "sp_xxx", "--region", "us"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+`~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "superplanner": {
+      "command": "npx",
+      "args": ["-y", "@spotnik/superplanner-mcp", "--token", "sp_xxx", "--region", "us"]
+    }
+  }
+}
+```
+
+## Options
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--token` | yes | Your `sp_...` API token |
+| `--region` | yes | Server region: `us`, `eu`, `au`, `il` |

package/dist/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+const REGIONS = {
+    us: 'https://live1-service-7042312-f94c764b.us.monday.app/mcp',
+    eu: 'https://live1-service-7042312-f94c764b.eu.monday.app/mcp',
+    au: 'https://live1-service-7042312-f94c764b.au.monday.app/mcp',
+    il: 'https://live1-service-7042312-f94c764b.il.monday.app/mcp',
+};
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const tokenIdx = args.indexOf('--token');
+    const regionIdx = args.indexOf('--region');
+    if (tokenIdx === -1 || !args[tokenIdx + 1] || regionIdx === -1 || !args[regionIdx + 1]) {
+        console.error('Usage: superplanner-mcp --token <sp_token> --region us|eu|au|il');
+        process.exit(1);
+    }
+    return { token: args[tokenIdx + 1], region: args[regionIdx + 1] };
+}
+async function main() {
+    const { token, region } = parseArgs();
+    const initialUrl = REGIONS[region];
+    if (!initialUrl) {
+        console.error(`Unknown region "${region}". Valid: ${Object.keys(REGIONS).join(', ')}`);
+        process.exit(1);
+    }
+    let client = new Client({ name: 'superplanner-mcp', version: '0.1.0' });
+    async function connectTo(url) {
+        await client.connect(new StreamableHTTPClientTransport(new URL(url), {
+            requestInit: { headers: { Authorization: `Bearer ${token}` } },
+        }));
+    }
+    async function reconnectTo(url) {
+        await client.close();
+        client = new Client({ name: 'superplanner-mcp', version: '0.1.0' });
+        await connectTo(url);
+    }
+    await connectTo(initialUrl);
+    const server = new McpServer({ name: 'superplanner-mcp', version: '0.1.0' });
+    server.server.setRequestHandler(ListToolsRequestSchema, () => client.listTools());
+    server.server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const result = await client.callTool(req.params);
+        if (result.isError) {
+            const content = result.content ?? [];
+            const errorText = content
+                .map((c) => (c.type === 'text' ? (c.text ?? '') : ''))
+                .join('');
+            // Backend returns "Wrong region. Connect to: <url>" — reconnect and retry once.
+            const match = errorText.match(/^Wrong region\. Connect to: (https?:\/\/\S+)/);
+            if (match) {
+                const correctBase = match[1].replace(/\/mcp\/?$/, '').replace(/\/$/, '');
+                await reconnectTo(`${correctBase}/mcp`);
+                return client.callTool(req.params);
+            }
+        }
+        return result;
+    });
+    await server.connect(new StdioServerTransport());
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@spotnik/superplanner-mcp",
+  "version": "0.1.1",
+  "description": "MCP server for SuperPlanner — works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "superplanner-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}