@index9/mcp 1.0.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Index9
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# @index9/mcp
+
+[![npm version](https://badge.fury.io/js/%40index9%2Fmcp.svg)](https://badge.fury.io/js/%40index9%2Fmcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Give your AI assistant up-to-date model knowledge. 1000+ models with real-time pricing, context windows, and capabilities. Latest data, instant responses, zero cost.
+
+## ❌ Without Index9 MCP
+
+LLMs rely on outdated training data about AI models:
+
+- ❌ "Use GPT-4 for complex reasoning" (missing GPT-5.1, Claude Opus 4.5, and latest models)
+- ❌ "This fits in GPT-3.5's 4K context" (current models have 128K-2M+ context windows)
+- ❌ Generic advice without real pricing or capability comparisons
+- ❌ No awareness of cutting-edge models released this month
+
+## ✅ With Index9 MCP
+
+Your AI assistant has real-time access to the latest models and provides specific, data-driven recommendations:
+
+- ✅ "Use **GPT-5.1** - 400K context, $1.25/million input, latest frontier-grade reasoning with adaptive computation"
+- ✅ "For massive documents, try **Grok 4.1 Fast** with 2M context at $0.2/million input tokens"
+- ✅ "Vision + reasoning needed? Use **Claude Opus 4.5** at $5/million - multimodal with 200K context"
+- ✅ "Budget option: **Arcee Trinity Mini** at $0.04/million for text-only tasks"
+- ✅ Compare the latest models side-by-side with current pricing, test live performance, and get cutting-edge recommendations
+
+> *🤖 This section was written using Index9 MCP data - the AI assistant knew about Arcee Trinity Mini before it was cool!*
+
+## Quick Start
+
+### Cursor
+
+Open Cursor Settings → MCP → Add new global MCP server
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+### VS Code
+
+Open VS Code Settings → MCP Servers → Add Server
+
+```json
+"mcp": {
+  "servers": {
+    "index9": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+### Other MCP Clients
+
+#### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+#### Claude Code
+
+Run in terminal:
+
+```bash
+claude mcp add index9 -- npx -y @index9/mcp
+```
+
+#### Windsurf
+
+Add to Windsurf MCP config file
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+#### Cline
+
+Open Cline → MCP Servers → Edit Configuration
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+## Configuration
+
+### Testing Models (Optional)
+
+To use the `test_model` tool, add your OpenRouter API key:
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["@index9/mcp"],
+      "env": {
+        "OPEN_ROUTER_API_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+Get your API key from [openrouter.ai/keys](https://openrouter.ai/keys).
+
+## Available Tools
+
+- **`list_models`** - List models with optional filters (provider, context, modality, pricing, capabilities)
+- **`search_models`** - Semantic search across models using natural language
+- **`get_model`** - Get complete model details and specifications
+- **`compare_models`** - Compare 2-10 models side-by-side
+- **`recommend_model`** - Get AI-powered model recommendations for use cases
+- **`test_model`** - Run live tests against models via OpenRouter API (requires API key)
+
+## License
+
+MIT © [Index9](https://index9.dev)
+
+## Related
+
+- [Index9](https://index9.dev) - AI model registry and testing platform
+- [Model Context Protocol](https://modelcontextprotocol.io/) - The protocol this server implements

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import type { ListModelsResponse, GetModelResponse, SearchModelsResponse, CompareModelsResponse, RecommendModelResponse, TestModelResponse, ListModelsQueryParams } from "./types/index.js";
+export declare function listModels(params: ListModelsQueryParams): Promise<ListModelsResponse>;
+export declare function getModel(modelId: string): Promise<GetModelResponse>;
+export declare function searchModels(query: string, limit?: number, threshold?: number): Promise<SearchModelsResponse>;
+export declare function compareModels(modelIds: string[]): Promise<CompareModelsResponse>;
+export declare function recommendModel(useCase: string, maxPrice?: number, minContext?: number, requiredCapabilities?: string[], limit?: number): Promise<RecommendModelResponse>;
+export declare function testModel(modelIds: string[], testType?: "quick" | "code" | "reasoning" | "instruction" | "tool_calling", openRouterApiKey?: string | null): Promise<TestModelResponse>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAuB1B,wBAAsB,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAG3F;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGzE;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAKtF;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAC/B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,CAAC,CASjC;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,EAC1E,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAO5B"}

package/dist/client.js

@@ -0,0 +1,53 @@
+import axios from "axios";
+import { API_URL } from "./config.js";
+const client = axios.create({
+    baseURL: API_URL,
+    timeout: 30000,
+});
+client.interceptors.response.use((res) => res, (error) => {
+    if (error.response?.status === 404) {
+        const message = error.response?.data?.message || "Resource not found";
+        throw new Error(message);
+    }
+    const message = error.response?.data?.message ||
+        (error.code === "ECONNABORTED" ? `Request timeout` : null) ||
+        (error.code === "ECONNREFUSED" ? `Unable to connect to API server` : null) ||
+        error.message;
+    throw new Error(message);
+});
+export async function listModels(params) {
+    const { data } = await client.get("/models", { params });
+    return data;
+}
+export async function getModel(modelId) {
+    const { data } = await client.get(`/models/${encodeURIComponent(modelId)}`);
+    return data;
+}
+export async function searchModels(query, limit, threshold) {
+    const { data } = await client.post("/search", { query, limit, threshold });
+    return data;
+}
+export async function compareModels(modelIds) {
+    const { data } = await client.post("/models/compare", {
+        model_ids: modelIds,
+    });
+    return data;
+}
+export async function recommendModel(useCase, maxPrice, minContext, requiredCapabilities, limit) {
+    const { data } = await client.post("/models/recommend", {
+        use_case: useCase,
+        max_price_per_m: maxPrice,
+        min_context: minContext,
+        required_capabilities: requiredCapabilities,
+        limit,
+    });
+    return data;
+}
+export async function testModel(modelIds, testType, openRouterApiKey) {
+    const { data } = await client.post("/test", {
+        model_ids: modelIds,
+        test_type: testType,
+        open_router_api_key: openRouterApiKey || undefined,
+    });
+    return data;
+}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+declare const API_URL: string;
+declare const OPEN_ROUTER_API_KEY: string | null;
+export { API_URL, OPEN_ROUTER_API_KEY };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,OAAO,QAAyD,CAAC;AACvE,QAAA,MAAM,mBAAmB,eAA0C,CAAC;AAEpE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/config.js

@@ -0,0 +1,3 @@
+const API_URL = process.env.INDEX9_API_URL || "https://index9.dev/api";
+const OPEN_ROUTER_API_KEY = process.env.OPEN_ROUTER_API_KEY || null;
+export { API_URL, OPEN_ROUTER_API_KEY };

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { logger } from "./logger.js";
+import { startMCPServer } from "./mcp.js";
+// Export types for library usage
+export * from "./types/index.js";
+async function main() {
+    logger.info("Starting index9 MCP server");
+    await startMCPServer();
+}
+process.on("unhandledRejection", (error) => {
+    logger.error({
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+    }, "Unhandled rejection");
+    process.exit(1);
+});
+process.on("uncaughtException", (error) => {
+    logger.error({
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+    }, "Uncaught exception");
+    process.exit(1);
+});
+main().catch((error) => {
+    logger.error({
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+    }, "Failed to start");
+    process.exit(1);
+});

package/dist/logger.d.ts

@@ -0,0 +1,4 @@
+import pino from "pino";
+declare const logger: pino.Logger<never, boolean>;
+export { logger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,QAAA,MAAM,MAAM,6BAA0D,CAAC;AAEvE,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/logger.js

@@ -0,0 +1,3 @@
+import pino from "pino";
+const logger = pino({ name: "index9", level: "info" }, process.stderr);
+export { logger };

package/dist/mcp.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createMCPServer(): McpServer;
+export declare function startMCPServer(): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4BpE,wBAAgB,eAAe,cAgK9B;AAED,wBAAsB,cAAc,kBAenC"}

package/dist/mcp.js

@@ -0,0 +1,159 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { logger } from "./logger.js";
+import { listModelsTool } from "./tools/list_models.js";
+import { searchModelsTool } from "./tools/search_models.js";
+import { getModelTool } from "./tools/get_model.js";
+import { compareModelsTool } from "./tools/compare_models.js";
+import { recommendModelTool } from "./tools/recommend_model.js";
+import { testModelTool } from "./tools/test_model.js";
+import { OPEN_ROUTER_API_KEY } from "./config.js";
+import { listModelsSchema, searchModelsSchema, getModelSchema, compareModelsSchema, recommendModelSchema, testModelSchema, } from "./schemas.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8"));
+export function createMCPServer() {
+    const server = new McpServer({
+        name: "index9",
+        version: packageJson.version,
+    });
+    server.registerTool("list_models", {
+        title: "List Models",
+        description: "List AI models with optional filters. Filter by: provider or owner (openai, anthropic, google, etc.), min_context (e.g. 100000), modality (text, vision, audio, video, image), max_price_per_m (USD per million tokens), supports_tool_calling (boolean), supports_json_mode (boolean), tokenizer (model family: GPT, Claude, Llama3), output_modality (text, image, embeddings). Returns pricing, context window, max output tokens, input_modalities array, output_modalities array, capabilities (vision, audio, tool_calling, json_mode), and architecture (tokenizer family) for each model.",
+        inputSchema: listModelsSchema,
+    }, async (input) => {
+        try {
+            const result = await listModelsTool(input);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error({ tool: "list_models", error: errorMessage }, "Tool execution failed");
+            throw error;
+        }
+    });
+    server.registerTool("search_models", {
+        title: "Search Models",
+        description: 'Semantic search across 1000+ AI models using natural language queries. Uses vector embeddings (semantic search) combined with fuzzy text matching to find relevant models. Examples: "fast cheap model for code generation", "vision model under $1 per million tokens", "best reasoning model with large context". Returns models ranked by similarity score (0-1, default threshold 0.5) with descriptions, pricing, context window, and capabilities (vision, tool_calling).',
+        inputSchema: searchModelsSchema,
+    }, async (input) => {
+        try {
+            const result = await searchModelsTool(input);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error({ tool: "search_models", error: errorMessage }, "Tool execution failed");
+            throw error;
+        }
+    });
+    server.registerTool("get_model", {
+        title: "Get Model",
+        description: "Get complete details for a specific model by ID. Returns: description, context window, max output tokens, pricing (input/output per million tokens), extended pricing (image, audio, web_search, cache_read, cache_write), capabilities (vision, audio, function_calling, tool_calling, json_mode, custom), supported_parameters, input/output modalities, architecture (tokenizer, instruct_type), is_moderated, per_request_limits, and deployments. If exact match fails, semantic search may be used to find similar models.",
+        inputSchema: getModelSchema,
+    }, async (input) => {
+        try {
+            const result = await getModelTool(input);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error({ tool: "get_model", error: errorMessage }, "Tool execution failed");
+            throw error;
+        }
+    });
+    server.registerTool("compare_models", {
+        title: "Compare Models",
+        description: "Compare 2-10 models side-by-side. Returns unified view of: context windows, max output tokens, pricing (input/output), and capabilities (vision, tool_calling, custom). Includes not_found array for any model IDs that couldn't be located. Useful for making final selection between candidate models.",
+        inputSchema: compareModelsSchema,
+    }, async (input) => {
+        try {
+            const model_ids = Array.from(new Set(input.model_ids || []));
+            if (model_ids.length < 2) {
+                throw new Error("At least 2 unique model IDs are required");
+            }
+            const result = await compareModelsTool({ model_ids });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error({ tool: "compare_models", error: errorMessage }, "Tool execution failed");
+            throw error;
+        }
+    });
+    server.registerTool("recommend_model", {
+        title: "Recommend Model",
+        description: "Get ranked model recommendations for a use case. Describe what you're building (e.g. 'coding assistant', 'customer support chatbot', 'RAG pipeline'). Optionally set max_price_per_m, min_context, and required_capabilities (vision, tool_calling, audio, video). Returns scored recommendations (higher score = better match) optimized for your requirements with context window and pricing.",
+        inputSchema: recommendModelSchema,
+    }, async (input) => {
+        try {
+            const result = await recommendModelTool(input);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error({ tool: "recommend_model", error: errorMessage }, "Tool execution failed");
+            throw error;
+        }
+    });
+    server.registerTool("test_model", {
+        title: "Test Model",
+        description: "Run live tests against 1-5 models via OpenRouter API. **Requires OPEN_ROUTER_API_KEY environment variable** - set this in your MCP client configuration to enable. Test types: 'quick' (basic math), 'code' (Python function), 'reasoning' (logic puzzle), 'instruction' (follow formatting), 'tool_calling' (verify tool use works). Returns latency, output, token usage, cost estimates, and for tool_calling tests: tool_calls_detected boolean. Use to validate models before committing. Charges are billed directly to your OpenRouter account. Get your API key from: https://openrouter.ai/keys",
+        inputSchema: testModelSchema,
+    }, async (input) => {
+        try {
+            if (!OPEN_ROUTER_API_KEY) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Error: OPEN_ROUTER_API_KEY is required to use test_model. This tool allows you to run live tests against AI models via OpenRouter API.\n\nTo use this tool:\n1. Get your API key from https://openrouter.ai/keys\n2. Add OPEN_ROUTER_API_KEY to your MCP client configuration (e.g., in Cursor settings or Claude Desktop config)\n3. Restart your MCP client\n\nCharges are billed directly to your OpenRouter account.",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const result = await testModelTool(input);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error({ tool: "test_model", error: errorMessage }, "Tool execution failed");
+            throw error;
+        }
+    });
+    return server;
+}
+export async function startMCPServer() {
+    logger.info("Starting MCP server with stdio transport");
+    const server = createMCPServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("MCP server ready - awaiting requests");
+    process.on("SIGINT", async () => {
+        logger.info("Shutting down MCP server");
+        await server.close();
+        process.exit(0);
+    });
+}

package/dist/schemas.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+export declare const listModelsSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+    min_context: z.ZodOptional<z.ZodNumber>;
+    modality: z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        vision: "vision";
+        audio: "audio";
+        video: "video";
+        image: "image";
+    }>>;
+    supports_tool_calling: z.ZodOptional<z.ZodBoolean>;
+    supports_json_mode: z.ZodOptional<z.ZodBoolean>;
+    tokenizer: z.ZodOptional<z.ZodString>;
+    output_modality: z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        image: "image";
+        embeddings: "embeddings";
+    }>>;
+    max_price_per_m: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const searchModelsSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    threshold: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const getModelSchema: z.ZodObject<{
+    model_id: z.ZodString;
+}, z.core.$strip>;
+export declare const compareModelsSchema: z.ZodObject<{
+    model_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const recommendModelSchema: z.ZodObject<{
+    use_case: z.ZodString;
+    max_price_per_m: z.ZodOptional<z.ZodNumber>;
+    min_context: z.ZodOptional<z.ZodNumber>;
+    required_capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const testModelSchema: z.ZodObject<{
+    model_ids: z.ZodArray<z.ZodString>;
+    test_type: z.ZodDefault<z.ZodEnum<{
+        tool_calling: "tool_calling";
+        quick: "quick";
+        code: "code";
+        reasoning: "reasoning";
+        instruction: "instruction";
+    }>>;
+}, z.core.$strip>;
+export type ListModelsInput = z.infer<typeof listModelsSchema>;
+export type SearchModelsInput = z.infer<typeof searchModelsSchema>;
+export type GetModelInput = z.infer<typeof getModelSchema>;
+export type CompareModelsInput = z.infer<typeof compareModelsSchema>;
+export type RecommendModelInput = z.infer<typeof recommendModelSchema>;
+export type TestModelInput = z.infer<typeof testModelSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;iBAW3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,cAAc;;iBAEzB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;iBAE9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;iBAG1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export const listModelsSchema = z.object({
+    provider: z.string().optional(),
+    owner: z.string().optional(),
+    min_context: z.number().min(0).optional(),
+    modality: z.enum(["text", "vision", "audio", "video", "image"]).optional(),
+    supports_tool_calling: z.boolean().optional(),
+    supports_json_mode: z.boolean().optional(),
+    tokenizer: z.string().optional(),
+    output_modality: z.enum(["text", "image", "embeddings"]).optional(),
+    max_price_per_m: z.number().min(0).optional(),
+    limit: z.number().min(1).max(100).default(10),
+});
+export const searchModelsSchema = z.object({
+    query: z.string().min(1),
+    limit: z.number().min(1).max(50).default(10),
+    threshold: z.number().min(0).max(1).default(0.5),
+});
+export const getModelSchema = z.object({
+    model_id: z.string().min(1),
+});
+export const compareModelsSchema = z.object({
+    model_ids: z.array(z.string()).min(2).max(10),
+});
+export const recommendModelSchema = z.object({
+    use_case: z.string().min(1),
+    max_price_per_m: z.number().min(0).optional(),
+    min_context: z.number().min(0).optional(),
+    required_capabilities: z.array(z.string()).optional(),
+    limit: z.number().min(1).max(20).default(5),
+});
+export const testModelSchema = z.object({
+    model_ids: z.array(z.string()).min(1).max(5),
+    test_type: z.enum(["quick", "code", "reasoning", "instruction", "tool_calling"]).default("quick"),
+});

package/dist/tools/compare_models.d.ts

@@ -0,0 +1,3 @@
+import type { CompareModelsInput } from "../schemas.js";
+export declare function compareModelsTool(input: CompareModelsInput): Promise<import("../index.js").CompareModelsResponse>;
+//# sourceMappingURL=compare_models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compare_models.d.ts","sourceRoot":"","sources":["../../src/tools/compare_models.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,wDAEhE"}

package/dist/tools/compare_models.js

@@ -0,0 +1,4 @@
+import { compareModels } from "../client.js";
+export async function compareModelsTool(input) {
+    return compareModels(input.model_ids);
+}

package/dist/tools/get_model.d.ts

@@ -0,0 +1,3 @@
+import type { GetModelInput } from "../schemas.js";
+export declare function getModelTool(input: GetModelInput): Promise<import("../index.js").GetModelResponse>;
+//# sourceMappingURL=get_model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_model.d.ts","sourceRoot":"","sources":["../../src/tools/get_model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,mDAEtD"}

package/dist/tools/get_model.js

@@ -0,0 +1,4 @@
+import { getModel } from "../client.js";
+export async function getModelTool(input) {
+    return getModel(input.model_id);
+}

package/dist/tools/list_models.d.ts

@@ -0,0 +1,23 @@
+import type { ListModelsInput } from "../schemas.js";
+export declare function listModelsTool(input: ListModelsInput): Promise<{
+    models: {
+        id: string;
+        name: string;
+        provider: string;
+        context_window: number | null;
+        max_output_tokens: number | null;
+        input_modalities: string[];
+        pricing: {
+            input: number | null;
+            output: number | null;
+        };
+        capabilities: {
+            vision: boolean;
+            audio: boolean;
+            tool_calling: boolean;
+            json_mode: boolean;
+        };
+        architecture: Pick<import("../index.js").ModelArchitecture, "tokenizer">;
+    }[];
+}>;
+//# sourceMappingURL=list_models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list_models.d.ts","sourceRoot":"","sources":["../../src/tools/list_models.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,wBAAsB,cAAc,CAAC,KAAK,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;GAuB1D"}

package/dist/tools/list_models.js

@@ -0,0 +1,25 @@
+import { listModels } from "../client.js";
+export async function listModelsTool(input) {
+    const result = await listModels(input);
+    return {
+        models: result.models.map((m) => ({
+            id: m.id,
+            name: m.name,
+            provider: m.provider,
+            context_window: m.context_window,
+            max_output_tokens: m.max_output_tokens,
+            input_modalities: m.input_modalities,
+            pricing: {
+                input: m.pricing.input,
+                output: m.pricing.output,
+            },
+            capabilities: {
+                vision: m.capabilities.vision,
+                audio: m.capabilities.audio,
+                tool_calling: m.capabilities.tool_calling,
+                json_mode: m.capabilities.json_mode,
+            },
+            architecture: m.architecture,
+        })),
+    };
+}

package/dist/tools/recommend_model.d.ts

@@ -0,0 +1,3 @@
+import type { RecommendModelInput } from "../schemas.js";
+export declare function recommendModelTool(input: RecommendModelInput): Promise<import("../index.js").RecommendModelResponse>;
+//# sourceMappingURL=recommend_model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recommend_model.d.ts","sourceRoot":"","sources":["../../src/tools/recommend_model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,yDAQlE"}

package/dist/tools/recommend_model.js

@@ -0,0 +1,4 @@
+import { recommendModel } from "../client.js";
+export async function recommendModelTool(input) {
+    return recommendModel(input.use_case, input.max_price_per_m, input.min_context, input.required_capabilities, input.limit);
+}

package/dist/tools/search_models.d.ts

@@ -0,0 +1,14 @@
+import type { SearchModelsInput } from "../schemas.js";
+export declare function searchModelsTool(input: SearchModelsInput): Promise<{
+    results: {
+        id: string;
+        name: string;
+        description: string | null;
+        similarity: number;
+        provider: string;
+        context_window: number | null;
+        pricing: import("../index.js").ModelPricing;
+        capabilities: import("../index.js").SearchModelCapabilities;
+    }[];
+}>;
+//# sourceMappingURL=search_models.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search_models.d.ts","sourceRoot":"","sources":["../../src/tools/search_models.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB;;;;;;;;;;;GAO9D"}

package/dist/tools/search_models.js

@@ -0,0 +1,9 @@
+import { searchModels } from "../client.js";
+export async function searchModelsTool(input) {
+    const query = input.query.trim();
+    if (!query) {
+        throw new Error("Search query is required and must not be empty");
+    }
+    const result = await searchModels(query, input.limit, input.threshold);
+    return { results: result.results };
+}

package/dist/tools/test_model.d.ts

@@ -0,0 +1,3 @@
+import type { TestModelInput } from "../schemas.js";
+export declare function testModelTool(input: TestModelInput): Promise<import("../index.js").TestModelResponse>;
+//# sourceMappingURL=test_model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test_model.d.ts","sourceRoot":"","sources":["../../src/tools/test_model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,oDAExD"}

package/dist/tools/test_model.js

@@ -0,0 +1,5 @@
+import { testModel } from "../client.js";
+import { OPEN_ROUTER_API_KEY } from "../config.js";
+export async function testModelTool(input) {
+    return testModel(input.model_ids, input.test_type, OPEN_ROUTER_API_KEY);
+}

package/dist/types/api.d.ts

@@ -0,0 +1,156 @@
+/**
+ * API Types - Request and response types for HTTP API endpoints
+ */
+import type { ListModelsFilters, ModelPricing, ModelCapabilities, ModelArchitecture, ExtendedPricing, ModelLimits, PerRequestLimits } from "./models.js";
+export interface ListModelsQueryParams extends ListModelsFilters {
+    owner?: string;
+}
+export interface ListModelsResponse {
+    models: Array<{
+        id: string;
+        name: string;
+        provider: string;
+        context_window: number | null;
+        max_output_tokens: number | null;
+        input_modalities: string[];
+        output_modalities: string[];
+        pricing: ModelPricing;
+        capabilities: ModelCapabilities;
+        architecture: Pick<ModelArchitecture, "tokenizer">;
+    }>;
+}
+export interface DeploymentPricing {
+    input: number | null;
+    output: number | null;
+}
+export interface Benchmark {
+    dataset: string;
+    score: number;
+    percentile: number | null;
+}
+export interface GetModelCapabilities extends Omit<ModelCapabilities, "audio"> {
+    function_calling: boolean;
+    custom: string[];
+}
+export interface GetModelResponse {
+    id: string;
+    name: string;
+    provider: string;
+    description: string | null;
+    family: string | null;
+    version: string | null;
+    release_date: string | null;
+    limits: {
+        context_window: number;
+        max_output_tokens: number | null;
+    };
+    pricing: ModelPricing;
+    extended_pricing: ExtendedPricing | null;
+    capabilities: GetModelCapabilities;
+    supported_parameters: string[];
+    is_moderated: boolean;
+    input_modalities: string[];
+    output_modalities: string[];
+    architecture: ModelArchitecture;
+    per_request_limits: PerRequestLimits | null;
+    deployments: Array<{
+        provider: string;
+        external_id: string | null;
+        is_available: boolean;
+        pricing: DeploymentPricing;
+    }>;
+    benchmarks: Benchmark[];
+}
+export interface SearchModelsRequest {
+    query: string;
+    limit?: number;
+    threshold?: number;
+}
+export interface SearchModelCapabilities {
+    vision: boolean | null;
+    tool_calling: boolean | null;
+}
+export interface SearchModelsResponse {
+    results: Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        similarity: number;
+        provider: string;
+        context_window: number | null;
+        pricing: ModelPricing;
+        capabilities: SearchModelCapabilities;
+    }>;
+}
+export interface CompareModelsRequest {
+    model_ids: string[];
+}
+export interface CompareModelCapabilities {
+    vision: boolean | null;
+    tool_calling: boolean | null;
+    custom: string[];
+}
+export interface CompareModelsResponse {
+    models: Array<{
+        id: string;
+        name: string;
+        provider: string;
+        limits: ModelLimits;
+        pricing: ModelPricing;
+        capabilities: CompareModelCapabilities;
+        benchmarks: Benchmark[];
+    }>;
+    not_found?: string[];
+    suggestions?: Record<string, Array<{
+        id: string;
+        name: string;
+        similarity: number;
+    }>>;
+}
+export interface RecommendModelRequest {
+    use_case: string;
+    max_price_per_m?: number;
+    min_context?: number;
+    required_capabilities?: string[];
+    limit?: number;
+}
+export interface RecommendModelResponse {
+    use_case: string;
+    recommendations: Array<{
+        id: string;
+        name: string;
+        score: number;
+        context_window: number | null;
+        pricing: ModelPricing;
+    }>;
+}
+export interface TestModelRequest {
+    model_ids: string[];
+    test_type?: "quick" | "code" | "reasoning" | "instruction" | "tool_calling";
+}
+export interface TokensUsed {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+export interface CostEstimate {
+    input_cost: number | null;
+    output_cost: number | null;
+    total_cost: number | null;
+}
+export interface TestModelResult {
+    model_id: string;
+    model_name: string;
+    latency_ms: number;
+    output: string | null;
+    tokens_used: TokensUsed | null;
+    cost_estimate: CostEstimate;
+    tool_calls_detected?: boolean;
+    error: string | null;
+}
+export interface TestModelResponse {
+    test_type: string;
+    prompt: string;
+    results: TestModelResult[];
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

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

package/dist/types/api.js

@@ -0,0 +1,4 @@
+/**
+ * API Types - Request and response types for HTTP API endpoints
+ */
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./models.js";
+export * from "./api.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export * from "./models.js";
+export * from "./api.js";

package/dist/types/models.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Model Types - Normalized model interface for real-time provider federation
+ */
+export interface ModelPricing {
+    input: number | null;
+    output: number | null;
+}
+export interface ModelCapabilities {
+    vision: boolean;
+    audio: boolean;
+    tool_calling: boolean;
+    json_mode: boolean;
+}
+export interface ModelArchitecture {
+    tokenizer: string | null;
+    instruct_type: string | null;
+}
+export interface ExtendedPricing {
+    image: number | null;
+    audio: number | null;
+    web_search: number | null;
+    cache_read: number | null;
+    cache_write: number | null;
+    discount: number | null;
+}
+export interface ModelLimits {
+    context_window: number | null;
+    max_output_tokens: number | null;
+}
+export interface PerRequestLimits {
+    prompt_tokens: number | null;
+    completion_tokens: number | null;
+}
+export interface NormalizedModel {
+    id: string;
+    name: string;
+    provider: string;
+    context_window: number | null;
+    max_output_tokens: number | null;
+    pricing: ModelPricing;
+    capabilities: ModelCapabilities;
+    description: string | null;
+    release_date: string | null;
+    input_modalities: string[];
+    output_modalities: string[];
+    supported_parameters: string[];
+    architecture: ModelArchitecture;
+    extended_pricing: ExtendedPricing | null;
+    is_moderated: boolean;
+    per_request_limits: PerRequestLimits | null;
+}
+export interface ProviderAdapter {
+    id: string;
+    name: string;
+    fetchModels(): Promise<NormalizedModel[]>;
+}
+export interface ListModelsFilters {
+    provider?: string;
+    min_context?: number;
+    modality?: "text" | "vision" | "audio" | "video" | "image";
+    max_price_per_m?: number;
+    supports_tool_calling?: boolean;
+    supports_json_mode?: boolean;
+    tokenizer?: string;
+    output_modality?: "text" | "image" | "embeddings";
+    limit?: number;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/types/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;IAChC,gBAAgB,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/models.js

@@ -0,0 +1,4 @@
+/**
+ * Model Types - Normalized model interface for real-time provider federation
+ */
+export {};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@index9/mcp",
+  "version": "1.0.0-beta.0",
+  "description": "Give your AI assistant up-to-date model knowledge. 1000+ models with real-time pricing, context windows, and capabilities. Latest data, instant responses, zero cost.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "models",
+    "pricing",
+    "capabilities",
+    "context-window",
+    "real-time",
+    "api",
+    "sdk",
+    "openrouter"
+  ],
+  "homepage": "https://index9.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/index9-org/mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/index9-org/mcp/issues"
+  },
+  "license": "MIT",
+  "author": "Index9 <hello@index9.dev>",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "index9": "./dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.2",
+    "axios": "^1.13.2",
+    "pino": "^10.1.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "pino-pretty": "^13.1.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "dev": "tsx watch --env-file=.env src/index.ts",
+    "publish:beta": "pnpm publish --tag beta",
+    "publish:prod": "pnpm publish --tag latest"
+  }
+}