@aggc/or-info 0.1.1 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 > CLI + MCP server to query OpenRouter model info: prices, ELO rankings, context and comparisons.
 
-Any person or AI agent (Claude Code, Cursor, pi, etc.) can install it and use it
+Any person or AI agent (Claude Code, Codex, Cursor, pi, etc.) can install it and use it
 to make informed decisions about which model to use.
 
 [![npm version](https://img.shields.io/npm/v/@aggc/or-info.svg)](https://www.npmjs.com/package/@aggc/or-info)
@@ -172,46 +172,58 @@ or-info refresh         # Force-refresh OpenRouter catalog + LMArena ELO
 |------|-------------|
 | `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, rank, votes and confidence interval for a model |
+| `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 |
 
 ### Register in Claude Code
 
-Add to `~/.claude/settings.json`:
+The recommended way is the `claude mcp add` command, which writes to `~/.claude.json`:
+
+```bash
+# Global — available in all projects
+claude mcp add --scope user or-info -- or-info --mcp
+
+# Project-only (run from the project directory)
+claude mcp add or-info -- or-info --mcp
+```
+
+Then verify:
+
+```bash
+claude mcp list
+```
+
+**Project `.mcp.json`** — commit this file to share the config with your team:
+
+macOS / Linux:
 
 ```json
 {
   "mcpServers": {
     "or-info": {
       "command": "or-info",
-      "args": ["--mcp"],
-      "env": {
-        "OPENROUTER_API_KEY": "sk-or-..."
-      }
+      "args": ["--mcp"]
     }
   }
 }
 ```
 
-Windows global install:
+Windows:
 
 ```json
 {
   "mcpServers": {
     "or-info": {
       "command": "or-info.cmd",
-      "args": ["--mcp"],
-      "env": {
-        "OPENROUTER_API_KEY": "sk-or-..."
-      }
+      "args": ["--mcp"]
     }
   }
 }
 ```
 
-If you installed via `npx` (without global install) on macOS/Linux:
+Without a global install (macOS/Linux):
 
 ```json
 {
@@ -224,7 +236,7 @@ If you installed via `npx` (without global install) on macOS/Linux:
 }
 ```
 
-If you installed via `npx` on Windows:
+Without a global install (Windows):
 
 ```json
 {
@@ -237,12 +249,18 @@ If you installed via `npx` on Windows:
 }
 ```
 
-Then verify:
+### Register in Codex
 
-```bash
-claude mcp list
+Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.or-info]
+command = "or-info"
+args = ["--mcp"]
 ```
 
+Then restart Codex for the change to take effect.
+
 ### Use from Pi
 
 Pi does not use an `mcpServers` settings schema. The recommended integration is a Pi skill

package/bin/or-info.mjs

@@ -40,7 +40,7 @@ async function apiKey() {
 program
   .name('or-info')
   .description('OpenRouter model info: prices, benchmarks, context and comparisons')
-  .version('0.1.0')
+  .version('0.1.5')
   .option('--mcp', 'Start MCP server (stdio transport)');
 
 // ── models ─────────────────────────────────────────────────────────────────

package/lib/lmarena.mjs

@@ -1,5 +1,6 @@
 import { get, set, TTL } from './cache.mjs';
 import { BENCHMARKS_CACHE } from './paths.mjs';
+import { VERSION } from './version.mjs';
 
 const HF_ROWS =
   'https://datasets-server.huggingface.co/rows?dataset=lmarena-ai%2Fleaderboard-dataset&config=text&split=latest';
@@ -29,7 +30,7 @@ async function fetchPage(offset) {
     let res;
     try {
       res = await fetch(url, {
-        headers: { 'User-Agent': 'or-info-cli/0.1.0' },
+        headers: { 'User-Agent': `or-info-cli/${VERSION}` },
         signal: AbortSignal.timeout(15_000),
       });
     } catch (err) {

package/lib/openrouter.mjs

@@ -1,8 +1,9 @@
 import { get, set, TTL } from './cache.mjs';
 import { MODELS_CACHE } from './paths.mjs';
+import { VERSION } from './version.mjs';
 
 const OR_BASE = 'https://openrouter.ai/api/v1';
-const USER_AGENT = 'or-info-cli/0.1.0 (https://github.com/jmtrs/or-info)';
+const USER_AGENT = `or-info-cli/${VERSION} (https://github.com/jmtrs/or-info)`;
 const RETRYABLE_STATUSES = new Set([429, 500, 502, 503, 504]);
 const MAX_FETCH_RETRIES = 2;
 

package/lib/version.mjs

@@ -0,0 +1,3 @@
+import { createRequire } from 'node:module';
+const { version } = createRequire(import.meta.url)('../package.json');
+export const VERSION = version;

package/mcp/server.mjs

@@ -33,7 +33,7 @@ const TOOLS = [
   },
   {
     name: 'get_benchmarks',
-    description: 'Get benchmark scores for a model: MMLU, HumanEval, MATH, coding, ELO, speed and latency',
+    description: 'Get LMArena ELO ranking for a model: score, global rank, vote count and confidence interval',
     inputSchema: {
       type: 'object',
       properties: {
@@ -183,7 +183,7 @@ async function handleTool(name, args) {
 
 export async function startMcp() {
   const server = new Server(
-    { name: 'or-info', version: '0.1.0' },
+    { name: 'or-info', version: '0.1.5' },
     { capabilities: { tools: {} } }
   );
 

package/package.json

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