@revealui/mcp 0.1.0 → 0.1.1

package/dist/servers/revealui-email.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+/**
+ * RevealUI Email MCP Server
+ *
+ * Model Context Protocol server that exposes email sending tools via Resend,
+ * RevealUI's transactional email provider. Lets AI agents send notification
+ * emails, digests, alerts, and templated messages on behalf of a RevealUI site.
+ *
+ * Environment:
+ *   RESEND_API_KEY       — Resend API key (re_...)
+ *   REVEALUI_FROM_EMAIL  — Default sender address (default: notifications@revealui.com)
+ *
+ * Tools:
+ *   email_send          — Send a single email (HTML or plain text)
+ *   email_send_batch    — Send up to 100 emails in one API call
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { logger } from '@revealui/core/observability/logger';
+import { checkMcpLicense } from '../index.js';
+// ---------------------------------------------------------------------------
+// Resend REST helpers
+// ---------------------------------------------------------------------------
+const RESEND_BASE = 'https://api.resend.com';
+const DEFAULT_FROM = 'RevealUI <notifications@revealui.com>';
+async function resendPost(apiKey, path, body) {
+    const res = await fetch(`${RESEND_BASE}${path}`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            'User-Agent': 'RevealUI-MCP/1.0',
+        },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        throw new Error(data.message ??
+            data.name ??
+            `Resend ${res.status}`);
+    }
+    return data;
+}
+// ---------------------------------------------------------------------------
+// Server
+// ---------------------------------------------------------------------------
+const server = new Server({ name: 'revealui-email', version: '1.0.0' }, { capabilities: { tools: {} } });
+const TOOLS = [
+    {
+        name: 'email_send',
+        description: 'Send a single transactional email via RevealUI\'s Resend account. ' +
+            'Provide either html or text (or both). Returns the Resend message ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                to: {
+                    oneOf: [
+                        { type: 'string', description: 'Single recipient email' },
+                        { type: 'array', items: { type: 'string' }, description: 'Multiple recipients' },
+                    ],
+                    description: 'Recipient email address(es)',
+                },
+                subject: { type: 'string', description: 'Email subject line' },
+                html: { type: 'string', description: 'HTML body of the email' },
+                text: { type: 'string', description: 'Plain-text fallback body' },
+                from: {
+                    type: 'string',
+                    description: `Sender address (default: ${DEFAULT_FROM})`,
+                },
+                reply_to: { type: 'string', description: 'Reply-to address' },
+            },
+            required: ['to', 'subject'],
+        },
+    },
+    {
+        name: 'email_send_batch',
+        description: 'Send up to 100 emails in a single Resend batch request. ' +
+            'Each email in the batch can have its own to/subject/html/text.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                emails: {
+                    type: 'array',
+                    description: 'Array of email objects to send',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            to: { type: 'string', description: 'Recipient email' },
+                            subject: { type: 'string', description: 'Subject line' },
+                            html: { type: 'string', description: 'HTML body' },
+                            text: { type: 'string', description: 'Plain text body' },
+                            from: { type: 'string', description: 'Sender address (defaults to REVEALUI_FROM_EMAIL)' },
+                        },
+                        required: ['to', 'subject'],
+                    },
+                    maxItems: 100,
+                },
+            },
+            required: ['emails'],
+        },
+    },
+];
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const apiKey = process.env.RESEND_API_KEY;
+    if (!apiKey) {
+        return {
+            content: [{ type: 'text', text: 'Error: RESEND_API_KEY is not set' }],
+            isError: true,
+        };
+    }
+    const fromAddress = process.env.REVEALUI_FROM_EMAIL ?? DEFAULT_FROM;
+    try {
+        switch (request.params.name) {
+            case 'email_send': {
+                const { to, subject, html, text, from = fromAddress, reply_to } = request.params.arguments;
+                if (!(html ?? text)) {
+                    return {
+                        content: [{ type: 'text', text: 'Error: Provide at least one of html or text' }],
+                        isError: true,
+                    };
+                }
+                const payload = { from, to, subject };
+                if (html)
+                    payload.html = html;
+                if (text)
+                    payload.text = text;
+                if (reply_to)
+                    payload.reply_to = reply_to;
+                // Tag all RevealUI MCP emails for filtering in Resend dashboard
+                payload.tags = [{ name: 'source', value: 'revealui-mcp' }];
+                const result = await resendPost(apiKey, '/emails', payload);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'email_send_batch': {
+                const { emails } = request.params.arguments;
+                if (emails.length > 100) {
+                    return {
+                        content: [{ type: 'text', text: 'Error: Batch size cannot exceed 100 emails' }],
+                        isError: true,
+                    };
+                }
+                const batch = emails.map((e) => {
+                    const payload = {
+                        from: e.from ?? fromAddress,
+                        to: e.to,
+                        subject: e.subject,
+                        tags: [{ name: 'source', value: 'revealui-mcp' }],
+                    };
+                    if (e.html)
+                        payload.html = e.html;
+                    if (e.text)
+                        payload.text = e.text;
+                    return payload;
+                });
+                const result = await resendPost(apiKey, '/emails/batch', batch);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            default:
+                return {
+                    content: [{ type: 'text', text: `Error: Unknown tool: ${request.params.name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    if (!(await checkMcpLicense())) {
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    logger.error('RevealUI Email MCP error', err instanceof Error ? err : new Error(String(err)));
+    process.exit(1);
+});
+//# sourceMappingURL=revealui-email.js.map

package/dist/servers/revealui-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revealui-email.js","sourceRoot":"","sources":["../../src/servers/revealui-email.ts"],"names":[],"mappings":"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"}

package/dist/servers/revealui-stripe.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * RevealUI Stripe MCP Server
+ *
+ * Model Context Protocol server that exposes Stripe payment management tools
+ * scoped to RevealUI's subscription model. Gives AI agents structured access
+ * to customer, subscription, and payment intent data in RevealUI's Stripe account.
+ *
+ * Environment:
+ *   STRIPE_SECRET_KEY — Stripe secret key (sk_live_... or sk_test_...)
+ *
+ * Tools:
+ *   stripe_create_payment_intent  — Create a one-time payment intent
+ *   stripe_list_customers         — List customers, with optional email filter
+ *   stripe_get_customer           — Fetch a customer and their active subscription
+ *   stripe_list_subscriptions     — List subscriptions (all or by customer/status)
+ */
+export {};
+//# sourceMappingURL=revealui-stripe.d.ts.map

package/dist/servers/revealui-stripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revealui-stripe.d.ts","sourceRoot":"","sources":["../../src/servers/revealui-stripe.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;GAeG"}

package/dist/servers/revealui-stripe.js

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+/**
+ * RevealUI Stripe MCP Server
+ *
+ * Model Context Protocol server that exposes Stripe payment management tools
+ * scoped to RevealUI's subscription model. Gives AI agents structured access
+ * to customer, subscription, and payment intent data in RevealUI's Stripe account.
+ *
+ * Environment:
+ *   STRIPE_SECRET_KEY — Stripe secret key (sk_live_... or sk_test_...)
+ *
+ * Tools:
+ *   stripe_create_payment_intent  — Create a one-time payment intent
+ *   stripe_list_customers         — List customers, with optional email filter
+ *   stripe_get_customer           — Fetch a customer and their active subscription
+ *   stripe_list_subscriptions     — List subscriptions (all or by customer/status)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { logger } from '@revealui/core/observability/logger';
+import { checkMcpLicense } from '../index.js';
+// ---------------------------------------------------------------------------
+// Stripe REST helpers
+// ---------------------------------------------------------------------------
+const STRIPE_BASE = 'https://api.stripe.com/v1';
+function stripeHeaders(secretKey) {
+    return {
+        Authorization: `Bearer ${secretKey}`,
+        'Content-Type': 'application/x-www-form-urlencoded',
+        'Stripe-Version': '2025-03-31.basil',
+        'User-Agent': 'RevealUI-MCP/1.0',
+    };
+}
+async function stripeGet(path, secretKey, params) {
+    const url = new URL(`${STRIPE_BASE}${path}`);
+    if (params) {
+        for (const [k, v] of Object.entries(params))
+            url.searchParams.set(k, v);
+    }
+    const res = await fetch(url.toString(), { headers: stripeHeaders(secretKey) });
+    const body = await res.json();
+    if (!res.ok)
+        throw new Error(body.error?.message ?? `Stripe ${res.status}`);
+    return body;
+}
+async function stripePost(path, secretKey, data) {
+    const res = await fetch(`${STRIPE_BASE}${path}`, {
+        method: 'POST',
+        headers: stripeHeaders(secretKey),
+        body: new URLSearchParams(data).toString(),
+    });
+    const body = await res.json();
+    if (!res.ok)
+        throw new Error(body.error?.message ?? `Stripe ${res.status}`);
+    return body;
+}
+// ---------------------------------------------------------------------------
+// Server
+// ---------------------------------------------------------------------------
+const server = new Server({ name: 'revealui-stripe', version: '1.0.0' }, { capabilities: { tools: {} } });
+const TOOLS = [
+    {
+        name: 'stripe_create_payment_intent',
+        description: 'Create a Stripe PaymentIntent for a one-time charge in RevealUI. ' +
+            'Amount is in the smallest currency unit (cents for USD).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                amount: { type: 'number', description: 'Amount in smallest currency unit (e.g. 2999 = $29.99)' },
+                currency: { type: 'string', description: 'ISO 4217 currency code (default: usd)', default: 'usd' },
+                customer_id: { type: 'string', description: 'Stripe customer ID to attach the payment to' },
+                description: { type: 'string', description: 'Human-readable description of the charge' },
+            },
+            required: ['amount'],
+        },
+    },
+    {
+        name: 'stripe_list_customers',
+        description: 'List Stripe customers in the RevealUI account. Optionally filter by email.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                email: { type: 'string', description: 'Filter by exact email address' },
+                limit: { type: 'number', description: 'Number of results (1-100, default: 20)', default: 20 },
+            },
+        },
+    },
+    {
+        name: 'stripe_get_customer',
+        description: 'Fetch a Stripe customer by ID, including their active RevealUI subscription tier.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                customer_id: { type: 'string', description: 'Stripe customer ID (cus_...)' },
+            },
+            required: ['customer_id'],
+        },
+    },
+    {
+        name: 'stripe_list_subscriptions',
+        description: 'List Stripe subscriptions for RevealUI. Can filter by customer and/or status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                customer_id: { type: 'string', description: 'Filter to a specific customer (cus_...)' },
+                status: {
+                    type: 'string',
+                    description: 'Filter by status: active, canceled, past_due, trialing, all (default: active)',
+                    default: 'active',
+                },
+                limit: { type: 'number', description: 'Number of results (1-100, default: 20)', default: 20 },
+            },
+        },
+    },
+];
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const secretKey = process.env.STRIPE_SECRET_KEY;
+    if (!secretKey) {
+        return {
+            content: [{ type: 'text', text: 'Error: STRIPE_SECRET_KEY is not set' }],
+            isError: true,
+        };
+    }
+    try {
+        switch (request.params.name) {
+            case 'stripe_create_payment_intent': {
+                const { amount, currency = 'usd', customer_id, description } = request.params.arguments;
+                const data = {
+                    amount: String(Math.round(amount)),
+                    currency,
+                };
+                if (customer_id)
+                    data.customer = customer_id;
+                if (description)
+                    data.description = description;
+                const intent = await stripePost('/payment_intents', secretKey, data);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(intent, null, 2) }],
+                };
+            }
+            case 'stripe_list_customers': {
+                const { email, limit = 20 } = request.params.arguments;
+                const params = { limit: String(Math.min(limit, 100)) };
+                if (email)
+                    params.email = email;
+                const result = await stripeGet('/customers', secretKey, params);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'stripe_get_customer': {
+                const { customer_id } = request.params.arguments;
+                const [customer, subscriptions] = await Promise.all([
+                    stripeGet(`/customers/${customer_id}`, secretKey),
+                    stripeGet('/subscriptions', secretKey, {
+                        customer: customer_id,
+                        status: 'active',
+                        limit: '5',
+                        'expand[]': 'data.items.data.price.product',
+                    }),
+                ]);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ customer, subscriptions }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'stripe_list_subscriptions': {
+                const { customer_id, status = 'active', limit = 20 } = request.params.arguments;
+                const params = {
+                    limit: String(Math.min(limit, 100)),
+                    status,
+                };
+                if (customer_id)
+                    params.customer = customer_id;
+                const result = await stripeGet('/subscriptions', secretKey, params);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            default:
+                return {
+                    content: [{ type: 'text', text: `Error: Unknown tool: ${request.params.name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    if (!(await checkMcpLicense())) {
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    logger.error('RevealUI Stripe MCP error', err instanceof Error ? err : new Error(String(err)));
+    process.exit(1);
+});
+//# sourceMappingURL=revealui-stripe.js.map

package/dist/servers/revealui-stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revealui-stripe.js","sourceRoot":"","sources":["../../src/servers/revealui-stripe.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,14 +1,46 @@
 {
   "name": "@revealui/mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
+  "description": "[Pro] Model Context Protocol integrations for RevealUI — adapter framework, hypervisor, and MCP contracts",
   "license": "SEE LICENSE IN ../../LICENSE.commercial",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapter": {
+      "types": "./dist/servers/adapter.d.ts",
+      "import": "./dist/servers/adapter.js"
+    },
+    "./contracts": {
+      "types": "./dist/contracts.d.ts",
+      "import": "./dist/contracts.js"
+    },
+    "./hypervisor": {
+      "types": "./dist/hypervisor.d.ts",
+      "import": "./dist/hypervisor.js"
+    },
+    "./db": {
+      "types": "./dist/adapters/db.d.ts",
+      "import": "./dist/adapters/db.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "dotenv": "^17.2.4",
-    "@revealui/config": "0.2.0",
-    "@revealui/contracts": "1.0.0",
-    "@revealui/scripts": "0.1.0",
-    "@revealui/core": "0.2.0"
+    "@revealui/config": "0.3.0",
+    "@revealui/contracts": "1.2.0",
+    "@revealui/core": "0.3.0"
   },
   "devDependencies": {
     "@electric-sql/pglite": "^0.3.15",
@@ -16,17 +48,24 @@
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },
-  "type": "module",
   "publishConfig": {
-    "registry": "https://registry.npmjs.org",
     "access": "public"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RevealUIStudio/revealui.git",
+    "directory": "packages/mcp"
+  },
+  "funding": {
+    "type": "commercial",
+    "url": "https://revealui.com/pro"
+  },
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
     "dev": "tsc --watch",
     "lint": "biome check .",
-    "test": "vitest run",
+    "test": "vitest run --passWithNoTests",
     "typecheck": "tsc --noEmit"
   }
 }

package/.env.example

@@ -1,9 +0,0 @@
-MCP_PERSISTENCE_DRIVER=pglite
-ELECTRIC_DATABASE_URL=postgres://dev:dev@localhost:5432/revealui_mcp
-ELECTRIC_API_KEY=replace-me
-MCP_METRICS_MODE=logs
-PGVECTOR_ENABLED=false
-
-# Notes:
-# - Do NOT commit real credentials. Store real secrets in CI/Vault.
-# - Set `PGVECTOR_ENABLED=true` when using local Postgres with pgvector for vector testing.