sopo-mcp 1.0.0

package/dist/tools/service-target.tools.js

@@ -0,0 +1,52 @@
+/**
+ * Sopo MCP Server — Service Target Tools
+ *
+ * CRUD tools for managing Service Targets (upstream URLs / load balancing endpoints).
+ */
+import { z } from 'zod';
+import { sopoGet, sopoPost, sopoPatch, sopoDelete } from '../sopo-client.js';
+export function registerServiceTargetTools(server) {
+    // ── List Service Targets ──────────────────────────────────────
+    server.tool('list_service_targets', 'List all service targets (upstream URLs). Returns id, service_id, url, and weight for each target.', {}, async () => {
+        const result = await sopoGet('/api/v1/service-targets');
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
+    });
+    // ── Create Service Target ─────────────────────────────────────
+    server.tool('create_service_target', 'Add a new upstream URL target to a service. Requires url and service_id. The service_id MUST reference an existing service.', {
+        url: z.string().describe('The upstream URL (e.g. "https://api.example.com")'),
+        service_id: z.string().uuid().describe('UUID of the parent service (must exist)'),
+        weight: z.number().optional().default(1).describe('Load balancing weight (default 1)'),
+    }, async (args) => {
+        const result = await sopoPost('/api/v1/service-targets', args);
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error creating service target: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `Service target created:\n${JSON.stringify(result.data, null, 2)}` }] };
+    });
+    // ── Update Service Target ─────────────────────────────────────
+    server.tool('update_service_target', 'Update a service target by UUID. You can change the url or weight.', {
+        id: z.string().uuid().describe('UUID of the service target'),
+        url: z.string().describe('New upstream URL'),
+    }, async (args) => {
+        const { id, ...body } = args;
+        const result = await sopoPatch(`/api/v1/service-targets/${id}`, body);
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error updating target: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `Service target updated:\n${JSON.stringify(result.data, null, 2)}` }] };
+    });
+    // ── Delete Service Target ─────────────────────────────────────
+    server.tool('delete_service_target', 'Delete a service target by its UUID.', {
+        id: z.string().uuid().describe('UUID of the service target to delete'),
+    }, async (args) => {
+        const result = await sopoDelete(`/api/v1/service-targets/${args.id}`);
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error deleting target: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `Service target deleted successfully.` }] };
+    });
+}
+//# sourceMappingURL=service-target.tools.js.map

package/dist/tools/service-target.tools.js.map

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

package/dist/tools/service.tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sopo MCP Server — Service Tools
+ *
+ * CRUD tools for managing Services (upstream backends) within a Gateway.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerServiceTools(server: McpServer): void;
+//# sourceMappingURL=service.tools.d.ts.map

package/dist/tools/service.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.tools.d.ts","sourceRoot":"","sources":["../../src/tools/service.tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkF5D"}

package/dist/tools/service.tools.js

@@ -0,0 +1,67 @@
+/**
+ * Sopo MCP Server — Service Tools
+ *
+ * CRUD tools for managing Services (upstream backends) within a Gateway.
+ */
+import { z } from 'zod';
+import { sopoGet, sopoPost, sopoPatch, sopoDelete } from '../sopo-client.js';
+export function registerServiceTools(server) {
+    // ── List Services ─────────────────────────────────────────────
+    server.tool('list_services', 'List all services (upstream backends) across all gateways. Returns id, name, gateway_id, protocol, lb_policy, and health check settings.', {}, async () => {
+        const result = await sopoGet('/api/v1/services');
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
+    });
+    // ── Create Service ────────────────────────────────────────────
+    server.tool('create_service', 'Create a new service under a gateway. Requires name, gateway_id, protocol, and lb_policy. The gateway_id MUST reference an existing gateway.', {
+        name: z.string().describe('Name of the service'),
+        gateway_id: z.string().uuid().describe('UUID of the parent gateway (must exist)'),
+        protocol: z.string().describe('Protocol: "http" or "https"'),
+        lb_policy: z.string().describe('Load balancing policy: "round_robin", "weighted", or "random"'),
+        hc_path: z.string().optional().describe('Health check path (e.g. "/health")'),
+        hc_interval: z.string().optional().describe('Health check interval'),
+        hc_timeout: z.string().optional().describe('Health check timeout'),
+        hc_fail_threshold: z.number().optional().describe('Number of failures before marking unhealthy'),
+        hc_pass_threshold: z.number().optional().describe('Number of passes before marking healthy'),
+        collection_id: z.string().uuid().optional().describe('Optional collection ID (Pro mode)'),
+    }, async (args) => {
+        const result = await sopoPost('/api/v1/services', args);
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error creating service: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `Service created successfully:\n${JSON.stringify(result.data, null, 2)}` }] };
+    });
+    // ── Update Service ────────────────────────────────────────────
+    server.tool('update_service', 'Update an existing service by its UUID. You can change name, protocol, lb_policy, health check settings, or collection_id.', {
+        id: z.string().uuid().describe('UUID of the service to update'),
+        name: z.string().optional().describe('New name'),
+        protocol: z.string().optional().describe('New protocol'),
+        lb_policy: z.string().optional().describe('New load balancing policy'),
+        hc_path: z.string().optional().describe('Health check path'),
+        hc_interval: z.string().optional().describe('Health check interval'),
+        hc_timeout: z.string().optional().describe('Health check timeout'),
+        hc_fail_threshold: z.number().optional().describe('Failures before unhealthy'),
+        hc_pass_threshold: z.number().optional().describe('Passes before healthy'),
+        collection_id: z.string().uuid().optional().describe('Collection ID (Pro mode)'),
+    }, async (args) => {
+        const { id, ...body } = args;
+        const result = await sopoPatch(`/api/v1/services/${id}`, body);
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error updating service: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `Service updated successfully:\n${JSON.stringify(result.data, null, 2)}` }] };
+    });
+    // ── Delete Service ────────────────────────────────────────────
+    server.tool('delete_service', 'Delete a service by its UUID.', {
+        id: z.string().uuid().describe('UUID of the service to delete'),
+    }, async (args) => {
+        const result = await sopoDelete(`/api/v1/services/${args.id}`);
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error deleting service: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `Service deleted successfully.` }] };
+    });
+}
+//# sourceMappingURL=service.tools.js.map

package/dist/tools/service.tools.js.map

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

package/dist/tools/user-profile.tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sopo MCP Server — User Profile Tools
+ *
+ * CRUD tools for managing User Profiles (user slug/namespace).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerUserProfileTools(server: McpServer): void;
+//# sourceMappingURL=user-profile.tools.d.ts.map

package/dist/tools/user-profile.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile.tools.d.ts","sourceRoot":"","sources":["../../src/tools/user-profile.tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6DhE"}

package/dist/tools/user-profile.tools.js

@@ -0,0 +1,46 @@
+/**
+ * Sopo MCP Server — User Profile Tools
+ *
+ * CRUD tools for managing User Profiles (user slug/namespace).
+ */
+import { z } from 'zod';
+import { sopoGet, sopoPost, sopoPatch, sopoDelete } from '../sopo-client.js';
+export function registerUserProfileTools(server) {
+    // ── Get User Profile ──────────────────────────────────────────
+    server.tool('get_user_profile', 'Get the current authenticated user\'s profile, including their slug (URL namespace).', {}, async () => {
+        const result = await sopoGet('/api/v1/user-profiles');
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
+    });
+    // ── Create User Profile ───────────────────────────────────────
+    server.tool('create_user_profile', 'Create a profile for the authenticated user with a unique slug (URL namespace). Each user can only have one profile.', {
+        slug: z.string().describe('Unique slug for the user (e.g. "abdo")'),
+    }, async (args) => {
+        const result = await sopoPost('/api/v1/user-profiles', args);
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error creating profile: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `User profile created:\n${JSON.stringify(result.data, null, 2)}` }] };
+    });
+    // ── Update User Profile ───────────────────────────────────────
+    server.tool('update_user_profile', 'Update the authenticated user\'s slug.', {
+        slug: z.string().describe('New unique slug'),
+    }, async (args) => {
+        const result = await sopoPatch('/api/v1/user-profiles', args);
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error updating profile: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `User profile updated:\n${JSON.stringify(result.data, null, 2)}` }] };
+    });
+    // ── Delete User Profile ───────────────────────────────────────
+    server.tool('delete_user_profile', 'Delete the authenticated user\'s profile.', {}, async () => {
+        const result = await sopoDelete('/api/v1/user-profiles');
+        if (!result.success) {
+            return { content: [{ type: 'text', text: `Error deleting profile: ${result.error}` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `User profile deleted successfully.` }] };
+    });
+}
+//# sourceMappingURL=user-profile.tools.js.map

package/dist/tools/user-profile.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-profile.tools.js","sourceRoot":"","sources":["../../src/tools/user-profile.tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG7E,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IAExD,iEAAiE;IACjE,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,sFAAsF,EACtF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACxF,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACrF,CAAC,CACF,CAAC;IAEF,iEAAiE;IACjE,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,sHAAsH,EACtH;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KACpE,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACjH,CAAC,CACF,CAAC;IAEF,iEAAiE;IACjE,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,wCAAwC,EACxC;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KAC7C,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACjH,CAAC,CACF,CAAC;IAEF,iEAAiE;IACjE,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,2CAA2C,EAC3C,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oCAAoC,EAAE,CAAC,EAAE,CAAC;IACrF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "sopo-mcp",
+  "version": "1.0.0",
+  "description": "MCP (Model Context Protocol) Server for Sopo API Gateway Platform",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "sopo-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "sopo",
+    "api-gateway"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "dotenv": "^17.4.2",
+    "zod": "^3.25.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+import 'dotenv/config';
+
+/**
+ * ╔═══════════════════════════════════════════════════════════════╗
+ * ║                    Sopo MCP Server                           ║
+ * ║                                                              ║
+ * ║  Model Context Protocol server for the Sopo API Gateway      ║
+ * ║  platform. Enables AI models (Claude, etc.) to manage        ║
+ * ║  gateways, services, routes, plugins, and monitor metrics.   ║
+ * ╚═══════════════════════════════════════════════════════════════╝
+ * 
+ * Transport: stdio (for Claude Desktop / local AI clients)
+ * 
+ * Environment Variables:
+ *   SOPO_BACKEND_URL   — Base URL of the Sopo Backend (default: http://localhost:4000)
+ *   SOPO_ACCESS_TOKEN  — JWT access token for authentication
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { configureSopoClient } from './sopo-client.js';
+
+// ── Tool Registrations ──────────────────────────────────────────
+import { registerAuthTools } from './tools/auth.tools.js';
+import { registerGatewayTools } from './tools/gateway.tools.js';
+import { registerServiceTools } from './tools/service.tools.js';
+import { registerServiceTargetTools } from './tools/service-target.tools.js';
+import { registerGatewayRouteTools } from './tools/gateway-route.tools.js';
+import { registerGatewayPluginTools } from './tools/gateway-plugin.tools.js';
+import { registerAggregateRequestTools } from './tools/aggregate-request.tools.js';
+import { registerCollectionTools } from './tools/collection.tools.js';
+import { registerUserProfileTools } from './tools/user-profile.tools.js';
+import { registerObservabilityTools } from './tools/observability.tools.js';
+
+// ── Resource Registrations ──────────────────────────────────────
+import { registerResources } from './resources/platform.resources.js';
+
+// ── Prompt Registrations ────────────────────────────────────────
+import { registerPrompts } from './prompts/sopo.prompts.js';
+
+// ═══════════════════════════════════════════════════════════════
+// Configuration
+// ═══════════════════════════════════════════════════════════════
+
+const BACKEND_URL = process.env.SOPO_BACKEND_URL || 'http://localhost:4000';
+const ACCESS_TOKEN = process.env.SOPO_ACCESS_TOKEN || '';
+
+if (!ACCESS_TOKEN) {
+  console.error(
+    '⚠️  Warning: SOPO_ACCESS_TOKEN is not set. All API calls will fail with 401 Unauthorized.\n' +
+    '   Set it via environment variable or .env file.\n' +
+    '   See .env.example for reference.'
+  );
+}
+
+// ═══════════════════════════════════════════════════════════════
+// Initialize
+// ═══════════════════════════════════════════════════════════════
+
+// Configure the HTTP client
+configureSopoClient({
+  backendUrl: BACKEND_URL,
+  accessToken: ACCESS_TOKEN,
+});
+
+// Create the MCP Server
+const server = new McpServer({
+  name: 'sopo-mcp-server',
+  version: '1.0.0',
+  description: 'MCP Server for the Sopo API Gateway Platform — manage gateways, services, routes, plugins, and monitor metrics via AI.',
+});
+
+// ═══════════════════════════════════════════════════════════════
+// Register All Capabilities
+// ═══════════════════════════════════════════════════════════════
+
+// Tools — Authentication (login + refresh)
+registerAuthTools(server);              // 2 tools: login, refresh_token
+
+// Tools (30 tools covering full CRUD for all entities + observability)
+registerGatewayTools(server);           // 4 tools: list, create, update, delete
+registerServiceTools(server);           // 4 tools: list, create, update, delete
+registerServiceTargetTools(server);     // 4 tools: list, create, update, delete
+registerGatewayRouteTools(server);      // 4 tools: list, create, update, delete
+registerGatewayPluginTools(server);     // 4 tools: list, create, update, delete
+registerAggregateRequestTools(server);  // 4 tools: list, create, update, delete
+registerCollectionTools(server);        // 4 tools: list, create, update, delete
+registerUserProfileTools(server);       // 4 tools: get, create, update, delete
+registerObservabilityTools(server);     // 5 tools: health, stats, logs, metrics, metrics-mv
+
+// Resources (3 resources: platform overview, live config, live stats)
+registerResources(server);
+
+// Prompts (4 prompts: setup gateway, diagnose, full report, add plugin)
+registerPrompts(server);
+
+// ═══════════════════════════════════════════════════════════════
+// Start Server
+// ═══════════════════════════════════════════════════════════════
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('🚀 Sopo MCP Server started successfully');
+  console.error(`   Backend URL: ${BACKEND_URL}`);
+  console.error(`   Token: ${ACCESS_TOKEN ? '✅ configured' : '❌ missing'}`);
+  console.error(`   Tools: 39 | Resources: 3 | Prompts: 4`);
+}
+
+main().catch((error) => {
+  console.error('Fatal error starting Sopo MCP Server:', error);
+  process.exit(1);
+});

package/src/prompts/sopo.prompts.ts

@@ -0,0 +1,128 @@
+/**
+ * Sopo MCP Server — Prompts
+ * 
+ * Predefined prompt templates that guide the AI for common Sopo operations.
+ */
+
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+export function registerPrompts(server: McpServer): void {
+
+  // ── Setup New Gateway (Guided Workflow) ───────────────────────
+  server.prompt(
+    'setup_new_gateway',
+    'Guided workflow to set up a complete API gateway from scratch — creates gateway, service, service target, and route.',
+    {
+      gateway_name: z.string().describe('Name for the new gateway'),
+      upstream_url: z.string().describe('URL of the upstream backend to route to'),
+      route_path: z.string().describe('The incoming request path to handle'),
+    },
+    async (args) => ({
+      messages: [{
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `I want to set up a new API gateway in Sopo. Please execute these steps in order:
+
+1. **Create a gateway** named "${args.gateway_name}" in "single" mode (active).
+2. **Create a service** named "${args.gateway_name}-service" under the new gateway with protocol "http" and lb_policy "round_robin".
+3. **Create a service target** with URL "${args.upstream_url}" pointing to the new service.
+4. **Create a route** with path "${args.route_path}" on the new gateway pointing to the new service.
+
+After each step, confirm the ID of the created resource. If any step fails, stop and report the error.`,
+        },
+      }],
+    })
+  );
+
+  // ── Diagnose Gateway ──────────────────────────────────────────
+  server.prompt(
+    'diagnose_gateway',
+    'Diagnose the health and configuration of a specific gateway by reviewing its resources, routes, plugins, and recent metrics.',
+    {
+      gateway_name: z.string().describe('Name of the gateway to diagnose'),
+    },
+    async (args) => ({
+      messages: [{
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Please diagnose the gateway "${args.gateway_name}" in Sopo. Do the following:
+
+1. **List all gateways** and find the one named "${args.gateway_name}".
+2. **List all services** and filter those belonging to this gateway.
+3. **List all service targets** and check if the services have healthy upstream URLs.
+4. **List all routes** belonging to this gateway.
+5. **List all plugins** attached to this gateway or its routes.
+6. **Get resource stats** for an overview.
+7. **Fetch recent request logs** and look for errors or high latency.
+8. **Get hourly metrics** to check traffic trends.
+
+Provide a summary with:
+- ✅ Things that look good
+- ⚠️ Potential issues or misconfigurations  
+- 🔧 Recommended actions`,
+        },
+      }],
+    })
+  );
+
+  // ── Full Platform Report ──────────────────────────────────────
+  server.prompt(
+    'platform_report',
+    'Generate a comprehensive report of the entire Sopo platform — all resources, configuration, and metrics.',
+    {},
+    async () => ({
+      messages: [{
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Generate a complete Sopo platform report. Please:
+
+1. **Check system health** (call check_health).
+2. **Get resource stats** for overall counts.
+3. **List all gateways** with their details.
+4. **List all services** with health check configs.
+5. **List all service targets** with their URLs and weights.
+6. **List all routes** with their path mappings.
+7. **List all plugins** with their configs.
+8. **List all collections** if any exist.
+9. **Get user profile** to show the current user's slug.
+10. **Fetch hourly metrics** to show recent traffic.
+
+Format everything as a structured, readable report with sections for each resource type.`,
+        },
+      }],
+    })
+  );
+
+  // ── Add Plugin to Gateway ─────────────────────────────────────
+  server.prompt(
+    'add_plugin_to_gateway',
+    'Attach a middleware plugin (like API key auth, rate limiting, or CORS) to a gateway.',
+    {
+      gateway_name: z.string().describe('Name of the gateway'),
+      plugin_type: z.string().describe('Plugin type (e.g. "apikey", "rate_limit", "cors")'),
+    },
+    async (args) => ({
+      messages: [{
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `I want to add a "${args.plugin_type}" plugin to the gateway "${args.gateway_name}". Please:
+
+1. **List all gateways** and find the one named "${args.gateway_name}" to get its ID.
+2. **Create a gateway plugin** with:
+   - name: "${args.plugin_type}"
+   - phase: "access" (or the appropriate phase for this plugin type)
+   - gateway_id: (the ID found above)
+   - enabled: true
+   - A sensible default plugin_config for "${args.plugin_type}"
+
+Explain what the plugin does and what its configuration means.`,
+        },
+      }],
+    })
+  );
+}