@planu/cli 0.45.5 → 0.47.0

package/src/config/mcp-archetypes.json

@@ -0,0 +1,872 @@
+{
+  "archetypes": [
+    {
+      "domain": "crm",
+      "displayName": "CRM / Customer Management",
+      "description": "Customer relationship management — contacts, deals, accounts, interactions",
+      "tools": [
+        {
+          "name": "search_contacts",
+          "description": "Search contacts by name, email, phone, or custom fields",
+          "inputHints": ["query: string", "limit?: number", "offset?: number"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "create_contact",
+          "description": "Create a new contact with personal and company details",
+          "inputHints": [
+            "firstName: string",
+            "lastName: string",
+            "email: string",
+            "phone?: string",
+            "company?: string"
+          ],
+          "sideEffects": ["database-write", "audit-log"],
+          "readOnly": false
+        },
+        {
+          "name": "get_contact",
+          "description": "Retrieve a single contact by ID with full relationship data",
+          "inputHints": ["contactId: string", "includeDeals?: boolean", "includeNotes?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "update_contact",
+          "description": "Update fields on an existing contact record",
+          "inputHints": ["contactId: string", "fields: Record<string, unknown>"],
+          "sideEffects": ["database-write", "audit-log", "webhook-trigger"],
+          "readOnly": false
+        },
+        {
+          "name": "list_deals",
+          "description": "List deals with optional filtering by stage, owner, or value range",
+          "inputHints": [
+            "stage?: string",
+            "ownerId?: string",
+            "minValue?: number",
+            "maxValue?: number",
+            "limit?: number"
+          ],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "search_accounts",
+          "description": "Search company accounts by name, industry, or revenue range",
+          "inputHints": ["query: string", "industry?: string", "minRevenue?: number", "limit?: number"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://contacts/schema",
+          "name": "Contact Schema",
+          "description": "Schema definition for the Contact entity",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://deals/schema",
+          "name": "Deal Schema",
+          "description": "Schema definition for the Deal entity including pipeline stages",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "API key"],
+      "complianceHints": ["GDPR", "CCPA"]
+    },
+    {
+      "domain": "billing",
+      "displayName": "Billing / Subscriptions",
+      "description": "Invoice management, payment processing, subscription lifecycle",
+      "tools": [
+        {
+          "name": "create_invoice",
+          "description": "Create a new invoice for a customer with line items",
+          "inputHints": [
+            "customerId: string",
+            "lineItems: Array<{description: string, amount: number, quantity: number}>",
+            "dueDate: string",
+            "currency?: string"
+          ],
+          "sideEffects": ["database-write", "audit-log", "email-notification"],
+          "readOnly": false
+        },
+        {
+          "name": "list_invoices",
+          "description": "List invoices filtered by customer, status, or date range",
+          "inputHints": [
+            "customerId?: string",
+            "status?: string",
+            "fromDate?: string",
+            "toDate?: string",
+            "limit?: number"
+          ],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "get_invoice",
+          "description": "Retrieve a single invoice by ID with line items and payment history",
+          "inputHints": ["invoiceId: string"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "record_payment",
+          "description": "Record a payment against an invoice",
+          "inputHints": ["invoiceId: string", "amount: number", "paymentMethod: string", "referenceId?: string"],
+          "sideEffects": ["database-write", "payment-gateway", "audit-log", "email-notification"],
+          "readOnly": false
+        },
+        {
+          "name": "list_subscriptions",
+          "description": "List active subscriptions with plan details and renewal dates",
+          "inputHints": ["customerId?: string", "planId?: string", "status?: string", "limit?: number"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "cancel_subscription",
+          "description": "Cancel a subscription immediately or at end of billing period",
+          "inputHints": ["subscriptionId: string", "cancelAt?: string", "reason?: string"],
+          "sideEffects": ["database-write", "payment-gateway", "audit-log", "email-notification", "webhook-trigger"],
+          "readOnly": false
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://invoices/schema",
+          "name": "Invoice Schema",
+          "description": "Schema definition for invoices including line items and statuses",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://subscriptions/plans",
+          "name": "Subscription Plans",
+          "description": "Available subscription plans with pricing and feature sets",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "API key"],
+      "complianceHints": ["PCI-DSS", "SOX"]
+    },
+    {
+      "domain": "inventory",
+      "displayName": "Inventory / Supply Chain",
+      "description": "Stock management, order fulfillment, warehouse operations, shipment tracking",
+      "tools": [
+        {
+          "name": "check_stock",
+          "description": "Check available stock for a product across warehouses",
+          "inputHints": ["productId: string", "warehouseId?: string", "includeReserved?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "create_order",
+          "description": "Create a fulfillment order with line items and shipping details",
+          "inputHints": [
+            "items: Array<{productId: string, quantity: number}>",
+            "shippingAddress: object",
+            "priority?: string"
+          ],
+          "sideEffects": ["database-write", "stock-reservation", "audit-log"],
+          "readOnly": false
+        },
+        {
+          "name": "get_order",
+          "description": "Retrieve order details including fulfillment status and tracking",
+          "inputHints": ["orderId: string"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "track_shipment",
+          "description": "Get real-time tracking information for a shipment",
+          "inputHints": ["shipmentId: string", "trackingNumber?: string"],
+          "sideEffects": ["external-api-read"],
+          "readOnly": true
+        },
+        {
+          "name": "transfer_stock",
+          "description": "Transfer stock between warehouses",
+          "inputHints": ["productId: string", "quantity: number", "fromWarehouseId: string", "toWarehouseId: string"],
+          "sideEffects": ["database-write", "audit-log", "notification"],
+          "readOnly": false
+        },
+        {
+          "name": "get_warehouse_summary",
+          "description": "Get summary of stock levels and capacity for a warehouse",
+          "inputHints": ["warehouseId: string", "includeAlerts?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://products/schema",
+          "name": "Product Schema",
+          "description": "Schema definition for product catalog entries",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://warehouses/list",
+          "name": "Warehouse Registry",
+          "description": "List of available warehouses with location and capacity metadata",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["API key", "mTLS"],
+      "complianceHints": ["SOC 2"]
+    },
+    {
+      "domain": "healthcare",
+      "displayName": "Healthcare / Clinical",
+      "description": "Patient records, appointments, lab results, clinical notes — HIPAA-regulated",
+      "tools": [
+        {
+          "name": "get_patient",
+          "description": "Retrieve patient demographics and summary medical record",
+          "inputHints": ["patientId: string", "includeMedications?: boolean", "includeAllergies?: boolean"],
+          "sideEffects": ["database-read", "audit-log"],
+          "readOnly": true
+        },
+        {
+          "name": "list_appointments",
+          "description": "List appointments for a patient or provider within a date range",
+          "inputHints": [
+            "patientId?: string",
+            "providerId?: string",
+            "fromDate: string",
+            "toDate: string",
+            "status?: string"
+          ],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "create_appointment",
+          "description": "Schedule a new appointment for a patient with a provider",
+          "inputHints": [
+            "patientId: string",
+            "providerId: string",
+            "dateTime: string",
+            "duration: number",
+            "type: string",
+            "reason?: string"
+          ],
+          "sideEffects": ["database-write", "calendar-sync", "sms-notification", "audit-log"],
+          "readOnly": false
+        },
+        {
+          "name": "get_lab_results",
+          "description": "Retrieve lab results for a patient, optionally filtered by test type or date",
+          "inputHints": ["patientId: string", "testType?: string", "fromDate?: string", "toDate?: string"],
+          "sideEffects": ["database-read", "audit-log"],
+          "readOnly": true
+        },
+        {
+          "name": "add_clinical_note",
+          "description": "Add a clinical note to a patient encounter record",
+          "inputHints": [
+            "patientId: string",
+            "encounterId: string",
+            "noteType: string",
+            "content: string",
+            "providerId: string"
+          ],
+          "sideEffects": ["database-write", "audit-log", "ehr-sync"],
+          "readOnly": false
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://patients/schema",
+          "name": "Patient Schema",
+          "description": "FHIR-aligned patient resource schema definition",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://encounters/schema",
+          "name": "Encounter Schema",
+          "description": "Clinical encounter schema with note types and code systems",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "SMART on FHIR"],
+      "complianceHints": ["HIPAA", "HITECH", "HL7 FHIR"]
+    },
+    {
+      "domain": "ecommerce",
+      "displayName": "E-Commerce / Online Store",
+      "description": "Product catalog, shopping cart, order management, pricing and discounts",
+      "tools": [
+        {
+          "name": "search_products",
+          "description": "Search product catalog with filters for category, price, and availability",
+          "inputHints": [
+            "query: string",
+            "category?: string",
+            "minPrice?: number",
+            "maxPrice?: number",
+            "inStock?: boolean",
+            "limit?: number"
+          ],
+          "sideEffects": ["database-read", "search-index"],
+          "readOnly": true
+        },
+        {
+          "name": "get_product",
+          "description": "Retrieve full product details including variants, images, and reviews",
+          "inputHints": ["productId: string", "includeReviews?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "check_inventory",
+          "description": "Check real-time inventory for a product variant across locations",
+          "inputHints": ["productId: string", "variantId?: string", "locationId?: string"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "create_order",
+          "description": "Place a new order with cart items and shipping details",
+          "inputHints": [
+            "customerId: string",
+            "items: Array<{productId: string, variantId: string, quantity: number}>",
+            "shippingAddress: object",
+            "paymentMethodId: string"
+          ],
+          "sideEffects": ["database-write", "payment-gateway", "stock-reservation", "email-notification", "audit-log"],
+          "readOnly": false
+        },
+        {
+          "name": "get_order_status",
+          "description": "Get current status and tracking info for an order",
+          "inputHints": ["orderId: string"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "apply_discount",
+          "description": "Validate and apply a discount code to an order or cart",
+          "inputHints": ["code: string", "cartTotal: number", "items: Array<{productId: string, quantity: number}>"],
+          "sideEffects": ["database-read", "coupon-validation"],
+          "readOnly": true
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://products/schema",
+          "name": "Product Schema",
+          "description": "Product catalog schema with variants, pricing, and media references",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://orders/schema",
+          "name": "Order Schema",
+          "description": "Order lifecycle schema with statuses, line items, and fulfillment states",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "API key"],
+      "complianceHints": ["PCI-DSS", "GDPR"]
+    },
+    {
+      "domain": "project-mgmt",
+      "displayName": "Project Management / Issue Tracking",
+      "description": "Issue tracking, sprint planning, boards, comments, and team collaboration",
+      "tools": [
+        {
+          "name": "search_issues",
+          "description": "Search issues by title, label, assignee, or status across projects",
+          "inputHints": [
+            "query: string",
+            "projectId?: string",
+            "status?: string",
+            "assigneeId?: string",
+            "labels?: string[]",
+            "limit?: number"
+          ],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "create_issue",
+          "description": "Create a new issue with title, description, assignee, and labels",
+          "inputHints": [
+            "projectId: string",
+            "title: string",
+            "description: string",
+            "assigneeId?: string",
+            "labels?: string[]",
+            "priority?: string",
+            "sprintId?: string"
+          ],
+          "sideEffects": ["database-write", "notification", "webhook-trigger"],
+          "readOnly": false
+        },
+        {
+          "name": "update_issue",
+          "description": "Update fields on an existing issue such as status, assignee, or priority",
+          "inputHints": ["issueId: string", "fields: Record<string, unknown>"],
+          "sideEffects": ["database-write", "notification", "webhook-trigger", "audit-log"],
+          "readOnly": false
+        },
+        {
+          "name": "list_sprints",
+          "description": "List sprints for a project with velocity and completion metrics",
+          "inputHints": ["projectId: string", "status?: string", "limit?: number"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "add_comment",
+          "description": "Add a comment to an issue with optional mentions",
+          "inputHints": ["issueId: string", "body: string", "mentions?: string[]"],
+          "sideEffects": ["database-write", "notification"],
+          "readOnly": false
+        },
+        {
+          "name": "get_board",
+          "description": "Retrieve board columns with issue counts and WIP limits",
+          "inputHints": ["boardId: string", "includeIssues?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://issues/schema",
+          "name": "Issue Schema",
+          "description": "Issue schema with statuses, priorities, labels, and custom field definitions",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://projects/list",
+          "name": "Projects List",
+          "description": "Available projects with board configurations and team membership",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "API key"],
+      "complianceHints": ["SOC 2"]
+    },
+    {
+      "domain": "social",
+      "displayName": "Social / Messaging",
+      "description": "Social feeds, posts, user profiles, direct messaging, notifications",
+      "tools": [
+        {
+          "name": "get_feed",
+          "description": "Retrieve the activity feed for the authenticated user or a topic",
+          "inputHints": ["userId?: string", "topic?: string", "cursor?: string", "limit?: number"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "create_post",
+          "description": "Create a new post with text, media, and visibility settings",
+          "inputHints": ["content: string", "mediaUrls?: string[]", "visibility?: string", "tags?: string[]"],
+          "sideEffects": ["database-write", "media-processing", "notification", "feed-fanout"],
+          "readOnly": false
+        },
+        {
+          "name": "search_users",
+          "description": "Search user profiles by name, handle, or bio keywords",
+          "inputHints": ["query: string", "limit?: number", "offset?: number"],
+          "sideEffects": ["database-read", "search-index"],
+          "readOnly": true
+        },
+        {
+          "name": "send_message",
+          "description": "Send a direct message to a user or group conversation",
+          "inputHints": ["recipientId: string", "content: string", "conversationId?: string", "attachments?: string[]"],
+          "sideEffects": ["database-write", "push-notification", "websocket-broadcast"],
+          "readOnly": false
+        },
+        {
+          "name": "get_notifications",
+          "description": "Retrieve unread and recent notifications for the authenticated user",
+          "inputHints": ["unreadOnly?: boolean", "type?: string", "limit?: number"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://users/schema",
+          "name": "User Profile Schema",
+          "description": "User profile schema with privacy settings and relationship fields",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://posts/schema",
+          "name": "Post Schema",
+          "description": "Post schema with media types, visibility levels, and engagement metrics",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "JWT"],
+      "complianceHints": ["GDPR", "COPPA", "CCPA"]
+    },
+    {
+      "domain": "gaming",
+      "displayName": "Gaming / Multiplayer",
+      "description": "Player profiles, leaderboards, match history, lobbies, and scoring",
+      "tools": [
+        {
+          "name": "get_player",
+          "description": "Retrieve a player profile with stats, rank, and recent activity",
+          "inputHints": ["playerId: string", "includeStats?: boolean", "includeHistory?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "list_leaderboard",
+          "description": "Retrieve leaderboard rankings by game mode, season, or region",
+          "inputHints": ["gameMode: string", "season?: string", "region?: string", "limit?: number", "offset?: number"],
+          "sideEffects": ["cache-read"],
+          "readOnly": true
+        },
+        {
+          "name": "update_score",
+          "description": "Submit a score update for a player in a match or session",
+          "inputHints": ["playerId: string", "matchId: string", "score: number", "metadata?: Record<string, unknown>"],
+          "sideEffects": ["database-write", "leaderboard-update", "achievement-check"],
+          "readOnly": false
+        },
+        {
+          "name": "get_match",
+          "description": "Retrieve match details including players, scores, and replay data",
+          "inputHints": ["matchId: string", "includeReplay?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "create_lobby",
+          "description": "Create a multiplayer game lobby with configuration and invite links",
+          "inputHints": [
+            "gameMode: string",
+            "maxPlayers: number",
+            "isPrivate?: boolean",
+            "region?: string",
+            "settings?: Record<string, unknown>"
+          ],
+          "sideEffects": ["database-write", "matchmaking-queue", "websocket-broadcast"],
+          "readOnly": false
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://players/schema",
+          "name": "Player Schema",
+          "description": "Player profile schema with rank tiers, stats categories, and progression fields",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://game-modes/list",
+          "name": "Game Modes",
+          "description": "Available game modes with rules, scoring systems, and player limits",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "JWT", "platform-specific tokens"],
+      "complianceHints": ["COPPA", "GDPR"]
+    },
+    {
+      "domain": "iot",
+      "displayName": "IoT / Device Management",
+      "description": "Device registry, telemetry, remote commands, sensor data, alerting",
+      "tools": [
+        {
+          "name": "list_devices",
+          "description": "List registered devices with status, firmware version, and location",
+          "inputHints": ["groupId?: string", "status?: string", "deviceType?: string", "limit?: number"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "get_device_status",
+          "description": "Get real-time status and health metrics for a specific device",
+          "inputHints": ["deviceId: string", "includeMetrics?: boolean"],
+          "sideEffects": ["device-poll", "database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "send_command",
+          "description": "Send a remote command to a device for execution",
+          "inputHints": [
+            "deviceId: string",
+            "command: string",
+            "payload?: Record<string, unknown>",
+            "timeout?: number"
+          ],
+          "sideEffects": ["device-write", "audit-log", "command-queue"],
+          "readOnly": false
+        },
+        {
+          "name": "get_sensor_data",
+          "description": "Retrieve time-series sensor data for a device within a time range",
+          "inputHints": [
+            "deviceId: string",
+            "sensorType: string",
+            "fromDate: string",
+            "toDate: string",
+            "aggregation?: string"
+          ],
+          "sideEffects": ["timeseries-read"],
+          "readOnly": true
+        },
+        {
+          "name": "create_alert",
+          "description": "Create an alert rule for device metrics or connectivity thresholds",
+          "inputHints": [
+            "deviceId: string",
+            "metric: string",
+            "condition: string",
+            "threshold: number",
+            "notificationChannels: string[]"
+          ],
+          "sideEffects": ["database-write", "alert-engine-config"],
+          "readOnly": false
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://devices/schema",
+          "name": "Device Schema",
+          "description": "Device registry schema with capabilities, firmware, and connectivity fields",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://sensors/types",
+          "name": "Sensor Types",
+          "description": "Supported sensor types with units, ranges, and calibration metadata",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["mTLS", "API key", "device certificates"],
+      "complianceHints": ["SOC 2", "ISO 27001"]
+    },
+    {
+      "domain": "hr",
+      "displayName": "HR / People Operations",
+      "description": "Employee records, leave management, payroll, recruiting, and org structure",
+      "tools": [
+        {
+          "name": "list_employees",
+          "description": "List employees with optional filters by department, role, or status",
+          "inputHints": [
+            "departmentId?: string",
+            "role?: string",
+            "status?: string",
+            "limit?: number",
+            "offset?: number"
+          ],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "get_employee",
+          "description": "Retrieve full employee profile including compensation and org data",
+          "inputHints": ["employeeId: string", "includeCompensation?: boolean", "includeReports?: boolean"],
+          "sideEffects": ["database-read", "audit-log"],
+          "readOnly": true
+        },
+        {
+          "name": "create_leave_request",
+          "description": "Submit a leave request for an employee with type and date range",
+          "inputHints": [
+            "employeeId: string",
+            "leaveType: string",
+            "startDate: string",
+            "endDate: string",
+            "reason?: string"
+          ],
+          "sideEffects": ["database-write", "notification", "calendar-sync", "approval-workflow"],
+          "readOnly": false
+        },
+        {
+          "name": "get_payroll_summary",
+          "description": "Get payroll summary for a period including deductions and taxes",
+          "inputHints": ["employeeId?: string", "departmentId?: string", "period: string"],
+          "sideEffects": ["database-read", "audit-log"],
+          "readOnly": true
+        },
+        {
+          "name": "list_open_positions",
+          "description": "List open job positions with requirements and application counts",
+          "inputHints": ["departmentId?: string", "location?: string", "seniorityLevel?: string", "limit?: number"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://employees/schema",
+          "name": "Employee Schema",
+          "description": "Employee record schema with personal data, role, and org hierarchy fields",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://leave-policies/list",
+          "name": "Leave Policies",
+          "description": "Available leave types with accrual rules, limits, and approval chains",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "SAML"],
+      "complianceHints": ["GDPR", "SOX", "EEOC"]
+    },
+    {
+      "domain": "logistics",
+      "displayName": "Logistics / Freight",
+      "description": "Shipment creation, tracking, route optimization, warehouse operations, cost estimation",
+      "tools": [
+        {
+          "name": "create_shipment",
+          "description": "Create a new shipment with origin, destination, and package details",
+          "inputHints": [
+            "origin: object",
+            "destination: object",
+            "packages: Array<{weight: number, dimensions: object}>",
+            "serviceLevel: string",
+            "pickupDate?: string"
+          ],
+          "sideEffects": ["database-write", "carrier-api", "label-generation", "audit-log"],
+          "readOnly": false
+        },
+        {
+          "name": "track_shipment",
+          "description": "Get real-time tracking events and estimated delivery for a shipment",
+          "inputHints": ["shipmentId: string", "trackingNumber?: string"],
+          "sideEffects": ["external-api-read"],
+          "readOnly": true
+        },
+        {
+          "name": "list_routes",
+          "description": "List available shipping routes with transit times and carrier options",
+          "inputHints": ["originRegion: string", "destinationRegion: string", "serviceLevel?: string"],
+          "sideEffects": ["database-read", "carrier-api"],
+          "readOnly": true
+        },
+        {
+          "name": "get_warehouse_status",
+          "description": "Get operational status of a warehouse including capacity and throughput",
+          "inputHints": ["warehouseId: string", "includeWorkers?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "calculate_shipping_cost",
+          "description": "Calculate shipping cost estimate for given package dimensions and route",
+          "inputHints": [
+            "origin: object",
+            "destination: object",
+            "packages: Array<{weight: number, dimensions: object}>",
+            "serviceLevel: string"
+          ],
+          "sideEffects": ["carrier-api", "rate-calculation"],
+          "readOnly": true
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://shipments/schema",
+          "name": "Shipment Schema",
+          "description": "Shipment schema with package specs, carrier codes, and lifecycle statuses",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://carriers/list",
+          "name": "Carrier Registry",
+          "description": "Supported carriers with service levels, coverage zones, and rate tiers",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["API key", "mTLS"],
+      "complianceHints": ["C-TPAT", "AEO", "IATA"]
+    },
+    {
+      "domain": "media",
+      "displayName": "Media / CMS",
+      "description": "Content management, publishing workflows, media assets, categories, and analytics",
+      "tools": [
+        {
+          "name": "search_content",
+          "description": "Search content by title, tags, author, or full-text across the CMS",
+          "inputHints": [
+            "query: string",
+            "contentType?: string",
+            "status?: string",
+            "authorId?: string",
+            "tags?: string[]",
+            "limit?: number"
+          ],
+          "sideEffects": ["database-read", "search-index"],
+          "readOnly": true
+        },
+        {
+          "name": "get_content",
+          "description": "Retrieve a content item by ID with body, metadata, and revision history",
+          "inputHints": ["contentId: string", "version?: number", "includeRevisions?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "publish_content",
+          "description": "Publish or schedule content for publication with distribution options",
+          "inputHints": [
+            "contentId: string",
+            "publishAt?: string",
+            "channels?: string[]",
+            "notifySubscribers?: boolean"
+          ],
+          "sideEffects": ["database-write", "cdn-purge", "notification", "feed-update", "audit-log"],
+          "readOnly": false
+        },
+        {
+          "name": "list_categories",
+          "description": "List content categories and taxonomy with item counts",
+          "inputHints": ["parentId?: string", "includeCount?: boolean"],
+          "sideEffects": ["database-read"],
+          "readOnly": true
+        },
+        {
+          "name": "get_analytics",
+          "description": "Get engagement analytics for a content item or category over a period",
+          "inputHints": [
+            "contentId?: string",
+            "categoryId?: string",
+            "fromDate: string",
+            "toDate: string",
+            "metrics?: string[]"
+          ],
+          "sideEffects": ["analytics-read"],
+          "readOnly": true
+        }
+      ],
+      "resources": [
+        {
+          "uri": "entity://content/schema",
+          "name": "Content Schema",
+          "description": "Content item schema with body formats, metadata fields, and workflow states",
+          "mimeType": "application/json"
+        },
+        {
+          "uri": "entity://taxonomy/tree",
+          "name": "Taxonomy Tree",
+          "description": "Category and tag taxonomy hierarchy with content type associations",
+          "mimeType": "application/json"
+        }
+      ],
+      "authHints": ["OAuth 2.1", "API key"],
+      "complianceHints": ["GDPR", "DMCA"]
+    }
+  ]
+}