@stacksfinder/mcp-server 1.0.0

package/dist/tools/analyze.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { CONTEXTS, DATA_VERSION, DIMENSION_LABELS, SCORE_DIMENSIONS, calculateOverallScore, findCompatibleTechs, getAllTechIds, getScores, getTechnology, scoreToGrade, techExists } from '../data/index.js';
+import { techNotFoundError } from '../utils/errors.js';
+/**
+ * Input schema for analyze_tech tool.
+ */
+export const AnalyzeTechInputSchema = z.object({
+    technology: z.string().min(1).describe('Technology ID to analyze (e.g., "nextjs", "postgres")'),
+    context: z.enum(CONTEXTS).optional().default('default').describe('Context for score lookup')
+});
+/**
+ * Tool definition for MCP registration.
+ */
+export const analyzeTechToolDefinition = {
+    name: 'analyze_tech',
+    description: 'Detailed analysis of a technology with 6-dimension scores, strengths, weaknesses, and compatible technologies.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            technology: {
+                type: 'string',
+                description: 'Technology ID (e.g., "nextjs", "postgres", "drizzle")'
+            },
+            context: {
+                type: 'string',
+                enum: CONTEXTS,
+                description: 'Context for scoring (default, mvp, enterprise)'
+            }
+        },
+        required: ['technology']
+    }
+};
+/**
+ * Identify strengths (top scores) and weaknesses (low scores).
+ */
+function analyzeStrengthsWeaknesses(scores) {
+    const sorted = SCORE_DIMENSIONS.map((dim) => ({
+        dim: DIMENSION_LABELS[dim],
+        dimKey: dim,
+        score: scores[dim]
+    })).sort((a, b) => b.score - a.score);
+    // Top 2 as strengths (if score >= 85)
+    const strengths = sorted.filter((s) => s.score >= 85).slice(0, 2);
+    // Bottom 2 as weaknesses (if score < 80)
+    const weaknesses = sorted
+        .reverse()
+        .filter((s) => s.score < 80)
+        .slice(0, 2);
+    return {
+        strengths: strengths.map((s) => ({ dim: s.dim, score: s.score })),
+        weaknesses: weaknesses.map((s) => ({ dim: s.dim, score: s.score }))
+    };
+}
+/**
+ * Execute analyze_tech tool.
+ */
+export function executeAnalyzeTech(input) {
+    const { technology, context = 'default' } = input;
+    // Check if technology exists
+    if (!techExists(technology)) {
+        const error = techNotFoundError(technology, getAllTechIds());
+        return { text: error.toResponseText(), isError: true };
+    }
+    const tech = getTechnology(technology);
+    const scores = getScores(technology, context);
+    const overallScore = calculateOverallScore(scores);
+    const grade = scoreToGrade(overallScore);
+    // Get strengths and weaknesses
+    const { strengths, weaknesses } = analyzeStrengthsWeaknesses(scores);
+    // Get compatible technologies
+    const compatible = findCompatibleTechs(technology);
+    // Build response
+    let text = `## ${tech.name} Analysis (context: ${context})
+
+**Category**: ${tech.category}
+**Overall Score**: ${overallScore}/100 (${grade})
+**URL**: ${tech.url}
+
+### Scores by Dimension
+| Dimension | Score | Grade |
+|-----------|-------|-------|
+`;
+    for (const dim of SCORE_DIMENSIONS) {
+        const score = scores[dim];
+        text += `| ${DIMENSION_LABELS[dim]} | ${score} | ${scoreToGrade(score)} |\n`;
+    }
+    // Strengths
+    if (strengths.length > 0) {
+        text += '\n### Strengths\n';
+        for (const s of strengths) {
+            text += `- **${s.dim}** (${s.score}/100)\n`;
+        }
+    }
+    // Weaknesses
+    if (weaknesses.length > 0) {
+        text += '\n### Weaknesses\n';
+        for (const w of weaknesses) {
+            text += `- ${w.dim} (${w.score}/100)\n`;
+        }
+    }
+    // Compatible technologies
+    if (compatible.length > 0) {
+        text += '\n### Compatible Technologies (top 8)\n';
+        const compatList = compatible.map((c) => `${c.id} (${c.score})`).join(', ');
+        text += `${compatList}\n`;
+    }
+    text += `\nData version: ${DATA_VERSION}`;
+    return { text };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/tools/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/tools/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACN,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAEhB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,aAAa,EACb,YAAY,EACZ,UAAU,EACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IAC/F,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC5F,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACxC,IAAI,EAAE,cAAc;IACpB,WAAW,EACV,gHAAgH;IACjH,WAAW,EAAE;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACX,UAAU,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACpE;YACD,OAAO,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC7D;SACD;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACxB;CACD,CAAC;AAEF;;GAEG;AACH,SAAS,0BAA0B,CAClC,MAAc;IAEd,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7C,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC;QAC1B,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;KAClB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAEtC,sCAAsC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAElE,yCAAyC;IACzC,MAAM,UAAU,GAAG,MAAM;SACvB,OAAO,EAAE;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEd,OAAO;QACN,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;KACnE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACzD,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IAElD,6BAA6B;IAC7B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,UAAU,CAAE,CAAC;IACxC,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,EAAE,OAAO,CAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAEzC,+BAA+B;IAC/B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAErE,8BAA8B;IAC9B,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEnD,iBAAiB;IACjB,IAAI,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,uBAAuB,OAAO;;gBAEzC,IAAI,CAAC,QAAQ;qBACR,YAAY,SAAS,KAAK;WACpC,IAAI,CAAC,GAAG;;;;;CAKlB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,gBAAgB,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;IAC9E,CAAC;IAED,YAAY;IACZ,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,IAAI,mBAAmB,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC3B,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK,SAAS,CAAC;QAC7C,CAAC;IACF,CAAC;IAED,aAAa;IACb,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,IAAI,oBAAoB,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,IAAI,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC;QACzC,CAAC;IACF,CAAC;IAED,0BAA0B;IAC1B,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,IAAI,yCAAyC,CAAC;QAClD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,IAAI,IAAI,GAAG,UAAU,IAAI,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,mBAAmB,YAAY,EAAE,CAAC;IAE1C,OAAO,EAAE,IAAI,EAAE,CAAC;AACjB,CAAC"}

package/dist/tools/api-keys.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+/**
+ * Input schema for setup_api_key tool.
+ */
+export declare const SetupApiKeyInputSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+    keyName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    password: string;
+    keyName?: string | undefined;
+}, {
+    email: string;
+    password: string;
+    keyName?: string | undefined;
+}>;
+export type SetupApiKeyInput = z.infer<typeof SetupApiKeyInputSchema>;
+/**
+ * Tool definition for setup_api_key.
+ */
+export declare const setupApiKeyToolDefinition: {
+    name: string;
+    description: string;
+};
+/**
+ * Execute setup_api_key tool.
+ */
+export declare function executeSetupApiKey(input: SetupApiKeyInput): Promise<{
+    text: string;
+    isError?: boolean;
+    apiKey?: string;
+}>;
+/**
+ * Input schema for list_api_keys tool.
+ */
+export declare const ListApiKeysInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type ListApiKeysInput = z.infer<typeof ListApiKeysInputSchema>;
+/**
+ * Tool definition for list_api_keys.
+ */
+export declare const listApiKeysToolDefinition: {
+    name: string;
+    description: string;
+};
+/**
+ * Execute list_api_keys tool.
+ */
+export declare function executeListApiKeys(): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+/**
+ * Input schema for revoke_api_key tool.
+ */
+export declare const RevokeApiKeyInputSchema: z.ZodObject<{
+    keyId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    keyId: string;
+}, {
+    keyId: string;
+}>;
+export type RevokeApiKeyInput = z.infer<typeof RevokeApiKeyInputSchema>;
+/**
+ * Tool definition for revoke_api_key.
+ */
+export declare const revokeApiKeyToolDefinition: {
+    name: string;
+    description: string;
+};
+/**
+ * Execute revoke_api_key tool.
+ */
+export declare function executeRevokeApiKey(input: RevokeApiKeyInput): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=api-keys.d.ts.map

package/dist/tools/api-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.d.ts","sourceRoot":"","sources":["../../src/tools/api-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;CAIrC,CAAC;AAcF;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,gBAAgB,GACrB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgF/D;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,gDAAe,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;CAGrC,CAAC;AAuBF;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAkEvF;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;CAGtC,CAAC;AAEF;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,iBAAiB,GACtB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAwD9C"}

package/dist/tools/api-keys.js

@@ -0,0 +1,238 @@
+import { z } from 'zod';
+import { getConfig } from '../utils/config.js';
+import { McpError } from '../utils/errors.js';
+import { debug, info } from '../utils/logger.js';
+/**
+ * Input schema for setup_api_key tool.
+ */
+export const SetupApiKeyInputSchema = z.object({
+    email: z.string().email().describe('Your StacksFinder account email'),
+    password: z.string().min(1).describe('Your StacksFinder account password'),
+    keyName: z.string().max(100).optional().describe('Optional name for the API key')
+});
+/**
+ * Tool definition for setup_api_key.
+ */
+export const setupApiKeyToolDefinition = {
+    name: 'setup_api_key',
+    description: 'Authenticates with your StacksFinder account and creates an API key. Requires Pro or Team tier. The key is returned once and should be saved securely.'
+};
+/**
+ * Execute setup_api_key tool.
+ */
+export async function executeSetupApiKey(input) {
+    const config = getConfig();
+    const { email, password, keyName } = input;
+    debug('Setting up API key for', email);
+    try {
+        const response = await fetch(`${config.apiUrl}/api/v1/mcp/setup`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                email,
+                password,
+                keyName: keyName || 'MCP Auto-generated'
+            })
+        });
+        const data = (await response.json());
+        if (!response.ok || !data.success) {
+            let errorMessage = data.message || data.error || 'Failed to create API key';
+            // Add helpful context for common errors
+            if (data.error === 'TIER_REQUIRED') {
+                errorMessage = `Pro or Team tier required. Upgrade at ${config.apiUrl}/pricing`;
+            }
+            else if (data.error === 'LIMIT_EXCEEDED') {
+                errorMessage = `API key limit reached. Manage keys at ${config.apiUrl}/account/developer/api-keys`;
+            }
+            else if (data.error === 'INVALID_CREDENTIALS') {
+                errorMessage = 'Invalid email or password. Please check your credentials.';
+            }
+            return {
+                text: `**Error**: ${errorMessage}`,
+                isError: true
+            };
+        }
+        info('API key created successfully');
+        // Return the key with instructions
+        const text = `## API Key Created Successfully
+
+**Key**: \`${data.apiKey}\`
+**Key ID**: ${data.keyId}
+**Prefix**: ${data.prefix}
+
+**IMPORTANT**: Save this key now - it cannot be retrieved again!
+
+### Configure in Claude Code
+
+Run this command to add the key:
+
+\`\`\`bash
+claude mcp add-json stacksfinder '{"command": "npx", "args": ["-y", "@stacksfinder/mcp-server"], "env": {"STACKSFINDER_API_KEY": "${data.apiKey}"}}'
+\`\`\`
+
+Or set the environment variable:
+
+\`\`\`bash
+export STACKSFINDER_API_KEY="${data.apiKey}"
+\`\`\`
+
+### Manage Your Keys
+
+View and manage keys at: ${config.apiUrl}/account/developer/api-keys`;
+        return { text, apiKey: data.apiKey };
+    }
+    catch (err) {
+        if (err instanceof McpError) {
+            return { text: err.toResponseText(), isError: true };
+        }
+        const errorMessage = err instanceof Error ? err.message : 'Failed to setup API key';
+        return {
+            text: `**Error**: ${errorMessage}\n\nMake sure you can reach ${config.apiUrl}`,
+            isError: true
+        };
+    }
+}
+/**
+ * Input schema for list_api_keys tool.
+ */
+export const ListApiKeysInputSchema = z.object({});
+/**
+ * Tool definition for list_api_keys.
+ */
+export const listApiKeysToolDefinition = {
+    name: 'list_api_keys',
+    description: 'Lists your StacksFinder API keys. Requires a configured API key.'
+};
+/**
+ * Execute list_api_keys tool.
+ */
+export async function executeListApiKeys() {
+    const config = getConfig();
+    if (!config.apiKey) {
+        return {
+            text: `**Error**: No API key configured. Use \`setup_api_key\` tool first or set STACKSFINDER_API_KEY environment variable.`,
+            isError: true
+        };
+    }
+    debug('Listing API keys');
+    try {
+        const response = await fetch(`${config.apiUrl}/api/v1/keys`, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return {
+                    text: '**Error**: Invalid API key. Please reconfigure with a valid key.',
+                    isError: true
+                };
+            }
+            const errorText = await response.text();
+            return {
+                text: `**Error**: Failed to list keys (${response.status}): ${errorText}`,
+                isError: true
+            };
+        }
+        const data = (await response.json());
+        let text = `## Your API Keys
+
+**Usage**: ${data.limits.used}/${data.limits.max} keys (${data.limits.remaining} remaining)
+
+| Name | Prefix | Scopes | Created | Last Used |
+|------|--------|--------|---------|-----------|
+`;
+        for (const key of data.keys) {
+            const lastUsed = key.lastUsedAt ? new Date(key.lastUsedAt).toLocaleDateString() : 'Never';
+            const created = new Date(key.createdAt).toLocaleDateString();
+            const scopes = key.scopes.join(', ');
+            text += `| ${key.name} | ${key.prefix}...${key.suffix} | ${scopes} | ${created} | ${lastUsed} |\n`;
+        }
+        if (data.keys.length === 0) {
+            text += `| (no keys) | - | - | - | - |\n`;
+        }
+        text += `\nManage keys at: ${config.apiUrl}/account/developer/api-keys`;
+        return { text };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : 'Failed to list API keys';
+        return {
+            text: `**Error**: ${errorMessage}`,
+            isError: true
+        };
+    }
+}
+/**
+ * Input schema for revoke_api_key tool.
+ */
+export const RevokeApiKeyInputSchema = z.object({
+    keyId: z.string().uuid().describe('The UUID of the API key to revoke')
+});
+/**
+ * Tool definition for revoke_api_key.
+ */
+export const revokeApiKeyToolDefinition = {
+    name: 'revoke_api_key',
+    description: 'Revokes an API key. This action cannot be undone.'
+};
+/**
+ * Execute revoke_api_key tool.
+ */
+export async function executeRevokeApiKey(input) {
+    const config = getConfig();
+    const { keyId } = input;
+    if (!config.apiKey) {
+        return {
+            text: `**Error**: No API key configured. Set STACKSFINDER_API_KEY environment variable.`,
+            isError: true
+        };
+    }
+    debug('Revoking API key', keyId);
+    try {
+        const response = await fetch(`${config.apiUrl}/api/v1/keys/${keyId}`, {
+            method: 'DELETE',
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                'Content-Type': 'application/json'
+            }
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return {
+                    text: '**Error**: Invalid API key. Please reconfigure with a valid key.',
+                    isError: true
+                };
+            }
+            if (response.status === 404) {
+                return {
+                    text: `**Error**: API key not found or already revoked.`,
+                    isError: true
+                };
+            }
+            const errorText = await response.text();
+            return {
+                text: `**Error**: Failed to revoke key (${response.status}): ${errorText}`,
+                isError: true
+            };
+        }
+        return {
+            text: `## API Key Revoked
+
+The API key \`${keyId}\` has been revoked and can no longer be used.
+
+**Note**: If you revoked the key you're currently using, you'll need to configure a new one.`
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : 'Failed to revoke API key';
+        return {
+            text: `**Error**: ${errorMessage}`,
+            isError: true
+        };
+    }
+}
+//# sourceMappingURL=api-keys.js.map

package/dist/tools/api-keys.js.map

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

package/dist/tools/blueprint.d.ts

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+/**
+ * Input schema for get_blueprint tool.
+ */
+export declare const GetBlueprintInputSchema: z.ZodObject<{
+    blueprintId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    blueprintId: string;
+}, {
+    blueprintId: string;
+}>;
+export type GetBlueprintInput = z.infer<typeof GetBlueprintInputSchema>;
+/**
+ * Tool definition for MCP registration.
+ */
+export declare const getBlueprintToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            blueprintId: {
+                type: string;
+                format: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Execute get_blueprint tool.
+ */
+export declare function executeGetBlueprint(input: GetBlueprintInput): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+/**
+ * Input schema for create_blueprint tool.
+ */
+export declare const CreateBlueprintInputSchema: z.ZodObject<{
+    projectName: z.ZodOptional<z.ZodString>;
+    projectType: z.ZodEnum<["web-app", "mobile-app", "api", "desktop", "cli", "library", "e-commerce", "saas", "marketplace"]>;
+    scale: z.ZodEnum<["mvp", "startup", "growth", "enterprise"]>;
+    projectDescription: z.ZodOptional<z.ZodString>;
+    priorities: z.ZodOptional<z.ZodArray<z.ZodEnum<["time-to-market", "scalability", "developer-experience", "cost-efficiency", "performance", "security", "maintainability"]>, "many">>;
+    constraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    waitForCompletion: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    projectType: "web-app" | "mobile-app" | "api" | "desktop" | "cli" | "library" | "e-commerce" | "saas" | "marketplace";
+    scale: "mvp" | "enterprise" | "startup" | "growth";
+    waitForCompletion: boolean;
+    priorities?: ("time-to-market" | "scalability" | "developer-experience" | "cost-efficiency" | "performance" | "security" | "maintainability")[] | undefined;
+    constraints?: string[] | undefined;
+    projectName?: string | undefined;
+    projectDescription?: string | undefined;
+}, {
+    projectType: "web-app" | "mobile-app" | "api" | "desktop" | "cli" | "library" | "e-commerce" | "saas" | "marketplace";
+    scale: "mvp" | "enterprise" | "startup" | "growth";
+    priorities?: ("time-to-market" | "scalability" | "developer-experience" | "cost-efficiency" | "performance" | "security" | "maintainability")[] | undefined;
+    constraints?: string[] | undefined;
+    projectName?: string | undefined;
+    projectDescription?: string | undefined;
+    waitForCompletion?: boolean | undefined;
+}>;
+export type CreateBlueprintInput = z.infer<typeof CreateBlueprintInputSchema>;
+/**
+ * Tool definition for MCP registration.
+ */
+export declare const createBlueprintToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectName: {
+                type: string;
+                description: string;
+                maxLength: number;
+            };
+            projectType: {
+                type: string;
+                enum: readonly ["web-app", "mobile-app", "api", "desktop", "cli", "library", "e-commerce", "saas", "marketplace"];
+                description: string;
+            };
+            scale: {
+                type: string;
+                enum: readonly ["mvp", "startup", "growth", "enterprise"];
+                description: string;
+            };
+            projectDescription: {
+                type: string;
+                description: string;
+                maxLength: number;
+            };
+            priorities: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: readonly ["time-to-market", "scalability", "developer-experience", "cost-efficiency", "performance", "security", "maintainability"];
+                };
+                maxItems: number;
+                description: string;
+            };
+            constraints: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            waitForCompletion: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Execute create_blueprint tool.
+ */
+export declare function executeCreateBlueprint(input: CreateBlueprintInput): Promise<{
+    text: string;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=blueprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../src/tools/blueprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;CAetC,CAAC;AA4DF;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,iBAAiB,GACtB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA2B9C;AAuCD;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;EA0BrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDzC,CAAC;AAmCF;;GAEG;AACH,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA6G9C"}