@spekoai/mcp 1.0.0

package/dist/tools/recommend.js

@@ -0,0 +1,163 @@
+import * as z from "zod";
+import { BENCHMARK_DATA, S2S_OPTIONS } from "../data/benchmarks.js";
+import { clampMaxResults, formatToolResponse, getLanguageSuggestions, getObjectiveWeights, rankBenchmarks, resolveLanguage, resolveUseCase, } from "../lib/benchmark-utils.js";
+function rankS2SOptions(entries, weights) {
+    return entries
+        .map((entry) => {
+        const latencyScore = Math.max(0, 100 - (entry.latencyMs - 90) * 0.7);
+        const qualityScore = (entry.quality / 5) * 100;
+        const costScore = Math.max(0, 100 - entry.costPerHour * 35);
+        const weighted = (latencyScore * weights.latency + qualityScore * weights.quality + costScore * weights.cost) /
+            (weights.latency + weights.quality + weights.cost);
+        return {
+            ...entry,
+            score: Math.round(weighted * 10) / 10,
+        };
+    })
+        .sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        if (a.latencyMs !== b.latencyMs)
+            return a.latencyMs - b.latencyMs;
+        if (b.quality !== a.quality)
+            return b.quality - a.quality;
+        return a.costPerHour - b.costPerHour;
+    });
+}
+function isLanguageSupported(targetLanguage, optionLanguages) {
+    return optionLanguages.some((language) => language.toLowerCase() === targetLanguage.toLowerCase());
+}
+export function registerRecommendTool(server) {
+    server.registerTool("speko_recommend", {
+        description: "Recommend Speko runtime options with S2S (OpenAI Realtime, Gemini Live) and cascaded STT+LLM+TTS stacks, including trade-offs and cost breakdown.",
+        inputSchema: z.object({
+            language: z.string().describe("Target language, e.g. English, Thai"),
+            use_case: z.string().describe("Use case, e.g. customer-support, sales, scheduling"),
+            optimize_for: z
+                .enum(["balanced", "latency", "quality", "cost"])
+                .default("balanced")
+                .describe("Optimization objective"),
+            max_results: z.number().default(3).describe("Rows to return per mode"),
+            output_format: z
+                .enum(["markdown", "json"])
+                .default("markdown")
+                .describe("Set to json for machine-readable output"),
+        }),
+    }, async ({ language, use_case, optimize_for, max_results, output_format }) => {
+        const format = output_format;
+        const resolvedLanguage = resolveLanguage(language);
+        const resolvedUseCase = resolveUseCase(use_case);
+        if (!resolvedLanguage) {
+            const suggestions = getLanguageSuggestions(language);
+            return formatToolResponse(format, `Language "${language}" is not recognized. Try one of: ${suggestions.join(", ")}.`, {
+                status: "error",
+                reason: "unsupported-language",
+                requested_language: language,
+                suggestions,
+            });
+        }
+        const resultLimit = clampMaxResults(max_results);
+        const weights = getObjectiveWeights(optimize_for, resolvedUseCase);
+        const cascadedMatches = BENCHMARK_DATA.filter((entry) => entry.languages.some((entryLanguage) => entryLanguage.toLowerCase() === resolvedLanguage.toLowerCase()));
+        const rankedCascaded = rankBenchmarks(cascadedMatches, weights).slice(0, resultLimit);
+        const s2sMatches = S2S_OPTIONS.filter((option) => isLanguageSupported(resolvedLanguage, option.languages));
+        const rankedS2S = rankS2SOptions(s2sMatches, weights).slice(0, resultLimit);
+        if (rankedCascaded.length === 0 && rankedS2S.length === 0) {
+            return formatToolResponse(format, `No recommendation data available for ${resolvedLanguage}.`, {
+                status: "error",
+                reason: "no-matches",
+                language: resolvedLanguage,
+            });
+        }
+        const topS2S = rankedS2S[0];
+        const topCascaded = rankedCascaded[0];
+        const isEnglish = resolvedLanguage.toLowerCase() === "english";
+        const modeRecommendation = !topCascaded
+            ? "s2s"
+            : !topS2S
+                ? "cascaded"
+                : optimize_for === "cost"
+                    ? "cascaded"
+                    : isEnglish
+                        ? topS2S.score >= topCascaded.score
+                            ? "s2s"
+                            : "cascaded"
+                        : "cascaded";
+        const recommendationReason = modeRecommendation === "s2s"
+            ? "S2S gives lower end-to-end latency for this target profile and keeps Speko out of the audio path."
+            : optimize_for === "cost"
+                ? "Cascaded pipelines are cheaper per minute and are preferred for cost optimization."
+                : !isEnglish
+                    ? "Cascaded pipelines are preferred for non-English coverage and routing flexibility."
+                    : "Cascaded stack scores higher for your requested optimization profile.";
+        const lines = [
+            "## Speko Recommendation",
+            `**Language:** ${resolvedLanguage} | **Use case:** ${resolvedUseCase} | **Optimize:** ${optimize_for}`,
+            `**Recommended mode:** ${modeRecommendation.toUpperCase()}`,
+            `- ${recommendationReason}`,
+            "",
+            "### S2S Options",
+            "| Rank | Provider | Model | Latency | Quality | Cost/hour | Score |",
+            "|------|----------|-------|---------|---------|-----------|-------|",
+        ];
+        if (rankedS2S.length === 0) {
+            lines.push("| - | - | - | - | - | - | - |");
+        }
+        else {
+            rankedS2S.forEach((entry, index) => {
+                lines.push(`| ${index + 1} | ${entry.provider} | ${entry.model} | ${entry.latencyMs}ms | ${entry.quality}/5 | $${entry.costPerHour.toFixed(2)} | ${entry.score} |`);
+            });
+        }
+        lines.push("", "### Cascaded Options", "| Rank | STT | LLM | TTS | Latency | Quality | Cost/min | Cost/hour | Score |", "|------|-----|-----|-----|---------|---------|----------|-----------|-------|");
+        if (rankedCascaded.length === 0) {
+            lines.push("| - | - | - | - | - | - | - | - | - |");
+        }
+        else {
+            rankedCascaded.forEach((entry, index) => {
+                lines.push(`| ${index + 1} | ${entry.stt} ${entry.sttModel} | ${entry.llm} ${entry.llmModel} | ${entry.tts} ${entry.ttsModel} | ${entry.latencyMs}ms | ${entry.quality}/5 | $${entry.costPerMin.toFixed(3)} | $${(entry.costPerMin * 60).toFixed(2)} | ${entry.score} |`);
+            });
+        }
+        lines.push("", "### S2S vs Cascaded Trade-offs", "- S2S: direct provider WebSocket, lowest latency, simpler path, billed as provider runtime ($/hour).", "- Cascaded: Speko edge orchestration, better multilingual control and failover, billed per-minute stack cost.");
+        if (topS2S) {
+            lines.push(`- Top S2S note: ${topS2S.notes}`);
+        }
+        if (topCascaded?.notes) {
+            lines.push(`- Top cascaded note: ${topCascaded.notes}`);
+        }
+        return formatToolResponse(format, lines.join("\n"), {
+            status: "ok",
+            language: resolvedLanguage,
+            use_case: resolvedUseCase,
+            optimize_for,
+            recommendation: {
+                mode: modeRecommendation,
+                reason: recommendationReason,
+            },
+            s2s_options: rankedS2S,
+            cascaded_options: rankedCascaded,
+            top_pick: modeRecommendation === "s2s"
+                ? {
+                    mode: "s2s",
+                    provider: topS2S?.provider,
+                    model: topS2S?.model,
+                    latency_ms: topS2S?.latencyMs,
+                    quality: topS2S?.quality,
+                    cost_per_hour: topS2S?.costPerHour,
+                }
+                : {
+                    mode: "cascaded",
+                    stt: topCascaded?.stt,
+                    stt_model: topCascaded?.sttModel,
+                    llm: topCascaded?.llm,
+                    llm_model: topCascaded?.llmModel,
+                    tts: topCascaded?.tts,
+                    tts_model: topCascaded?.ttsModel,
+                    latency_ms: topCascaded?.latencyMs,
+                    quality: topCascaded?.quality,
+                    cost_per_min: topCascaded?.costPerMin,
+                    cost_per_hour: topCascaded ? Number((topCascaded.costPerMin * 60).toFixed(2)) : undefined,
+                },
+        });
+    });
+}
+//# sourceMappingURL=recommend.js.map

package/dist/tools/recommend.js.map

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

package/dist/tools/setup.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSetupTool(server: McpServer): void;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiDpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6EzD"}

package/dist/tools/setup.js

@@ -0,0 +1,104 @@
+import * as z from "zod";
+import { getSpekoComponentTemplate } from "../data/templates.js";
+import { SpekoApiClient } from "../lib/api-client.js";
+import { hasSpekoApiKey, tier2GateResponse } from "../lib/tier-gate.js";
+const DEFAULT_SYSTEM_PROMPTS = {
+    "customer-support": "You are a customer support voice agent. Resolve issues quickly, verify user context, and keep responses concise.",
+    sales: "You are a sales voice agent. Qualify leads, ask discovery questions, and guide users to a clear next action.",
+    scheduling: "You are a scheduling voice agent. Collect availability, confirm timezone, and book meetings with minimal friction.",
+};
+function sanitizeTextForPrompt(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function defaultSystemPrompt(type, context) {
+    const cleanContext = sanitizeTextForPrompt(context);
+    if (type === "custom") {
+        return `You are a voice agent for this context: ${cleanContext}. Be accurate, concise, and helpful.`;
+    }
+    return `${DEFAULT_SYSTEM_PROMPTS[type]} Context: ${cleanContext}`;
+}
+function defaultTargetFile(framework) {
+    if (framework === "nextjs")
+        return "src/app/page.tsx";
+    if (framework === "react")
+        return "src/App.tsx";
+    return "src/main.ts";
+}
+function buildAgentName(type, context) {
+    const shortContext = sanitizeTextForPrompt(context)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 36);
+    const prefix = type === "custom" ? "custom" : type;
+    return `${prefix}-${shortContext || "voice-agent"}`;
+}
+export function registerSetupTool(server) {
+    server.registerTool("speko_setup", {
+        description: "Set up Speko in Next.js/React/vanilla projects: install SDK, create agent, and generate the voice agent component snippet.",
+        inputSchema: z.object({
+            framework: z.enum(["nextjs", "react", "vanilla"]),
+            type: z.enum(["customer-support", "sales", "scheduling", "custom"]),
+            context: z.string().min(1).describe("What the agent should know about your business/product"),
+            systemPrompt: z.string().optional().describe("Optional override for the default system prompt"),
+            targetFile: z.string().optional().describe("Target file where the VoiceAgent snippet should be added"),
+            language: z.string().default("auto").describe("Agent language hint, default auto"),
+            priority: z.enum(["speed", "quality", "cost"]).default("quality"),
+        }),
+    }, async ({ framework, type, context, systemPrompt, targetFile, language, priority }) => {
+        if (!hasSpekoApiKey())
+            return tier2GateResponse();
+        const resolvedPrompt = sanitizeTextForPrompt(systemPrompt ?? defaultSystemPrompt(type, context));
+        const resolvedTargetFile = targetFile ?? defaultTargetFile(framework);
+        const api = new SpekoApiClient();
+        const createResult = await api.createAgent({
+            name: buildAgentName(type, context),
+            context,
+            systemPrompt: resolvedPrompt,
+            language,
+            priority: priority,
+        });
+        const componentCode = getSpekoComponentTemplate({
+            framework: framework,
+            agentId: createResult.data.id,
+            language,
+            priority: priority,
+            context,
+            systemPrompt: resolvedPrompt,
+        });
+        const response = {
+            status: "ok",
+            framework,
+            type,
+            agentId: createResult.data.id,
+            dashboardUrl: api.getDashboardUrl(createResult.data.id),
+            installCommand: "npm install @speko/js",
+            env: {
+                file: framework === "nextjs" ? ".env.local" : ".env",
+                snippet: framework === "react"
+                    ? "VITE_SPEKO_KEY=sk_your_api_key"
+                    : framework === "vanilla"
+                        ? "SPEKO_KEY=sk_your_api_key"
+                        : "NEXT_PUBLIC_SPEKO_KEY=sk_your_api_key",
+            },
+            targetFile: resolvedTargetFile,
+            componentCode,
+            api: createResult.meta,
+            nextSteps: [
+                "Run the install command.",
+                `Add the env variable to ${framework === "nextjs" ? ".env.local" : ".env"}.`,
+                `Paste the component code into ${resolvedTargetFile}.`,
+                "Run your app and verify the widget can start a session.",
+            ],
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/tools/setup.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@spekoai/mcp",
+  "version": "1.0.0",
+  "description": "MCP server for voice AI development \u2014 recommend, benchmark, and scaffold STT+LLM+TTS stacks with Speko",
+  "author": "Beknazar Abdikamalov <bek@speko.ai>",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "speko-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "lint": "echo 'No lint configured for @speko/mcp'",
+    "test": "bun run build && bun run vitest run",
+    "test:unit": "vitest run tests/*.test.ts",
+    "test:e2e": "bun run build && bun run vitest run tests/mcp-e2e.test.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "mcp",
+    "voice-ai",
+    "stt",
+    "tts",
+    "llm",
+    "elevenlabs",
+    "deepgram",
+    "cartesia",
+    "livekit",
+    "speko",
+    "claude-code",
+    "voice-agents"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/spekoAI/speko-mcp"
+  }
+}