@daylight-labs/sharedb-mcp 0.1.4 → 0.1.5

package/dist/tools/auth.js

@@ -4,6 +4,22 @@ async function getPostgRESTUrl(databaseId) {
     const info = await api.databases.postgrest(databaseId);
     return info.postgrestUrl;
 }
+async function getEmailIntegrationInfo(appId) {
+    try {
+        const response = await fetch(`${config.adminApiUrl}/admin/apps/${appId}/integrations/email`, {
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${config.token}`,
+            },
+        });
+        if (!response.ok)
+            return null;
+        return response.json();
+    }
+    catch {
+        return null;
+    }
+}
 export const authTools = [
     {
         name: 'get_api_endpoints',
@@ -37,6 +53,8 @@ export async function handleAuthTool(name, args) {
                 let tableEndpoints = {};
                 let tableList = [];
                 let postgrestUrl = '<PostgREST URL - specify database_id to get actual URL>';
+                let appId;
+                let appName;
                 if (databaseId) {
                     try {
                         const [schema, url] = await Promise.all([
@@ -54,11 +72,69 @@ export async function handleAuthTool(name, args) {
                                 delete: `DELETE ${postgrestUrl}/${tableName}?id=eq.<uuid>`,
                             };
                         }
+                        const dbInfo = await api.databases.get(databaseId);
+                        if (dbInfo.database) {
+                            const dbName = dbInfo.database.name;
+                            const match = dbName.match(/^sharedb_(.+?)_(staging|production)$/);
+                            if (match) {
+                                appName = match[1];
+                                try {
+                                    const { app } = await api.apps.get(appName);
+                                    appId = app.id;
+                                }
+                                catch {
+                                    // App lookup failed, continue without email info
+                                }
+                            }
+                        }
                     }
                     catch {
                         // Database might not have tables yet
                     }
                 }
+                let emailSection;
+                if (appId && appName) {
+                    const emailInfo = await getEmailIntegrationInfo(appId);
+                    if (emailInfo) {
+                        const enabled = emailInfo.integration?.enabled ?? false;
+                        emailSection = {
+                            description: 'Send transactional emails via AWS SES',
+                            status: enabled ? 'enabled' : 'disabled',
+                            endpoint: `POST ${config.adminApiUrl}/admin/apps/${appId}/integrations/email/send`,
+                            authentication: 'Include admin API token: Authorization: Bearer <token>',
+                            fromAddress: emailInfo.fromAddress,
+                            rateLimit: `1 email per ${emailInfo.rateLimitSeconds} seconds per app`,
+                            requestBody: {
+                                to: 'string (required) - recipient email address',
+                                subject: 'string (required) - email subject line',
+                                body: 'string (required) - plain text email body',
+                                html: 'string (optional) - HTML email body',
+                            },
+                            example: `fetch('${config.adminApiUrl}/admin/apps/${appId}/integrations/email/send', {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'Authorization': 'Bearer <your-api-token>'
+  },
+  body: JSON.stringify({
+    to: 'user@example.com',
+    subject: 'Welcome to ${appName}!',
+    body: 'Thanks for signing up.',
+    html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>'
+  })
+})`,
+                            importantNotes: [
+                                enabled
+                                    ? 'Email integration is ENABLED for this app'
+                                    : 'Email integration is DISABLED - enable it in the Admin UI before sending',
+                                'Rate limited to 1 email per minute to prevent spam',
+                                'Returns HTTP 429 with retryAfter seconds if rate limit exceeded',
+                                'Returns HTTP 403 if email integration is not enabled',
+                                `Emails are sent from: ${emailInfo.fromAddress}`,
+                            ],
+                        };
+                    }
+                }
                 const endpoints = {
                     auth: {
                         baseUrl: config.authApiUrl,
@@ -121,6 +197,9 @@ export async function handleAuthTool(name, args) {
                         recommendation: 'Add to your global error handler (window.onerror, React error boundaries) during development to catch unhandled errors.',
                     },
                 };
+                if (emailSection) {
+                    endpoints.email = emailSection;
+                }
                 return {
                     content: [
                         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daylight-labs/sharedb-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "MCP server for ShareDB schema management and development",
   "type": "module",
   "main": "./dist/index.js",