tokrepo-mcp-server 2.2.0 → 2.3.0

package/README.md

@@ -41,6 +41,7 @@ Once connected, your AI assistant can:
 - **Plan before install** — get install plan v2 with policy decisions, rollback, and verification
 - **Safe Codex install** — dry-run by default; risky assets must be staged or explicitly approved
 - **Lifecycle control** — list installed assets, uninstall managed files, and roll back install sessions
+- **Agent eval** — run TokRepo's agent-native search/plan/install/rollback contract checks
 
 ## Available Tools
 
@@ -54,6 +55,7 @@ Once connected, your AI assistant can:
 | `tokrepo_installed` | List TokRepo-managed Codex installs |
 | `tokrepo_uninstall` | Dry-run or remove a managed Codex install |
 | `tokrepo_rollback` | Dry-run or roll back a prior Codex install session |
+| `tokrepo_eval_agent` | Run agent-native CLI contract and lifecycle evals |
 | `tokrepo_install` | Get raw installable content |
 | `tokrepo_trending` | Browse popular/latest assets |
 
@@ -70,6 +72,7 @@ You: "Install that cursor rules asset"
 AI: [calls tokrepo_install_plan] → Reviews policy and actions
 AI: [calls tokrepo_codex_install with dry_run=false, confirm=true] → Writes only after explicit confirmation
 AI: [calls tokrepo_rollback with dry_run=true] → Shows exactly what would be removed before rollback
+AI: [calls tokrepo_eval_agent] → Verifies TokRepo's agent-facing flow end to end
 ```
 
 ## Why TokRepo?

package/bin/server.js

@@ -19,7 +19,7 @@ const API_BASE = process.env.TOKREPO_API || 'https://api.tokrepo.com';
 const TOKREPO_URL = 'https://tokrepo.com';
 const TOKREPO_TOKEN = process.env.TOKREPO_TOKEN || '';
 const TOKREPO_CLI = process.env.TOKREPO_CLI || '';
-const SERVER_VERSION = '2.2.0';
+const SERVER_VERSION = '2.3.0';
 
 // ─── MCP Protocol (JSON-RPC over stdio) ───
 
@@ -245,6 +245,23 @@ const TOOLS = [
       },
     },
   },
+  {
+    name: 'tokrepo_eval_agent',
+    description: 'Run TokRepo agent-native evals through the CLI. Verifies filtered search, install-plan contracts, metadata quality reporting, Codex install verification, manifest state, and rollback using temporary local state.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        uuid: {
+          type: 'string',
+          description: 'Optional sample asset UUID for install-plan and lifecycle tests.',
+        },
+        keyword: {
+          type: 'string',
+          description: 'Optional search keyword for filtered search eval. Default video.',
+        },
+      },
+    },
+  },
   {
     name: 'tokrepo_trending',
     description: 'Get trending/popular AI assets on TokRepo. Use when user asks for recommended or popular AI tools.',
@@ -803,6 +820,21 @@ async function handleRollback(args) {
   return { content: [{ type: 'text', text: jsonText(dry_run === false ? 'TokRepo Codex rollback result' : 'TokRepo Codex rollback dry-run', data) }] };
 }
 
+async function handleEvalAgent(args) {
+  const { uuid = '', keyword = '' } = args || {};
+  const cliArgs = ['eval-agent', '--json'];
+  if (uuid) cliArgs.push('--uuid', uuid);
+  if (keyword) cliArgs.push('--keyword', keyword);
+  const { stdout, stderr } = await runTokrepoCli(cliArgs);
+  let data;
+  try {
+    data = JSON.parse(stdout);
+  } catch {
+    data = { stdout, stderr };
+  }
+  return { content: [{ type: 'text', text: jsonText('TokRepo agent eval result', data) }] };
+}
+
 async function handleTrending(args) {
   const { sort = 'popular', limit = 10 } = args;
   const params = new URLSearchParams({
@@ -957,6 +989,7 @@ async function handleRequest(msg) {
           case 'tokrepo_installed': result = await handleInstalled(args || {}); break;
           case 'tokrepo_uninstall': result = await handleUninstall(args || {}); break;
           case 'tokrepo_rollback': result = await handleRollback(args || {}); break;
+          case 'tokrepo_eval_agent': result = await handleEvalAgent(args || {}); break;
           case 'tokrepo_trending': result = await handleTrending(args || {}); break;
           case 'tokrepo_push': result = await handlePush(args || {}); break;
           case 'tokrepo_status': result = await handleStatus(args || {}); break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokrepo-mcp-server",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Agent-native MCP server for TokRepo — search, plan, safely install, and push AI assets from MCP clients.",
   "mcpName": "io.github.tokrepo/mcp-server",
   "bin": {