@wireweave/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Wireweave
+
+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

@@ -0,0 +1,167 @@
+<p align="center">
+  <img src="logo.svg" width="128" height="128" alt="Wireweave MCP">
+</p>
+
+<h1 align="center">@wireweave/mcp-server</h1>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@wireweave/mcp-server"><img src="https://img.shields.io/npm/v/@wireweave/mcp-server.svg" alt="npm version"></a>
+  <a href="https://github.com/wireweave/wireframe-lang/blob/main/packages/mcp-server/LICENSE"><img src="https://img.shields.io/npm/l/@wireweave/mcp-server.svg" alt="license"></a>
+</p>
+
+<p align="center">Model Context Protocol server for Wireweave DSL - AI-powered wireframe generation</p>
+
+## Overview
+
+This MCP server enables AI assistants like Claude to generate wireframes using the Wireweave DSL. It provides **32 tools** for parsing, rendering, validating, and managing wireframes.
+
+## Prerequisites
+
+You need a Wireweave API key. Get one from the [Dashboard](https://dashboard.wireweave.org).
+
+## Installation
+
+```bash
+npm install -g @wireweave/mcp-server
+```
+
+Or use directly with npx:
+
+```bash
+npx @wireweave/mcp-server
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "wireweave": {
+      "command": "npx",
+      "args": ["@wireweave/mcp-server"],
+      "env": {
+        "WIREWEAVE_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `WIREWEAVE_API_KEY` | Yes | Your API key from Dashboard |
+| `WIREWEAVE_API_URL` | No | API server URL (default: https://api.wireweave.org) |
+
+## Available Tools (32)
+
+### Core Tools (14)
+
+| Tool | Description |
+|------|-------------|
+| `wireweave_parse` | Parse DSL source code into an AST |
+| `wireweave_validate` | Validate DSL syntax |
+| `wireweave_grammar` | Get DSL grammar documentation |
+| `wireweave_guide` | **Primary LLM resource** - comprehensive language guide |
+| `wireweave_patterns` | Get common layout patterns |
+| `wireweave_examples` | Get code examples by category |
+| `wireweave_render_html` | Render DSL to HTML and CSS |
+| `wireweave_render_svg` | Render DSL to SVG format |
+| `wireweave_validate_ux` | Validate UX best practices |
+| `wireweave_ux_rules` | Get UX rule categories |
+| `wireweave_diff` | Compare two wireframe sources |
+| `wireweave_export_json` | Export to JSON format |
+| `wireweave_export_figma` | Export to Figma format |
+| `wireweave_analyze` | Analyze wireframe statistics |
+
+### Cloud Storage Tools (14)
+
+| Tool | Description |
+|------|-------------|
+| `wireweave_cloud_list_projects` | List your projects |
+| `wireweave_cloud_create_project` | Create a new project |
+| `wireweave_cloud_update_project` | Update project details |
+| `wireweave_cloud_delete_project` | Delete a project |
+| `wireweave_cloud_list_wireframes` | List saved wireframes |
+| `wireweave_cloud_get_wireframe` | Get a specific wireframe |
+| `wireweave_cloud_save_wireframe` | Save a new wireframe |
+| `wireweave_cloud_update_wireframe` | Update an existing wireframe |
+| `wireweave_cloud_delete_wireframe` | Delete a wireframe |
+| `wireweave_cloud_get_versions` | Get version history |
+| `wireweave_cloud_restore_version` | Restore to a previous version |
+| `wireweave_cloud_create_share_link` | Create a shareable link |
+| `wireweave_cloud_list_shares` | List share links |
+| `wireweave_gallery` | Browse public wireframe gallery |
+
+### Account & Billing Tools (4)
+
+| Tool | Description |
+|------|-------------|
+| `wireweave_account_balance` | Check credit balance |
+| `wireweave_account_subscription` | Get subscription details |
+| `wireweave_account_transactions` | View transaction history |
+| `wireweave_pricing` | Get pricing information |
+
+## Usage Examples
+
+Once configured, you can ask Claude:
+
+**Generate a wireframe:**
+> "Create a wireframe for a login page with email and password fields"
+
+**Validate UX:**
+> "Check the UX best practices for this wireframe code"
+
+**Save to cloud:**
+> "Save this wireframe as 'Dashboard v2' in my project"
+
+**Export:**
+> "Export this wireframe to Figma format"
+
+## Architecture
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│   Claude/LLM    │────▶│   MCP Server    │────▶│   API Server    │
+│                 │     │  (this package) │     │                 │
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+                              │                       │
+                         Tool definitions        Execution
+                         Request forwarding      Auth & Rate Limit
+                                                 Credit management
+```
+
+The MCP server is a thin client that:
+- Defines and exposes 32 tools to AI assistants
+- Forwards tool calls to the Wireweave API Server
+- Returns results back to the AI
+
+All authentication, rate limiting, and business logic runs on the API Server.
+
+## Credit Costs
+
+| Feature | Credits |
+|---------|---------|
+| Parse, Validate, Grammar, Guide, Patterns | 1 |
+| Render HTML/SVG | 2 |
+| UX Validation | 3 |
+| Diff, Analyze | 2 |
+| Export JSON/Figma | 3 |
+| Cloud Save/Update | 1 |
+| Create Share Link | 5 |
+
+## Links
+
+- [Documentation](https://docs.wireweave.org)
+- [Dashboard](https://dashboard.wireweave.org)
+- [Playground](https://playground.wireweave.org)
+- [GitHub](https://github.com/wireweave/wireframe-lang)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,852 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/index.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+
+// src/tools.ts
+var tools = [
+  {
+    name: "wireweave_parse",
+    description: "Parse Wireweave DSL source code into an AST (Abstract Syntax Tree)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source: {
+          type: "string",
+          description: "The Wireweave DSL source code to parse"
+        }
+      },
+      required: ["source"]
+    }
+  },
+  {
+    name: "wireweave_validate",
+    description: "Validate Wireweave DSL syntax without generating output",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source: {
+          type: "string",
+          description: "The Wireweave DSL source code to validate"
+        }
+      },
+      required: ["source"]
+    }
+  },
+  {
+    name: "wireweave_grammar",
+    description: "Get the Wireweave DSL grammar documentation and syntax reference",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  {
+    name: "wireweave_guide",
+    description: "Get the comprehensive LLM guide for Wireweave DSL. This is the PRIMARY resource for learning the language - includes syntax, components, patterns, and best practices. Call this FIRST before generating wireframes.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  {
+    name: "wireweave_patterns",
+    description: "Get common layout patterns for wireframes including headers, sidebars, forms, cards, and more. Use these as building blocks.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  {
+    name: "wireweave_examples",
+    description: "Get Wireweave code examples. Use this to learn patterns and best practices for different UI types.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          enum: ["all", "form", "dashboard", "mobile", "social", "commerce", "media"],
+          description: 'Filter examples by category. Use "all" to get all examples.',
+          default: "all"
+        },
+        limit: {
+          type: "number",
+          description: "Maximum number of examples to return",
+          default: 5
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "wireweave_render_html",
+    description: "Render Wireweave DSL to HTML and CSS",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source: {
+          type: "string",
+          description: "The Wireweave DSL source code to render"
+        },
+        theme: {
+          type: "string",
+          enum: ["light", "dark"],
+          description: "Color theme for rendering",
+          default: "light"
+        },
+        fullDocument: {
+          type: "boolean",
+          description: "Return a complete HTML document instead of fragment",
+          default: false
+        }
+      },
+      required: ["source"]
+    }
+  },
+  {
+    name: "wireweave_render_svg",
+    description: "Render Wireweave DSL to SVG format",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source: {
+          type: "string",
+          description: "The Wireweave DSL source code to render"
+        },
+        width: {
+          type: "number",
+          description: "SVG width in pixels",
+          default: 1200
+        },
+        padding: {
+          type: "number",
+          description: "Padding around content",
+          default: 24
+        },
+        theme: {
+          type: "string",
+          enum: ["light", "dark"],
+          description: "Color theme for rendering",
+          default: "light"
+        }
+      },
+      required: ["source"]
+    }
+  },
+  {
+    name: "wireweave_validate_ux",
+    description: "Validate Wireweave DSL for UX best practices. Returns issues with severity levels and actionable recommendations.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source: {
+          type: "string",
+          description: "The Wireweave DSL source code to validate"
+        },
+        categories: {
+          type: "array",
+          items: {
+            type: "string",
+            enum: ["accessibility", "usability", "form", "touch-target", "consistency", "navigation"]
+          },
+          description: "UX rule categories to check. If not specified, all categories are checked."
+        },
+        minSeverity: {
+          type: "string",
+          enum: ["error", "warning", "info"],
+          description: "Minimum severity level to report",
+          default: "info"
+        },
+        maxIssues: {
+          type: "number",
+          description: "Maximum number of issues to return"
+        }
+      },
+      required: ["source"]
+    }
+  },
+  {
+    name: "wireweave_ux_rules",
+    description: "Get available UX rule categories and their descriptions",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  {
+    name: "wireweave_diff",
+    description: "Compare two Wireweave DSL sources and return the differences between them",
+    inputSchema: {
+      type: "object",
+      properties: {
+        oldSource: {
+          type: "string",
+          description: "The original Wireweave DSL source code"
+        },
+        newSource: {
+          type: "string",
+          description: "The modified Wireweave DSL source code"
+        },
+        ignoreAttributes: {
+          type: "boolean",
+          description: "Ignore attribute changes, only compare structure",
+          default: false
+        },
+        ignoreOrder: {
+          type: "boolean",
+          description: "Ignore the order of children when comparing",
+          default: false
+        }
+      },
+      required: ["oldSource", "newSource"]
+    }
+  },
+  {
+    name: "wireweave_export_json",
+    description: "Export Wireweave DSL to JSON format for integration with other tools",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source: {
+          type: "string",
+          description: "The Wireweave DSL source code to export"
+        },
+        includeLocations: {
+          type: "boolean",
+          description: "Include source location information in output",
+          default: false
+        },
+        prettyPrint: {
+          type: "boolean",
+          description: "Format JSON with indentation",
+          default: true
+        }
+      },
+      required: ["source"]
+    }
+  },
+  {
+    name: "wireweave_export_figma",
+    description: "Export Wireweave DSL to Figma-compatible format",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source: {
+          type: "string",
+          description: "The Wireweave DSL source code to export"
+        }
+      },
+      required: ["source"]
+    }
+  },
+  {
+    name: "wireweave_analyze",
+    description: "Analyze Wireweave DSL for statistics and metrics including component usage, tree structure, accessibility score, and complexity",
+    inputSchema: {
+      type: "object",
+      properties: {
+        source: {
+          type: "string",
+          description: "The Wireweave DSL source code to analyze"
+        },
+        includeComponentBreakdown: {
+          type: "boolean",
+          description: "Include detailed component usage breakdown",
+          default: true
+        },
+        includeAccessibility: {
+          type: "boolean",
+          description: "Include accessibility analysis",
+          default: true
+        },
+        includeComplexity: {
+          type: "boolean",
+          description: "Include complexity metrics",
+          default: true
+        },
+        includeLayout: {
+          type: "boolean",
+          description: "Include layout pattern analysis",
+          default: true
+        },
+        includeContent: {
+          type: "boolean",
+          description: "Include content analysis",
+          default: true
+        }
+      },
+      required: ["source"]
+    }
+  },
+  // ============================================
+  // Cloud Storage Tools
+  // ============================================
+  {
+    name: "wireweave_cloud_list_projects",
+    description: "List all your Wireweave projects. Projects help organize your wireframes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        includeArchived: {
+          type: "boolean",
+          description: "Include archived projects",
+          default: false
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "wireweave_cloud_create_project",
+    description: "Create a new project to organize wireframes",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Project name"
+        },
+        description: {
+          type: "string",
+          description: "Project description"
+        },
+        color: {
+          type: "string",
+          description: "Project color (hex code, e.g., #6366f1)"
+        }
+      },
+      required: ["name"]
+    }
+  },
+  {
+    name: "wireweave_cloud_update_project",
+    description: "Update an existing project",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Project ID to update"
+        },
+        name: {
+          type: "string",
+          description: "New project name"
+        },
+        description: {
+          type: "string",
+          description: "New project description"
+        },
+        color: {
+          type: "string",
+          description: "New project color (hex code)"
+        },
+        isArchived: {
+          type: "boolean",
+          description: "Archive or unarchive the project"
+        }
+      },
+      required: ["id"]
+    }
+  },
+  {
+    name: "wireweave_cloud_delete_project",
+    description: "Delete a project permanently. All wireframes in the project will be moved to the default project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Project ID to delete"
+        }
+      },
+      required: ["id"]
+    }
+  },
+  {
+    name: "wireweave_cloud_list_wireframes",
+    description: "List your saved wireframes. Optionally filter by project or tags.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: {
+          type: "string",
+          description: "Filter by project ID"
+        },
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Filter by tags"
+        },
+        limit: {
+          type: "number",
+          description: "Maximum number of wireframes to return",
+          default: 20
+        },
+        offset: {
+          type: "number",
+          description: "Offset for pagination",
+          default: 0
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "wireweave_cloud_get_wireframe",
+    description: "Get a specific wireframe by ID, including its code and metadata",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Wireframe ID"
+        }
+      },
+      required: ["id"]
+    }
+  },
+  {
+    name: "wireweave_cloud_save_wireframe",
+    description: "Save a new wireframe to the cloud. Costs 1 credit.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Wireframe name"
+        },
+        code: {
+          type: "string",
+          description: "Wireweave DSL code"
+        },
+        description: {
+          type: "string",
+          description: "Wireframe description"
+        },
+        projectId: {
+          type: "string",
+          description: "Project ID to save to (uses default project if not specified)"
+        },
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Tags for categorization"
+        },
+        isPublic: {
+          type: "boolean",
+          description: "Make wireframe publicly visible",
+          default: false
+        }
+      },
+      required: ["name", "code"]
+    }
+  },
+  {
+    name: "wireweave_cloud_update_wireframe",
+    description: "Update an existing wireframe. Creates a new version automatically. Costs 1 credit.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Wireframe ID to update"
+        },
+        name: {
+          type: "string",
+          description: "New name (optional)"
+        },
+        code: {
+          type: "string",
+          description: "New Wireweave DSL code (optional)"
+        },
+        description: {
+          type: "string",
+          description: "New description (optional)"
+        },
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "New tags (optional)"
+        },
+        isPublic: {
+          type: "boolean",
+          description: "Update public visibility (optional)"
+        }
+      },
+      required: ["id"]
+    }
+  },
+  {
+    name: "wireweave_cloud_delete_wireframe",
+    description: "Delete a wireframe permanently",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Wireframe ID to delete"
+        }
+      },
+      required: ["id"]
+    }
+  },
+  {
+    name: "wireweave_cloud_get_versions",
+    description: "Get version history of a wireframe",
+    inputSchema: {
+      type: "object",
+      properties: {
+        wireframeId: {
+          type: "string",
+          description: "Wireframe ID"
+        }
+      },
+      required: ["wireframeId"]
+    }
+  },
+  {
+    name: "wireweave_cloud_restore_version",
+    description: "Restore a wireframe to a previous version. Costs 1 credit.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        wireframeId: {
+          type: "string",
+          description: "Wireframe ID"
+        },
+        version: {
+          type: "number",
+          description: "Version number to restore"
+        }
+      },
+      required: ["wireframeId", "version"]
+    }
+  },
+  {
+    name: "wireweave_cloud_create_share_link",
+    description: "Create a shareable link for a wireframe. Costs 5 credits.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        wireframeId: {
+          type: "string",
+          description: "Wireframe ID to share"
+        },
+        title: {
+          type: "string",
+          description: "Custom title for the shared view"
+        },
+        allowCopy: {
+          type: "boolean",
+          description: "Allow viewers to copy the code",
+          default: false
+        },
+        password: {
+          type: "string",
+          description: "Password protection (optional)"
+        },
+        expiresInDays: {
+          type: "number",
+          description: "Link expiration in days (optional, null = never)"
+        }
+      },
+      required: ["wireframeId"]
+    }
+  },
+  {
+    name: "wireweave_cloud_list_shares",
+    description: "List share links for a wireframe",
+    inputSchema: {
+      type: "object",
+      properties: {
+        wireframeId: {
+          type: "string",
+          description: "Wireframe ID"
+        }
+      },
+      required: ["wireframeId"]
+    }
+  },
+  // ============================================
+  // Account & Billing Tools
+  // ============================================
+  {
+    name: "wireweave_account_balance",
+    description: "Check your current credit balance and subscription status",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  {
+    name: "wireweave_account_subscription",
+    description: "Get detailed subscription information including plan features",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  {
+    name: "wireweave_account_transactions",
+    description: "View your credit transaction history",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: {
+          type: "number",
+          description: "Number of transactions to return",
+          default: 20
+        },
+        type: {
+          type: "string",
+          enum: ["purchase", "subscription", "usage", "refund", "bonus", "admin"],
+          description: "Filter by transaction type"
+        }
+      },
+      required: []
+    }
+  },
+  {
+    name: "wireweave_pricing",
+    description: "Get current pricing information for plans, credit packs, and feature costs",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
+  // ============================================
+  // Public Gallery
+  // ============================================
+  {
+    name: "wireweave_gallery",
+    description: "Browse public wireframe gallery for inspiration",
+    inputSchema: {
+      type: "object",
+      properties: {
+        tags: {
+          type: "array",
+          items: { type: "string" },
+          description: "Filter by tags"
+        },
+        limit: {
+          type: "number",
+          description: "Number of wireframes to return",
+          default: 20
+        }
+      },
+      required: []
+    }
+  }
+];
+var toolEndpoints = {
+  // Core tools
+  wireweave_parse: { method: "POST", path: "/tools/parse" },
+  wireweave_validate: { method: "POST", path: "/tools/validate" },
+  wireweave_grammar: { method: "GET", path: "/tools/grammar" },
+  wireweave_guide: { method: "GET", path: "/tools/guide" },
+  wireweave_patterns: { method: "GET", path: "/tools/patterns" },
+  wireweave_examples: { method: "GET", path: "/tools/examples" },
+  wireweave_render_html: { method: "POST", path: "/tools/render/html" },
+  wireweave_render_svg: { method: "POST", path: "/tools/render/svg" },
+  wireweave_validate_ux: { method: "POST", path: "/tools/validate/ux" },
+  wireweave_ux_rules: { method: "GET", path: "/tools/ux-rules" },
+  wireweave_diff: { method: "POST", path: "/tools/diff" },
+  wireweave_export_json: { method: "POST", path: "/tools/export/json" },
+  wireweave_export_figma: { method: "POST", path: "/tools/export/figma" },
+  wireweave_analyze: { method: "POST", path: "/tools/analyze" },
+  // Cloud storage tools
+  wireweave_cloud_list_projects: { method: "GET", path: "/cloud/projects" },
+  wireweave_cloud_create_project: { method: "POST", path: "/cloud/projects" },
+  wireweave_cloud_update_project: { method: "PATCH", path: "/cloud/projects/:id", pathParams: ["id"] },
+  wireweave_cloud_delete_project: { method: "DELETE", path: "/cloud/projects/:id", pathParams: ["id"] },
+  wireweave_cloud_list_wireframes: { method: "GET", path: "/cloud/wireframes" },
+  wireweave_cloud_get_wireframe: { method: "GET", path: "/cloud/wireframes/:id", pathParams: ["id"] },
+  wireweave_cloud_save_wireframe: { method: "POST", path: "/cloud/wireframes" },
+  wireweave_cloud_update_wireframe: { method: "PATCH", path: "/cloud/wireframes/:id", pathParams: ["id"] },
+  wireweave_cloud_delete_wireframe: { method: "DELETE", path: "/cloud/wireframes/:id", pathParams: ["id"] },
+  wireweave_cloud_get_versions: { method: "GET", path: "/cloud/wireframes/:wireframeId/versions", pathParams: ["wireframeId"] },
+  wireweave_cloud_restore_version: { method: "POST", path: "/cloud/wireframes/:wireframeId/versions/:version/restore", pathParams: ["wireframeId", "version"] },
+  wireweave_cloud_create_share_link: { method: "POST", path: "/cloud/wireframes/:wireframeId/shares", pathParams: ["wireframeId"] },
+  wireweave_cloud_list_shares: { method: "GET", path: "/cloud/wireframes/:wireframeId/shares", pathParams: ["wireframeId"] },
+  // Account & billing tools
+  wireweave_account_balance: { method: "GET", path: "/billing/balance" },
+  wireweave_account_subscription: { method: "GET", path: "/billing/subscription" },
+  wireweave_account_transactions: { method: "GET", path: "/billing/transactions" },
+  wireweave_pricing: { method: "GET", path: "/billing/pricing" },
+  // Public gallery
+  wireweave_gallery: { method: "GET", path: "/cloud/gallery" }
+};
+
+// src/api.ts
+function buildRequest(config, endpoint, args) {
+  let path = endpoint.path;
+  const body = { ...args };
+  if (endpoint.pathParams && args) {
+    for (const param of endpoint.pathParams) {
+      const value = args[param];
+      if (value !== void 0) {
+        path = path.replace(`:${param}`, String(value));
+        delete body[param];
+      }
+    }
+  }
+  let url = `${config.apiUrl}${path}`;
+  const options = {
+    method: endpoint.method,
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": config.apiKey
+    }
+  };
+  if (["POST", "PATCH", "PUT"].includes(endpoint.method) && Object.keys(body).length > 0) {
+    options.body = JSON.stringify(body);
+  } else if (endpoint.method === "GET" && Object.keys(body).length > 0) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(body)) {
+      if (value !== void 0 && value !== null) {
+        if (Array.isArray(value)) {
+          params.append(key, value.join(","));
+        } else {
+          params.append(key, String(value));
+        }
+      }
+    }
+    url = `${url}?${params.toString()}`;
+  }
+  return { url, options, bodyForGet: body };
+}
+function parseErrorMessage(status, error) {
+  if (status === 401) return "Invalid API key. Get one at https://dashboard.wireweave.org";
+  if (status === 402) return `Insufficient credits. ${error.message || "Please add more credits."}`;
+  if (status === 403) return "Access denied. Upgrade your plan for this feature.";
+  if (status === 429) return "Rate limit exceeded. Please wait and try again.";
+  if (status >= 500) return "Service temporarily unavailable";
+  return error.error || error.message || "Request failed";
+}
+function extractCreditInfo(headers) {
+  return {
+    balance: headers.get("X-Credits-Balance") ? parseInt(headers.get("X-Credits-Balance"), 10) : void 0,
+    monthlyRemaining: headers.get("X-Credits-Monthly-Remaining") ? parseInt(headers.get("X-Credits-Monthly-Remaining"), 10) : void 0,
+    totalAvailable: headers.get("X-Credits-Total-Available") ? parseInt(headers.get("X-Credits-Total-Available"), 10) : void 0
+  };
+}
+async function callApi(config, endpoint, args, fetchFn = fetch) {
+  if (!config.apiKey) {
+    throw new Error("WIREWEAVE_API_KEY environment variable is required");
+  }
+  const { url, options } = buildRequest(config, endpoint, args);
+  const response = await fetchFn(url, options);
+  const creditInfo = extractCreditInfo(response.headers);
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ error: "Request failed" }));
+    const userMessage = parseErrorMessage(response.status, error);
+    throw new Error(userMessage);
+  }
+  const result = await response.json();
+  if (creditInfo.balance !== void 0 || creditInfo.totalAvailable !== void 0) {
+    return {
+      ...result,
+      _credits: creditInfo
+    };
+  }
+  return result;
+}
+
+// src/index.ts
+var API_URL = process.env.WIREWEAVE_API_URL || "https://api.wireweave.org";
+var API_KEY = process.env.WIREWEAVE_API_KEY || "";
+var apiConfig = {
+  apiUrl: API_URL,
+  apiKey: API_KEY
+};
+function log(message, level = "info") {
+  const prefix = level === "error" ? "\u274C" : level === "warn" ? "\u26A0\uFE0F" : "\u2713";
+  console.error(`[Wireweave] ${prefix} ${message}`);
+}
+var server = new Server(
+  {
+    name: "wireweave-mcp",
+    version: "1.0.0"
+  },
+  {
+    capabilities: {
+      tools: {}
+    }
+  }
+);
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return { tools };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const endpoint = toolEndpoints[name];
+  if (!endpoint) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            error: `Unknown tool: ${name}`,
+            availableTools: Object.keys(toolEndpoints)
+          }, null, 2)
+        }
+      ],
+      isError: true
+    };
+  }
+  try {
+    const result = await callApi(apiConfig, endpoint, args);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }
+      ]
+    };
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            error: error instanceof Error ? error.message : "Unknown error"
+          }, null, 2)
+        }
+      ],
+      isError: true
+    };
+  }
+});
+server.onerror = (error) => {
+  log("An error occurred", "error");
+};
+process.on("SIGINT", async () => {
+  await server.close();
+  process.exit(0);
+});
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  log("MCP server started");
+  if (!API_KEY) {
+    log("API key not configured. Get one at https://dashboard.wireweave.org", "warn");
+  }
+}
+main().catch(() => {
+  log("Failed to start server", "error");
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@wireweave/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Wireweave DSL - Thin client for API Server",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "wireweave-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wireweave/wireframe-lang.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://docs.wireweave.org",
+  "bugs": {
+    "url": "https://github.com/wireweave/wireframe-lang/issues"
+  },
+  "keywords": [
+    "wireweave",
+    "mcp",
+    "model-context-protocol",
+    "wireframe",
+    "dsl",
+    "ai",
+    "claude",
+    "llm",
+    "tools",
+    "ui-design",
+    "prototyping"
+  ],
+  "license": "MIT"
+}