@aggc/or-info 0.2.7 → 0.2.9

package/README.md

@@ -181,12 +181,17 @@ or-info refresh         # Force-refresh OpenRouter catalog + LMArena ELO
 
 | Tool | Description |
 |------|-------------|
-| `get_model_info` | Pricing, context, architecture, features and LMArena ELO for a model |
-| `list_models` | List models with optional filter, sort and limit |
-| `get_benchmarks` | LMArena ELO score, global rank, vote count and confidence interval for a model |
-| `compare_models` | Side-by-side comparison of two models |
-| `best_for_task` | Ranked top models for coding/reasoning/general/vision/cheap |
-| `refresh_cache` | Force-refresh OpenRouter catalog + LMArena ELO |
+| `models.get` | Pricing, context, architecture, features and LMArena ELO for a model |
+| `models.list` | List models with optional filter, sort and limit |
+| `models.compare` | Side-by-side comparison of two models |
+| `models.top` | Ranked top models for coding/reasoning/general/vision/cheap |
+| `benchmarks.get` | LMArena ELO score, global rank, vote count and confidence interval for a model |
+| `cache.refresh` | Force-refresh OpenRouter catalog + LMArena ELO |
+
+Legacy flat names (`get_model_info`, `list_models`, `get_benchmarks`,
+`compare_models`, `best_for_task`, `refresh_cache`) are still advertised in
+`tools/list` as deprecated aliases (same schemas, prefixed `[Deprecated]`)
+and remain callable. The dot-notation names are the canonical ones.
 
 ### Register in Claude Code
 

package/bin/or-info.mjs

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
+import { createRequire } from 'node:module';
 import { InvalidArgumentError, program } from 'commander';
 import chalk from 'chalk';
+
+const { version } = createRequire(import.meta.url)('../package.json');
 import { fetchModels, findModel, pricePerMillion, contextLength } from '../lib/openrouter.mjs';
 import { getElo, getAllElo, loadLeaderboard } from '../lib/lmarena.mjs';
 import { rankModels } from '../lib/scorer.mjs';
@@ -40,7 +43,7 @@ async function apiKey() {
 program
   .name('or-info')
   .description('OpenRouter model info: prices, benchmarks, context and comparisons')
-  .version('0.1.5')
+  .version(version)
   .option('--mcp', 'Start MCP server (stdio transport)');
 
 // ── models ─────────────────────────────────────────────────────────────────

package/mcp/server.mjs

@@ -1,11 +1,15 @@
+import { createRequire } from 'node:module';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { fetchModels, findModel, pricePerMillion, contextLength, modelTags } from '../lib/openrouter.mjs';
 import { getElo, getAllElo, loadLeaderboard } from '../lib/lmarena.mjs';
 import { rankModels } from '../lib/scorer.mjs';
 import { getApiKey } from '../lib/secrets.mjs';
 
+const { version } = createRequire(import.meta.url)('../package.json');
+
 const MODEL_SUMMARY_SCHEMA = {
   type: 'object',
   properties: {
@@ -26,9 +30,18 @@ const MODEL_SUMMARY_SCHEMA = {
 
 const ELO_SCHEMA = { type: ['object', 'null'], description: 'LMArena ELO entry or null when not tracked' };
 
-const TOOLS = [
+const TOOL_ALIASES = {
+  get_model_info: 'models.get',
+  list_models: 'models.list',
+  compare_models: 'models.compare',
+  best_for_task: 'models.top',
+  get_benchmarks: 'benchmarks.get',
+  refresh_cache: 'cache.refresh',
+};
+
+const CANONICAL_TOOLS = [
   {
-    name: 'get_model_info',
+    name: 'models.get',
     description: 'Get pricing, context length, architecture and features for a specific OpenRouter model',
     inputSchema: {
       type: 'object',
@@ -42,14 +55,14 @@ const TOOLS = [
       properties: { ...MODEL_SUMMARY_SCHEMA.properties, lmarena_elo: ELO_SCHEMA },
     },
     annotations: {
-      title: 'Get model info',
+      title: 'Get model',
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true,
     },
   },
   {
-    name: 'list_models',
+    name: 'models.list',
     description: 'List OpenRouter models with pricing. Optionally filter by name/id, sort, and limit results.',
     inputSchema: {
       type: 'object',
@@ -76,7 +89,7 @@ const TOOLS = [
     },
   },
   {
-    name: 'get_benchmarks',
+    name: 'benchmarks.get',
     description: 'Get LMArena ELO ranking for a model: score, global rank, vote count and confidence interval',
     inputSchema: {
       type: 'object',
@@ -94,14 +107,14 @@ const TOOLS = [
       required: ['model_id'],
     },
     annotations: {
-      title: 'Get benchmarks',
+      title: 'Get benchmark',
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true,
     },
   },
   {
-    name: 'compare_models',
+    name: 'models.compare',
     description: 'Side-by-side comparison of two models: pricing, context, benchmarks and features',
     inputSchema: {
       type: 'object',
@@ -127,7 +140,7 @@ const TOOLS = [
     },
   },
   {
-    name: 'best_for_task',
+    name: 'models.top',
     description: 'Rank the best models for a specific task, optionally within a price budget',
     inputSchema: {
       type: 'object',
@@ -160,14 +173,14 @@ const TOOLS = [
       required: ['task', 'results'],
     },
     annotations: {
-      title: 'Best models for task',
+      title: 'Top models for task',
       readOnlyHint: true,
       idempotentHint: true,
       openWorldHint: true,
     },
   },
   {
-    name: 'refresh_cache',
+    name: 'cache.refresh',
     description: 'Force-refresh the local cache: OpenRouter model catalog + LMArena ELO data',
     inputSchema: { type: 'object', properties: {} },
     outputSchema: {
@@ -188,6 +201,25 @@ const TOOLS = [
   },
 ];
 
+// Legacy flat names kept advertised in tools/list for discoverability,
+// derived from the canonical tools so input/output schemas stay in sync.
+const LEGACY_BY_CANONICAL = Object.fromEntries(
+  Object.entries(TOOL_ALIASES).map(([legacy, canonical]) => [canonical, legacy])
+);
+
+const LEGACY_TOOLS = CANONICAL_TOOLS.flatMap((tool) => {
+  const legacyName = LEGACY_BY_CANONICAL[tool.name];
+  if (!legacyName) return [];
+  return [{
+    ...tool,
+    name: legacyName,
+    description: `[Deprecated] Alias of \`${tool.name}\`. Use \`${tool.name}\` instead.`,
+    annotations: { ...tool.annotations, title: `[Deprecated] ${tool.annotations.title}` },
+  }];
+});
+
+const TOOLS = [...CANONICAL_TOOLS, ...LEGACY_TOOLS];
+
 function safeModelSummary(model) {
   const price = pricePerMillion(model);
   return {
@@ -218,9 +250,12 @@ function errorContent(msg) {
 }
 
 async function handleTool(name, args) {
+  // Accept legacy flat names (get_model_info, list_models, ...) by mapping
+  // them to the dot-notation canonical names exposed in tools/list.
+  name = TOOL_ALIASES[name] ?? name;
   const key = await getApiKey();
 
-  if (name === 'get_model_info') {
+  if (name === 'models.get') {
     const { model_id } = args;
     if (!model_id || typeof model_id !== 'string') return errorContent('model_id is required');
     const models = await fetchModels({ apiKey: key });
@@ -230,7 +265,7 @@ async function handleTool(name, args) {
     return result({ ...safeModelSummary(model), lmarena_elo: elo ?? null });
   }
 
-  if (name === 'list_models') {
+  if (name === 'models.list') {
     const filter = String(args.filter ?? '').toLowerCase();
     const sortBy = args.sort_by ?? 'name';
     const limit = Math.min(200, Math.max(1, args.limit ?? 50));
@@ -248,14 +283,14 @@ async function handleTool(name, args) {
     return result({ total: models.length, models: models.map(safeModelSummary) });
   }
 
-  if (name === 'get_benchmarks') {
+  if (name === 'benchmarks.get') {
     const { model_id } = args;
     if (!model_id || typeof model_id !== 'string') return errorContent('model_id is required');
     const elo = await getElo(model_id);
     return result({ model_id, lmarena_elo: elo ?? null });
   }
 
-  if (name === 'compare_models') {
+  if (name === 'models.compare') {
     const { model_a, model_b } = args;
     if (!model_a || !model_b) return errorContent('model_a and model_b are required');
     const [models, eloA, eloB] = await Promise.all([
@@ -270,7 +305,7 @@ async function handleTool(name, args) {
     return result({ a: { ...safeModelSummary(mA), lmarena_elo: eloA }, b: { ...safeModelSummary(mB), lmarena_elo: eloB } });
   }
 
-  if (name === 'best_for_task') {
+  if (name === 'models.top') {
     const task = args.task ?? 'general';
     const limit = Math.min(20, Math.max(1, args.limit ?? 5));
     const maxPrice = args.max_price_per_m_output ?? undefined;
@@ -280,7 +315,7 @@ async function handleTool(name, args) {
     return result({ task, results: ranked.map((r) => ({ ...safeModelSummary(r.model), score: r.score, lmarena_elo: r.eloEntry })) });
   }
 
-  if (name === 'refresh_cache') {
+  if (name === 'cache.refresh') {
     const [models, elo] = await Promise.all([
       fetchModels({ force: true, apiKey: key }),
       loadLeaderboard({ force: true }),
@@ -291,14 +326,15 @@ async function handleTool(name, args) {
   return errorContent(`Unknown tool: ${name}`);
 }
 
-export async function startMcp() {
-  const server = new Server(
-    { name: 'or-info', version: '0.1.5' },
+function makeServer() {
+  return new Server(
+    { name: 'or-info', version },
     { capabilities: { tools: {} } }
   );
+}
 
+function wireHandlers(server) {
   server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
-
   server.setRequestHandler(CallToolRequestSchema, async (req) => {
     const { name, arguments: args } = req.params;
     try {
@@ -308,6 +344,11 @@ export async function startMcp() {
       return errorContent(safe);
     }
   });
+}
+
+export async function startMcp() {
+  const server = makeServer();
+  wireHandlers(server);
 
   const transport = new StdioServerTransport();
   await server.connect(transport);
@@ -321,3 +362,38 @@ export async function startMcp() {
     });
   }
 }
+
+export async function startHttpMcp() {
+  const { createServer } = await import('node:http');
+  const port = Number(process.env.PORT) || 8000;
+
+  // Bridge config values Smithery may inject from smithery.yaml configSchema.
+  // Smithery passes schema properties as-is or uppercased depending on version.
+  if (!process.env.OPENROUTER_API_KEY) {
+    process.env.OPENROUTER_API_KEY = process.env.api_key ?? process.env.API_KEY ?? '';
+  }
+
+  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+  const server = makeServer();
+  wireHandlers(server);
+  await server.connect(transport);
+
+  const serverCard = JSON.stringify({
+    serverInfo: { name: 'or-info', version },
+    tools: CANONICAL_TOOLS.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })),
+  });
+
+  createServer(async (req, res) => {
+    if (req.url?.startsWith('/mcp')) {
+      await transport.handleRequest(req, res);
+    } else if (req.method === 'GET' && req.url === '/.well-known/mcp/server-card.json') {
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(serverCard);
+    } else {
+      res.writeHead(404);
+      res.end();
+    }
+  }).listen(port, () => {
+    process.stderr.write(`or-info HTTP MCP listening on port ${port}\n`);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aggc/or-info",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "CLI + MCP server for OpenRouter models: prices, benchmarks, context and comparisons",
   "type": "module",
   "engines": {