@vibescope/mcp-server 0.3.0 → 0.3.3

package/src/tools/connectors.ts

@@ -0,0 +1,191 @@
+/**
+ * Connector Tool Definitions
+ *
+ * Tools for external integrations (Slack, Discord, webhooks, etc.):
+ * - get_connectors
+ * - get_connector
+ * - add_connector
+ * - update_connector
+ * - delete_connector
+ * - test_connector
+ * - get_connector_events
+ */
+
+import type { Tool } from './types.js';
+
+export const connectorTools: Tool[] = [
+	{
+		name: 'get_connectors',
+		description: `List connectors for a project. Connectors enable sending events to external services (Slack, Discord, webhooks, etc.).`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				type: {
+					type: 'string',
+					enum: ['webhook', 'slack', 'discord', 'github', 'custom'],
+					description: 'Filter by connector type (optional)',
+				},
+				status: {
+					type: 'string',
+					enum: ['active', 'disabled'],
+					description: 'Filter by status (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max connectors to return (default: 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Pagination offset (default: 0)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_connector',
+		description: `Get a single connector with full details including configuration (sensitive fields are masked).`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID',
+				},
+			},
+			required: ['connector_id'],
+		},
+	},
+	{
+		name: 'add_connector',
+		description: `Add a new connector for external integrations. Supports webhook, Slack, Discord, GitHub, and custom connectors.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				name: {
+					type: 'string',
+					description: 'Connector name (e.g., "Slack Notifications")',
+				},
+				type: {
+					type: 'string',
+					enum: ['webhook', 'slack', 'discord', 'github', 'custom'],
+					description: 'Connector type',
+				},
+				description: {
+					type: 'string',
+					description: 'Optional description',
+				},
+				config: {
+					type: 'object',
+					description: 'Type-specific configuration (e.g., { webhook_url: "..." } for Slack)',
+				},
+				events: {
+					type: 'object',
+					description: 'Event subscriptions (e.g., { task_completed: true, blocker_added: true })',
+				},
+			},
+			required: ['project_id', 'name', 'type'],
+		},
+	},
+	{
+		name: 'update_connector',
+		description: `Update a connector's configuration, events, or status.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID',
+				},
+				name: {
+					type: 'string',
+					description: 'Updated name',
+				},
+				description: {
+					type: 'string',
+					description: 'Updated description',
+				},
+				config: {
+					type: 'object',
+					description: 'Updated configuration (merged with existing)',
+				},
+				events: {
+					type: 'object',
+					description: 'Updated event subscriptions',
+				},
+				status: {
+					type: 'string',
+					enum: ['active', 'disabled'],
+					description: 'Enable or disable the connector',
+				},
+			},
+			required: ['connector_id'],
+		},
+	},
+	{
+		name: 'delete_connector',
+		description: `Delete a connector.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID',
+				},
+			},
+			required: ['connector_id'],
+		},
+	},
+	{
+		name: 'test_connector',
+		description: `Test a connector by sending a test event. Returns success/failure status.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID to test',
+				},
+			},
+			required: ['connector_id'],
+		},
+	},
+	{
+		name: 'get_connector_events',
+		description: `Get event history for a connector or project. Shows delivery status and errors.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				connector_id: {
+					type: 'string',
+					description: 'Connector UUID (optional if project_id provided)',
+				},
+				project_id: {
+					type: 'string',
+					description: 'Project UUID (optional if connector_id provided)',
+				},
+				status: {
+					type: 'string',
+					enum: ['pending', 'sent', 'failed', 'retrying'],
+					description: 'Filter by delivery status (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max events to return (default: 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Pagination offset (default: 0)',
+				},
+			},
+		},
+	},
+];

package/src/tools/cost.ts

@@ -0,0 +1,111 @@
+/**
+ * Cost Tool Definitions
+ *
+ * Tools for cost monitoring and alerts:
+ * - get_cost_summary
+ * - add_cost_alert
+ * - update_cost_alert
+ * - delete_cost_alert
+ */
+
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+export const costTools: Tool[] = [
+	{
+		name: 'get_cost_summary',
+		description: 'Get cost summary (daily/weekly/monthly) for a project.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				period: {
+					type: 'string',
+					enum: ['daily', 'weekly', 'monthly'],
+					description: 'Summary period (default: daily)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max records to return (default: 30)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'add_cost_alert',
+		description: 'Add a cost alert threshold.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID (null for all projects)',
+				},
+				threshold_amount: {
+					type: 'number',
+					description: 'Amount in USD that triggers the alert',
+				},
+				threshold_period: {
+					type: 'string',
+					enum: ['daily', 'weekly', 'monthly'],
+					description: 'Period for the threshold',
+				},
+				alert_type: {
+					type: 'string',
+					enum: ['warning', 'critical'],
+					description: 'Alert severity (default: warning)',
+				},
+			},
+			required: ['threshold_amount', 'threshold_period'],
+		},
+	},
+	{
+		name: 'update_cost_alert',
+		description: 'Update a cost alert.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				alert_id: {
+					type: 'string',
+					description: 'Alert UUID',
+				},
+				threshold_amount: {
+					type: 'number',
+					description: 'New threshold amount in USD',
+				},
+				threshold_period: {
+					type: 'string',
+					enum: ['daily', 'weekly', 'monthly'],
+					description: 'New period',
+				},
+				alert_type: {
+					type: 'string',
+					enum: ['warning', 'critical'],
+					description: 'New alert type',
+				},
+				enabled: {
+					type: 'boolean',
+					description: 'Enable or disable the alert',
+				},
+			},
+			required: ['alert_id'],
+		},
+	},
+	{
+		name: 'delete_cost_alert',
+		description: 'Delete a cost alert.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				alert_id: {
+					type: 'string',
+					description: 'Alert UUID to delete',
+				},
+			},
+			required: ['alert_id'],
+		},
+	},
+];

package/src/tools/decisions.ts

@@ -0,0 +1,111 @@
+/**
+ * Decision Tool Definitions
+ *
+ * Tools for recording architectural and technical decisions:
+ * - log_decision
+ * - get_decision
+ * - get_decisions
+ * - get_decisions_stats
+ * - delete_decision
+ */
+
+import type { Tool } from './types.js';
+
+export const decisionTools: Tool[] = [
+	{
+		name: 'log_decision',
+		description: `Record an architectural or technical decision with rationale.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Decision title (e.g., "Use PostgreSQL for database")',
+				},
+				description: {
+					type: 'string',
+					description: 'What was decided',
+				},
+				rationale: {
+					type: 'string',
+					description: 'Why this decision was made',
+				},
+				alternatives_considered: {
+					type: 'array',
+					items: { type: 'string' },
+					description: 'Other options that were considered',
+				},
+			},
+			required: ['project_id', 'title', 'description'],
+		},
+	},
+	{
+		name: 'get_decision',
+		description: `Get a single decision by ID. More token-efficient than get_decisions when you need details for a specific decision.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				decision_id: {
+					type: 'string',
+					description: 'Decision UUID',
+				},
+			},
+			required: ['decision_id'],
+		},
+	},
+	{
+		name: 'get_decisions',
+		description: `Get recorded decisions for a project.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of decisions to return (default 10, max 200)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of decisions to skip for pagination (default 0)',
+				},
+				search_query: {
+					type: 'string',
+					description: 'Search decisions by title',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_decisions_stats',
+		description: `Get aggregate statistics about decisions for a project. Returns total count. More token-efficient than get_decisions when you just need to know how many decisions exist.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: { type: 'string', description: 'Project UUID' },
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'delete_decision',
+		description: `Delete a decision.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				decision_id: {
+					type: 'string',
+					description: 'Decision UUID',
+				},
+			},
+			required: ['decision_id'],
+		},
+	},
+];