ai-model-advisor-mcp 2.2.2 → 2.3.0

package/README.md

@@ -44,7 +44,22 @@ The server works **entirely out-of-the-box**. Just add it to your MCP settings a
 
 That's it! Live pricing for **all 1,000+ models** across all 5 providers is fetched automatically using our hosted Cloudflare Worker Pricing API. No API keys, no environment variables, no setup.
 
-## Tools (8 total)
+## Tools (9 total)
+
+### 🧭 `select_model_for_project` ⭐ NEW
+
+One call for agents that already have project context. Returns the best overall model, cheapest acceptable model, and best value option without forcing the agent to manually chain several tools.
+
+```
+select_model_for_project({
+  project: "TypeScript MCP server for coding agents",
+  task: "coding assistant",
+  requirements: ["coding", "reasoning", "tool_use"],
+  expected_usage: { input_tokens: 5000000, output_tokens: 1000000 }
+})
+```
+
+The server searches the catalog behind the scenes and returns a compact decision with model IDs, provider, price, quality tier, reasons, tradeoffs, and structured output that agents can parse.
 
 ### 🏷️ `find_cheapest_provider` ⭐ NEW
 
@@ -175,7 +190,7 @@ Agent → MCP Server → Cloudflare Worker Pricing API (Our Hosted Backend)
                          └─ Fetches from Fireworks AI (12+ models)
 
 Unified Model Registry
-→ recommend, compare, list, info, estimate, shop, batch
+→ select, recommend, compare, list, info, estimate, shop, batch
 ```
 
 The MCP Server connects to our blazing-fast Cloudflare Worker that aggregates live pricing data across all 5 providers on a recurring 6-hour cron schedule. This gives your agent real-time pricing awareness without requiring you to juggle 5 different API keys.

package/build/server.d.ts

@@ -1,5 +1,83 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 export declare const TOOL_DEFINITIONS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project: {
+                type: string;
+                description: string;
+            };
+            task: {
+                type: string;
+                description: string;
+            };
+            requirements: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            budget: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            optimization_goal: {
+                type: string;
+                description: string;
+                enum: string[];
+            };
+            expected_usage: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            model_ids?: undefined;
+            category?: undefined;
+            provider?: undefined;
+            capability?: undefined;
+            max_price?: undefined;
+            model_id?: undefined;
+            usage?: undefined;
+            since?: undefined;
+            model?: undefined;
+        };
+        required?: undefined;
+    };
+    outputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+            };
+            best_overall: {
+                type: string;
+            };
+            cheapest_acceptable: {
+                type: string;
+            };
+            best_value: {
+                type: string;
+            };
+            candidates: {
+                type: string;
+                items: {
+                    type: string;
+                };
+            };
+            cost_basis: {
+                type: string;
+            };
+        };
+        required: string[];
+    };
+} | {
     name: string;
     description: string;
     inputSchema: {
@@ -25,6 +103,9 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            project?: undefined;
+            optimization_goal?: undefined;
+            expected_usage?: undefined;
             model_ids?: undefined;
             category?: undefined;
             provider?: undefined;
@@ -37,6 +118,7 @@ export declare const TOOL_DEFINITIONS: ({
         };
         required: string[];
     };
+    outputSchema?: undefined;
 } | {
     name: string;
     description: string;
@@ -50,9 +132,12 @@ export declare const TOOL_DEFINITIONS: ({
                 };
                 description: string;
             };
+            project?: undefined;
             task?: undefined;
             requirements?: undefined;
             budget?: undefined;
+            optimization_goal?: undefined;
+            expected_usage?: undefined;
             limit?: undefined;
             category?: undefined;
             provider?: undefined;
@@ -65,6 +150,7 @@ export declare const TOOL_DEFINITIONS: ({
         };
         required: string[];
     };
+    outputSchema?: undefined;
 } | {
     name: string;
     description: string;
@@ -92,9 +178,12 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            project?: undefined;
             task?: undefined;
             requirements?: undefined;
             budget?: undefined;
+            optimization_goal?: undefined;
+            expected_usage?: undefined;
             model_ids?: undefined;
             model_id?: undefined;
             usage?: undefined;
@@ -103,6 +192,7 @@ export declare const TOOL_DEFINITIONS: ({
         };
         required?: undefined;
     };
+    outputSchema?: undefined;
 } | {
     name: string;
     description: string;
@@ -113,9 +203,12 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            project?: undefined;
             task?: undefined;
             requirements?: undefined;
             budget?: undefined;
+            optimization_goal?: undefined;
+            expected_usage?: undefined;
             limit?: undefined;
             model_ids?: undefined;
             category?: undefined;
@@ -128,6 +221,7 @@ export declare const TOOL_DEFINITIONS: ({
         };
         required: string[];
     };
+    outputSchema?: undefined;
 } | {
     name: string;
     description: string;
@@ -142,9 +236,12 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            project?: undefined;
             task?: undefined;
             requirements?: undefined;
             budget?: undefined;
+            optimization_goal?: undefined;
+            expected_usage?: undefined;
             limit?: undefined;
             model_ids?: undefined;
             category?: undefined;
@@ -156,6 +253,7 @@ export declare const TOOL_DEFINITIONS: ({
         };
         required: string[];
     };
+    outputSchema?: undefined;
 } | {
     name: string;
     description: string;
@@ -174,9 +272,12 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            project?: undefined;
             task?: undefined;
             requirements?: undefined;
             budget?: undefined;
+            optimization_goal?: undefined;
+            expected_usage?: undefined;
             model_ids?: undefined;
             provider?: undefined;
             capability?: undefined;
@@ -187,6 +288,7 @@ export declare const TOOL_DEFINITIONS: ({
         };
         required?: undefined;
     };
+    outputSchema?: undefined;
 } | {
     name: string;
     description: string;
@@ -197,9 +299,12 @@ export declare const TOOL_DEFINITIONS: ({
                 type: string;
                 description: string;
             };
+            project?: undefined;
             task?: undefined;
             requirements?: undefined;
             budget?: undefined;
+            optimization_goal?: undefined;
+            expected_usage?: undefined;
             limit?: undefined;
             model_ids?: undefined;
             category?: undefined;
@@ -212,6 +317,7 @@ export declare const TOOL_DEFINITIONS: ({
         };
         required: string[];
     };
+    outputSchema?: undefined;
 })[];
 export declare function createServer(): Server;
 //# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAkBnE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8K5B,CAAC;AAmBF,wBAAgB,YAAY,IAAI,MAAM,CAqBrC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAmBnE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwO5B,CAAC;AAoBF,wBAAgB,YAAY,IAAI,MAAM,CAqBrC"}

package/build/server.js

@@ -9,8 +9,61 @@ import { handleEstimateCost } from "./tools/estimate.js";
 import { handleWhatsNew } from "./tools/discover.js";
 import { handleFindCheapestProvider } from "./tools/shop.js";
 import { handleBatchGetPricing } from "./tools/batch.js";
+import { handleSelectModelForProject } from "./tools/select.js";
 // ─── Tool Definitions ───────────────────────────────────────────────────────
 export const TOOL_DEFINITIONS = [
+    {
+        name: "select_model_for_project",
+        description: "Pick the best overall, cheapest acceptable, and best value AI model for a project. Use this when an agent has project context and needs one decision instead of manually chaining recommend, compare, pricing, and cost tools. Returns concise markdown plus structured fields with candidates, scores, reasons, pricing, and tradeoffs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: {
+                    type: "string",
+                    description: 'Project or repository context. Example: "TypeScript MCP server that needs a coding/reasoning model for agent workflows"',
+                },
+                task: {
+                    type: "string",
+                    description: 'Optional specific task. Examples: "coding assistant", "image generation", "video generation", "transcription"',
+                },
+                requirements: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: 'Optional requirements. Examples: ["coding", "reasoning", "tool_use", "vision", "fast", "long_context"]',
+                },
+                budget: {
+                    type: "string",
+                    description: 'Optional budget constraint: "free", "low", or omit for any price',
+                    enum: ["free", "low", "any"],
+                },
+                optimization_goal: {
+                    type: "string",
+                    description: 'Optional ranking goal for the candidate list: "balanced" (default), "best", or "cheapest"',
+                    enum: ["balanced", "best", "cheapest"],
+                },
+                expected_usage: {
+                    type: "object",
+                    description: "Optional usage estimate for cost-aware ranking. LLMs: {input_tokens, output_tokens, requests}. Media: {images, seconds, units, requests}",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max candidate rows to return (default: 5, max: 20)",
+                },
+            },
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "object" },
+                best_overall: { type: "object" },
+                cheapest_acceptable: { type: "object" },
+                best_value: { type: "object" },
+                candidates: { type: "array", items: { type: "object" } },
+                cost_basis: { type: "string" },
+            },
+            required: ["query", "candidates"],
+        },
+    },
     {
         name: "recommend_model",
         description: "Recommend the best AI model for a task. Searches across 1000+ models spanning LLMs, image gen, video gen, TTS, STT, 3D, and more from 5 providers (OpenRouter, fal.ai, Together AI, Replicate, Fireworks). Returns ranked results based on task match, capabilities, quality tier, price, speed (TTFT/throughput), and intelligence benchmarks (MMLU/coding).",
@@ -168,6 +221,7 @@ export const TOOL_DEFINITIONS = [
     },
 ];
 const HANDLER_MAP = {
+    select_model_for_project: handleSelectModelForProject,
     recommend_model: handleRecommendModel,
     compare_models: handleCompareModels,
     list_models: handleListModels,

package/build/server.js.map

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

package/build/tools/select.d.ts

@@ -0,0 +1,113 @@
+import type { ModelCategory, UnifiedModel } from "../types.js";
+type SelectionGoal = "balanced" | "best" | "cheapest";
+type Budget = "any" | "free" | "low";
+interface UsageEstimate {
+    input_tokens?: number;
+    prompt_tokens?: number;
+    output_tokens?: number;
+    completion_tokens?: number;
+    requests?: number;
+    units?: number;
+    images?: number;
+    seconds?: number;
+}
+export declare function handleSelectModelForProject(models: UnifiedModel[], args: Record<string, unknown>): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+    structuredContent?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        query: {
+            project: string;
+            task: string;
+            requirements: string[];
+            budget: Budget;
+            optimization_goal: SelectionGoal;
+        };
+        candidates: never[];
+    };
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        query: {
+            project: string;
+            task: string;
+            requirements: string[];
+            budget: Budget;
+            optimization_goal: SelectionGoal;
+            inferred_categories: ModelCategory[];
+            expected_usage: UsageEstimate;
+        };
+        best_overall: {
+            id: string;
+            name: string;
+            provider: import("../types.js").ProviderName;
+            category: ModelCategory;
+            qualityTier: import("../types.js").QualityTier | null;
+            pricing: string;
+            comparisonPrice: number | null;
+            estimatedCost: number | null;
+            score: number;
+            valueScore: number;
+            reasons: string[];
+            tradeoffs: string[];
+        };
+        cheapest_acceptable: {
+            id: string;
+            name: string;
+            provider: import("../types.js").ProviderName;
+            category: ModelCategory;
+            qualityTier: import("../types.js").QualityTier | null;
+            pricing: string;
+            comparisonPrice: number | null;
+            estimatedCost: number | null;
+            score: number;
+            valueScore: number;
+            reasons: string[];
+            tradeoffs: string[];
+        };
+        best_value: {
+            id: string;
+            name: string;
+            provider: import("../types.js").ProviderName;
+            category: ModelCategory;
+            qualityTier: import("../types.js").QualityTier | null;
+            pricing: string;
+            comparisonPrice: number | null;
+            estimatedCost: number | null;
+            score: number;
+            valueScore: number;
+            reasons: string[];
+            tradeoffs: string[];
+        };
+        candidates: {
+            id: string;
+            name: string;
+            provider: import("../types.js").ProviderName;
+            category: ModelCategory;
+            qualityTier: import("../types.js").QualityTier | null;
+            pricing: string;
+            comparisonPrice: number | null;
+            estimatedCost: number | null;
+            score: number;
+            valueScore: number;
+            reasons: string[];
+            tradeoffs: string[];
+        }[];
+        cost_basis: string;
+    };
+    isError?: undefined;
+};
+export {};
+//# sourceMappingURL=select.d.ts.map

package/build/tools/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/tools/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,KAAK,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AACtD,KAAK,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAErC,UAAU,aAAa;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuTD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,YAAY,EAAE,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwG9B"}