yupno-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,61 @@
+# Yupno MCP Server
+
+MCP server for creating and managing events on [Yupno](https://yupno.io).
+
+## Installation
+
+```bash
+npx yupno-mcp-server
+```
+
+## Configuration
+
+Add to your Claude settings:
+
+```json
+{
+  "mcpServers": {
+    "yupno": {
+      "command": "npx",
+      "args": ["-y", "yupno-mcp-server"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### create_event
+
+Create a new event with optional theming.
+
+**Example prompt:** "Create an 80s party event for tomorrow at 7pm with a neon theme"
+
+### get_event
+
+Get details of an existing event.
+
+### update_event
+
+Update an event (requires admin token).
+
+### delete_event
+
+Delete an event (requires admin token).
+
+## Theme Options
+
+When creating events, you can specify visual themes:
+
+- `primaryColor` - Hex color for buttons/accents
+- `accentColor` - Secondary color
+- `backgroundColor` - Page background
+- `textColor` - Text color (for dark backgrounds)
+- `fontFamily` - Google Font name
+- `backgroundUrl` - HTTPS image URL
+- `backgroundOverlay` - Overlay opacity (0-1)
+
+### Suggested Fonts
+
+Press Start 2P, Monoton, Righteous, Bangers, Lobster, Pacifico,
+Playfair Display, Oswald, Bebas Neue, Space Grotesk

package/index.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const YUPNO_API = process.env.YUPNO_API_URL || "https://yupno.io";
+
+// Create server
+const server = new McpServer({
+  name: "yupno",
+  version: "1.0.0",
+});
+
+// Create event tool
+server.tool(
+  "create_event",
+  `Create a new event on Yupno. Returns admin URL (for managing) and guest URL (for sharing).
+
+DESIGN RULES (follow these for professional results):
+- Title: Keep SHORT (2-4 words). NO emojis in title. Examples: "Game Night", "Sarah's Birthday"
+- Fonts: Use Poppins, Inter, Playfair Display, or Montserrat. AVOID Lobster/Pacifico (wrap badly)
+- Colors: Dark bg (#1a1a2e) needs light text (#ffffff). Light bg (#faf7f2) needs dark text (#2d3436)
+- Description: Brief (2-3 sentences), emojis OK but sparingly`,
+  {
+    title: z.string().describe("Event title - keep SHORT (2-4 words), NO emojis. Good: 'Game Night', 'Emma's 30th'"),
+    eventDate: z.string().describe("Start date/time in ISO 8601 format"),
+    endDate: z.string().optional().describe("End date/time in ISO 8601 format"),
+    timezone: z.string().optional().describe("IANA timezone (e.g., America/New_York)"),
+    location: z.string().optional().describe("Physical address or venue name"),
+    description: z.string().optional().describe("Brief description (2-3 sentences). Emojis OK sparingly. Don't repeat date/location."),
+    theme: z.object({
+      primaryColor: z.string().optional().describe("Hex color for buttons. Should contrast with backgroundColor"),
+      accentColor: z.string().optional().describe("Hex color for secondary elements"),
+      backgroundColor: z.string().optional().describe("Hex color for page background. Dark (#1a1a2e) or light (#faf7f2)"),
+      textColor: z.string().optional().describe("Hex color for text. Use #ffffff on dark bg, #1a1a1a on light bg"),
+      fontFamily: z.string().optional().describe("Google Font. Recommended: Poppins, Inter, Playfair Display, Montserrat. AVOID: Lobster, Pacifico"),
+      backgroundUrl: z.string().optional().describe("HTTPS URL for background image (use Unsplash)"),
+      backgroundOverlay: z.number().min(0).max(1).optional().describe("Dark overlay 0.5-0.7 for readability with background images"),
+    }).optional().describe("Visual theme - see design rules above"),
+  },
+  async (args) => {
+    try {
+      const res = await fetch(`${YUPNO_API}/api/v1/events`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(args),
+      });
+      const data = await res.json();
+
+      if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${data.error || JSON.stringify(data)}` }] };
+      }
+
+      return {
+        content: [{
+          type: "text",
+          text: `Event created successfully!
+
+Admin URL (save this - for managing RSVPs): ${data.links.admin}
+Guest URL (share this): ${data.links.guest}
+
+Admin Token: ${data.adminToken}
+Event Token: ${data.eventToken}`,
+        }],
+      };
+    } catch (error) {
+      return { content: [{ type: "text", text: `Error: ${error.message}` }] };
+    }
+  }
+);
+
+// Get event tool
+server.tool(
+  "get_event",
+  "Get public details of an event by its event token.",
+  {
+    eventToken: z.string().describe("The event token from the guest URL"),
+  },
+  async ({ eventToken }) => {
+    try {
+      const res = await fetch(`${YUPNO_API}/api/v1/events/${eventToken}`);
+      const data = await res.json();
+
+      if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${data.error || 'Event not found'}` }] };
+      }
+
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    } catch (error) {
+      return { content: [{ type: "text", text: `Error: ${error.message}` }] };
+    }
+  }
+);
+
+// Update event tool
+server.tool(
+  "update_event",
+  "Update an existing event. Requires the admin token.",
+  {
+    adminToken: z.string().describe("The admin token for the event"),
+    title: z.string().optional(),
+    eventDate: z.string().optional(),
+    endDate: z.string().optional(),
+    timezone: z.string().optional(),
+    location: z.string().optional(),
+    description: z.string().optional(),
+    theme: z.object({
+      primaryColor: z.string().optional(),
+      accentColor: z.string().optional(),
+      backgroundColor: z.string().optional(),
+      textColor: z.string().optional(),
+      fontFamily: z.string().optional(),
+      backgroundUrl: z.string().optional(),
+      backgroundOverlay: z.number().optional(),
+    }).optional(),
+  },
+  async ({ adminToken, ...updateData }) => {
+    try {
+      const res = await fetch(`${YUPNO_API}/api/v1/events/${adminToken}`, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(updateData),
+      });
+      const data = await res.json();
+
+      if (!res.ok) {
+        return { content: [{ type: "text", text: `Error: ${data.error || JSON.stringify(data)}` }] };
+      }
+
+      return { content: [{ type: "text", text: "Event updated successfully!" }] };
+    } catch (error) {
+      return { content: [{ type: "text", text: `Error: ${error.message}` }] };
+    }
+  }
+);
+
+// Delete event tool
+server.tool(
+  "delete_event",
+  "Delete an event. Requires the admin token. This action cannot be undone.",
+  {
+    adminToken: z.string().describe("The admin token for the event"),
+  },
+  async ({ adminToken }) => {
+    try {
+      const res = await fetch(`${YUPNO_API}/api/v1/events/${adminToken}`, {
+        method: "DELETE",
+      });
+
+      if (!res.ok) {
+        const data = await res.json();
+        return { content: [{ type: "text", text: `Error: ${data.error || 'Failed to delete'}` }] };
+      }
+
+      return { content: [{ type: "text", text: "Event deleted successfully." }] };
+    } catch (error) {
+      return { content: [{ type: "text", text: `Error: ${error.message}` }] };
+    }
+  }
+);
+
+// Start server with stdio transport
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("Yupno MCP server running");

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "yupno-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for creating and managing Yupno events with Claude Desktop",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "yupno-mcp-server": "./index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": ["mcp", "yupno", "events", "rsvp", "claude", "anthropic", "model-context-protocol"],
+  "author": "Yupno",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yupno/yupno"
+  },
+  "homepage": "https://yupno.io/docs.html",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  }
+}