@ex7/mcp 0.1.0 → 0.2.0

package/README.md

@@ -53,6 +53,8 @@ claude mcp add ex7 --env EX7_AGENT_TOKEN=$EX7_AGENT_TOKEN -- npx -y @ex7/mcp
 | `ex7_deploy_plan` | Compile a deploy plan for a PASS strategy. Webhook TEMPLATE only; EX7 never executes. |
 | `ex7_strategy_publish` | Publish (or unpublish) a strategy. |
 | `ex7_signals_list` | Recent live signals (one-shot). |
+| `ex7_hunt` | One prompt, the machine runs the whole search (propose seed then mutate+re-judge then forward); returns the closest honest candidate + what killed it + fertile-ground. Needs EX7_TOKEN. |
+| `ex7_hunt_status` | Poll a running hunt. |
 | `ex7_workflow_run` | The whole loop: generate, validate, create, judge, gate, and optionally backtest + deploy-plan. Operate steps run only on a real PASS. |
 
 These supersede the older `ex7_orchestrate` / `ex7_recursive_search` tool set.

package/dist/index.js

@@ -1203,6 +1203,15 @@ class AgentScopedResource {
       ...o
     });
   }
+  create(input, o = {}) {
+    return this.http.json({
+      path: "api/agent/strategy/create",
+      method: "POST",
+      body: input,
+      auth: "agent",
+      ...o
+    });
+  }
   judge(strategyId, o = {}) {
     return this.http.json({
       path: "api/agent/judge/run",
@@ -1812,6 +1821,7 @@ function optString(args, key) {
   const v = args[key];
   return typeof v === "string" && v.length > 0 ? v : undefined;
 }
+var sleep5 = (ms) => new Promise((r) => setTimeout(r, ms));
 var TOOLS = [
   {
     definition: {
@@ -1880,13 +1890,13 @@ var TOOLS = [
       const inst = optString(args, "instrument");
       if (inst)
         input.instrument = inst;
-      return ctx.client.strategies.create(input);
+      return ctx.agentMode ? ctx.client.agent.create(input) : ctx.client.strategies.create(input);
     }
   },
   {
     definition: {
       name: "ex7_judge_run",
-      description: "Run The Judge on a saved strategy and return the terminal verdict (tier + metrics). With an agent token this is a deterministic $0 fixture lookup.",
+      description: "Run The Judge on a saved strategy and return the terminal verdict (tier + metrics). With an agent token this runs the same deterministic, net-of-cost REAL backtest on your own saved strategy at $0 to EX7 (audited demo ids return their published verdict).",
       inputSchema: {
         type: "object",
         properties: { strategy_id: { type: "string", minLength: 1 } },
@@ -1992,6 +2002,79 @@ var TOOLS = [
       return ctx.client.signals.list(limit !== undefined ? { limit } : {});
     }
   },
+  {
+    definition: {
+      name: "ex7_hunt",
+      description: "One prompt → the machine runs the WHOLE search: it proposes one strategy seed and then mutates + re-judges it (deterministic, no extra LLM cost) up to ~6 iterations, forward-validates the best, and returns the closest HONEST candidate + what killed it + fertile-ground next steps. The Judge is never loosened — a survivor is neutral evidence, never advice. Aimed at the above-the-spread frontier (defaults to 15m); never 2m dead ground. Blocks up to max_wait_sec, then returns a hunt_id you poll with ex7_hunt_status. Needs a user token (EX7_TOKEN); the $0 agent token cannot run hunts.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          prompt: { type: "string", minLength: 1, maxLength: 2000 },
+          instrument: { type: "string", enum: ["NQ", "ES", "CL", "MNQ", "MES", "MCL"] },
+          timeframe: { type: "string", enum: ["15m", "1H", "4H", "daily"] },
+          max_wait_sec: { type: "number", minimum: 0, maximum: 1800 }
+        },
+        required: ["prompt"],
+        additionalProperties: false
+      }
+    },
+    handler: async (ctx, args) => {
+      if (ctx.agentMode) {
+        throw Object.assign(new Error("ex7_hunt needs a user token (EX7_TOKEN); the $0 agent token cannot run compute-heavy hunts"), { code: "agent_token_forbidden", status: 403 });
+      }
+      const prompt = reqString(args, "prompt");
+      const body = { prompt };
+      const inst = optString(args, "instrument");
+      if (inst)
+        body.instrument = inst;
+      const tf = optString(args, "timeframe");
+      if (tf)
+        body.timeframe = tf;
+      const started = await ctx.client.request({
+        path: "api/hunt",
+        method: "POST",
+        body
+      });
+      const huntId = started.hunt_id;
+      if (!huntId)
+        return { ok: false, error: started.error ?? "hunt did not start" };
+      const maxWaitMs = Math.min(Math.max(optNumber(args, "max_wait_sec") ?? 300, 0), 1800) * 1000;
+      const deadline = Date.now() + maxWaitMs;
+      while (true) {
+        const snap = await ctx.client.request({ path: `api/hunt/${encodeURIComponent(huntId)}`, method: "GET" });
+        if (snap.status === "completed")
+          return { hunt_id: huntId, status: "completed", result: snap.result };
+        if (snap.status === "failed")
+          return { hunt_id: huntId, status: "failed", error: snap.error };
+        if (Date.now() >= deadline) {
+          return {
+            hunt_id: huntId,
+            status: "running",
+            n_iterations: snap.n_iterations ?? 0,
+            best: snap.best,
+            note: "still running — poll ex7_hunt_status with this hunt_id"
+          };
+        }
+        await sleep5(2500);
+      }
+    }
+  },
+  {
+    definition: {
+      name: "ex7_hunt_status",
+      description: "Poll a running hunt started by ex7_hunt. Returns { status, progress[], best, result? }.",
+      inputSchema: {
+        type: "object",
+        properties: { hunt_id: { type: "string", minLength: 1 } },
+        required: ["hunt_id"],
+        additionalProperties: false
+      }
+    },
+    handler: (ctx, args) => {
+      const id = reqString(args, "hunt_id");
+      return ctx.client.request({ path: `api/hunt/${encodeURIComponent(id)}`, method: "GET" });
+    }
+  },
   {
     definition: {
       name: "ex7_workflow_run",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ex7/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "EX7 Capital MCP server: drive the EX7 workflow from Claude Code, Cursor, or any MCP client.",
   "type": "module",
   "main": "dist/index.js",
@@ -14,6 +14,7 @@
   ],
   "scripts": {
     "build": "bun build src/index.ts --outdir dist --target node --format esm --external @modelcontextprotocol/sdk && chmod +x dist/index.js",
+    "prepack": "bun run build",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"
   },