midnight-mcp 0.2.20 → 0.3.0

package/README.md

@@ -1,5 +1,14 @@
 # Midnight MCP Server
 
+> ## ⚠️ Deprecated — use Kapa + Midnight Expert
+>
+> **midnight-mcp is being wound down.** Midnight has standardised on two official tools:
+>
+> - **Kapa MCP** (docs Q&A / search): `claude mcp add --transport http midnight https://midnight.mcp.kapa.ai`
+> - **Midnight Expert** (hands-on dev, Claude Code plugins): `curl -fsSL https://midnightntwrk.expert/install.sh | bash`
+>
+> **Migration guide → https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert**
+
 [![npm version](https://badge.fury.io/js/midnight-mcp.svg)](https://www.npmjs.com/package/midnight-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/midnight-mcp)](https://npm-stat.com/charts.html?package=midnight-mcp)
 [![License](https://img.shields.io/npm/l/midnight-mcp)](./LICENSE)
@@ -183,7 +192,7 @@ Quick references available offline:
 
 ## Indexed Repositories
 
-The API indexes **102+ Midnight repositories** from the entire Midnight ecosystem:
+The API indexes **115+ Midnight repositories** from the entire Midnight ecosystem:
 
 | Category                 | Count | Key Repositories                                                                 |
 | ------------------------ | ----- | -------------------------------------------------------------------------------- |
@@ -192,15 +201,15 @@ The API indexes **102+ Midnight repositories** from the entire Midnight ecosyste
 | **Core Infrastructure**  | 9     | `midnight-node`, `midnight-indexer`, `midnight-ledger`, `midnight-zk`            |
 | **ZK & Cryptography**    | 6     | `midnight-trusted-setup`, `fri`, `galois_recursion`, `pluto_eris`                |
 | **Documentation**        | 5     | `midnight-docs`, `midnight-improvement-proposals`, `midnight-architecture`       |
-| **Examples & Templates** | 8     | `example-counter`, `example-bboard`, `example-dex`, `example-DAO`                |
+| **Examples & Templates** | 18    | `example-counter`, `example-bboard`, `example-kitties`, `example-zkloan`         |
 | **Identity**             | 5     | `midnight-did`, `midnight-did-resolver`, `midnight-verifiable-credentials`       |
-| **Developer Tools**      | 4     | `setup-compact-action`, `upload-sarif-github-action`, `midnight-dev-utils`       |
+| **Developer Tools**      | 5     | `setup-compact-action`, `midnight-dev-utils`, `midnight-local-dev`               |
 | **Solutions & Apps**     | 7     | `midnight-solutions`, `midnight-website-next`, `nightcap`, `ocp`                 |
 | **Glacier Drop**         | 15    | `midnight-glacier-drop-tools`, `gd-claim-api`, `gd-claim-portal`                 |
-| **Partners**             | 14    | OpenZeppelin, BrickTowers, MeshJS, PaimaStudios, hackathon winners               |
+| **Partners & Community** | 20    | OpenZeppelin, BrickTowers, MeshJS, PaimaStudios, hackathon winners, Olanetsoft   |
 | **Other**                | 18+   | Contracts, bridges, token distribution, monitoring, QA tools, community projects |
 
-All **non-archived** repositories from the `midnightntwrk` organization plus community partners. See [api/README.md](api/README.md#indexed-repositories-102) for the complete list.
+All **non-archived** repositories from the `midnightntwrk` organization plus community partners. See [api/README.md](api/README.md#indexed-repositories-115) for the complete list.
 
 ---
 

package/dist/bin.js

@@ -2,10 +2,10 @@
 import {
   startHttpServer,
   startServer
-} from "./chunk-F4KM42XU.js";
+} from "./chunk-VBZPDFKP.js";
 import {
   setOutputFormat
-} from "./chunk-RCQYFKD3.js";
+} from "./chunk-KRDOSQPS.js";
 
 // src/bin.ts
 import { config } from "dotenv";
@@ -13,7 +13,7 @@ import { resolve } from "path";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 config({ path: resolve(process.cwd(), ".env") });
-var CURRENT_VERSION = "0.2.20";
+var CURRENT_VERSION = "0.3.0";
 process.on("uncaughtException", (error) => {
   console.error("Uncaught exception:", error);
   process.exit(1);

package/dist/{chunk-RCQYFKD3.js → chunk-KRDOSQPS.js}

@@ -10,8 +10,16 @@ var ConfigSchema = z.object({
   mode: z.enum(["hosted", "local"]).default("hosted"),
   // Hosted API URL (used when mode is 'hosted')
   hostedApiUrl: z.string().default("https://midnight-mcp-api.midnightmcp.workers.dev"),
+  // Optional bearer token sent to the hosted API. Needed when pointing
+  // MIDNIGHT_API_URL at a private/self-hosted backend that requires auth.
+  hostedApiToken: z.string().optional(),
   // GitHub
   githubToken: z.string().optional(),
+  // Extra GitHub repo owners allowed for the resolveRepo() org/repo
+  // fall-through, on top of the built-in vetted list. Comma-separated via
+  // MIDNIGHT_MCP_ALLOWED_REPO_OWNERS. Lets local users add their own repos
+  // without reopening arbitrary-repo access.
+  allowedRepoOwners: z.array(z.string()).default([]),
   // Vector Database (only needed for local mode)
   chromaUrl: z.string().default("http://localhost:8000"),
   // Embeddings (only needed for local mode)
@@ -31,7 +39,9 @@ function loadConfig() {
   const rawConfig = {
     mode: isLocalMode2 ? "local" : "hosted",
     hostedApiUrl: process.env.MIDNIGHT_API_URL,
+    hostedApiToken: process.env.MIDNIGHT_API_TOKEN,
     githubToken: process.env.GITHUB_TOKEN,
+    allowedRepoOwners: process.env.MIDNIGHT_MCP_ALLOWED_REPO_OWNERS ? process.env.MIDNIGHT_MCP_ALLOWED_REPO_OWNERS.split(",").map((s) => s.trim()).filter(Boolean) : void 0,
     chromaUrl: process.env.CHROMA_URL,
     openaiApiKey: process.env.OPENAI_API_KEY,
     embeddingModel: process.env.EMBEDDING_MODEL,
@@ -1624,7 +1634,7 @@ var releaseTracker = new ReleaseTracker();
 
 // src/utils/health.ts
 var startTime = Date.now();
-var VERSION = "0.2.20";
+var VERSION = "0.3.0";
 async function checkGitHubAPI() {
   const start = Date.now();
   try {
@@ -1652,7 +1662,7 @@ async function checkGitHubAPI() {
 }
 async function checkVectorStore() {
   try {
-    const { vectorStore: vectorStore2 } = await import("./db-VCUUBGDV.js");
+    const { vectorStore: vectorStore2 } = await import("./db-3WSIJCLE.js");
     if (vectorStore2) {
       return {
         status: "pass",
@@ -1790,16 +1800,6 @@ function shouldProceedWithRequest() {
   }
   return { proceed: true };
 }
-function formatRateLimitStatus() {
-  const status = getRateLimitStatus();
-  if (status.isLimited) {
-    return `\u26D4 ${status.message}`;
-  } else if (status.isWarning) {
-    return `\u26A0\uFE0F ${status.message}`;
-  } else {
-    return `\u2705 ${status.message}`;
-  }
-}
 
 // src/utils/cache.ts
 var Cache = class {
@@ -2009,6 +2009,9 @@ async function makeRequest(url, endpoint, options) {
       headers: {
         "Content-Type": "application/json",
         "User-Agent": "midnight-mcp",
+        // Send bearer auth when the backend requires it (private/self-hosted
+        // deployments that set MIDNIGHT_API_TOKEN).
+        ...config.hostedApiToken ? { Authorization: `Bearer ${config.hostedApiToken}` } : {},
         ...options.headers
       }
     });
@@ -2128,7 +2131,7 @@ function serialize(data) {
 }
 
 // src/utils/version.ts
-var CURRENT_VERSION = "0.2.20";
+var CURRENT_VERSION = "0.3.0";
 
 // src/db/vectorStore.ts
 var VectorStore = class {
@@ -2323,6 +2326,7 @@ var VectorStore = class {
 var vectorStore = new VectorStore();
 
 export {
+  config,
   isHostedMode,
   DEFAULT_REPOSITORIES,
   setMCPLogCallback,
@@ -2338,7 +2342,6 @@ export {
   getHealthStatus,
   getQuickHealthStatus,
   getRateLimitStatus,
-  formatRateLimitStatus,
   createCacheKey,
   searchCache,
   fileCache,
@@ -2351,4 +2354,4 @@ export {
   serialize,
   CURRENT_VERSION
 };
-//# sourceMappingURL=chunk-RCQYFKD3.js.map
+//# sourceMappingURL=chunk-KRDOSQPS.js.map

package/dist/{chunk-F4KM42XU.js → chunk-VBZPDFKP.js}

@@ -2,10 +2,10 @@ import {
   CURRENT_VERSION,
   DEFAULT_REPOSITORIES,
   SelfCorrectionHints,
+  config,
   createCacheKey,
   fileCache,
   formatErrorResponse,
-  formatRateLimitStatus,
   getHealthStatus,
   getQuickHealthStatus,
   getRateLimitStatus,
@@ -25,7 +25,7 @@ import {
   validateNumber,
   validateQuery,
   vectorStore
-} from "./chunk-RCQYFKD3.js";
+} from "./chunk-KRDOSQPS.js";
 
 // src/tools/search/schemas.ts
 import { z } from "zod";
@@ -171,43 +171,43 @@ function finalizeResponse(response, cacheKey, warnings) {
   });
   return finalResponse;
 }
-async function performSearch(query, limit, config) {
+async function performSearch(query, limit, config2) {
   const validation = validateSearchInput(query, limit);
   if (!validation.success) {
     return validation.error;
   }
   const { sanitizedQuery, limit: validatedLimit, warnings } = validation.context;
-  logger.debug(`Searching ${config.searchType}`, {
+  logger.debug(`Searching ${config2.searchType}`, {
     query: sanitizedQuery,
     mode: isHostedMode() ? "hosted" : "local"
   });
   const cacheKey = createCacheKey(
-    config.searchType,
+    config2.searchType,
     sanitizedQuery,
     validatedLimit,
-    ...config.cacheKeyExtra
+    ...config2.cacheKeyExtra
   );
   const cached = checkSearchCache(cacheKey);
   if (cached) return cached;
   const hostedResult = await tryHostedSearch(
-    config.searchType,
-    () => config.hostedSearchFn(sanitizedQuery, validatedLimit),
+    config2.searchType,
+    () => config2.hostedSearchFn(sanitizedQuery, validatedLimit),
     cacheKey,
     warnings
   );
   if (hostedResult) {
-    return { ...hostedResult.result, ...config.hostedResultExtra };
+    return { ...hostedResult.result, ...config2.hostedResultExtra };
   }
-  const filter = config.buildFilter();
+  const filter = config2.buildFilter();
   let results = await vectorStore.search(sanitizedQuery, validatedLimit, filter);
-  if (config.postFilter) {
-    results = config.postFilter(results);
+  if (config2.postFilter) {
+    results = config2.postFilter(results);
   }
   const response = {
-    results: results.map(config.transformResult),
+    results: results.map(config2.transformResult),
     totalResults: results.length,
     query: sanitizedQuery,
-    ...config.extraFields
+    ...config2.extraFields
   };
   return finalizeResponse(response, cacheKey, warnings);
 }
@@ -720,7 +720,10 @@ var CompileContractInputSchema = z2.object({
 });
 
 // src/services/compiler.ts
-var COMPILER_API_URL = process.env.COMPACT_COMPILER_URL || "https://compact-playground.up.railway.app";
+function getConfiguredCompilerUrl() {
+  const url = process.env.COMPACT_COMPILER_URL?.trim();
+  return url ? url : void 0;
+}
 var COMPILER_TIMEOUT = 3e4;
 var MAX_CODE_SIZE = 100 * 1024;
 async function compileContract(code, options = {}) {
@@ -740,6 +743,15 @@ async function compileContract(code, options = {}) {
       serviceAvailable: true
     };
   }
+  const url = getConfiguredCompilerUrl();
+  if (!url) {
+    return {
+      success: false,
+      message: "No compiler service configured. Set COMPACT_COMPILER_URL to a compiler you run yourself to enable compilation; contract source is not sent to any third-party by default.",
+      error: "COMPILER_NOT_CONFIGURED",
+      serviceAvailable: false
+    };
+  }
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), COMPILER_TIMEOUT);
   try {
@@ -755,7 +767,7 @@ async function compileContract(code, options = {}) {
       codeLength: code.length,
       options: requestBody.options
     });
-    const response = await fetch(`${COMPILER_API_URL}/compile`, {
+    const response = await fetch(`${url}/compile`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
@@ -858,7 +870,7 @@ async function compileContract(code, options = {}) {
   }
 }
 function getCompilerUrl() {
-  return COMPILER_API_URL;
+  return getConfiguredCompilerUrl();
 }
 
 // src/tools/analyze/handlers.ts
@@ -1605,8 +1617,55 @@ var REPO_ALIASES = {
   bboard: { owner: "midnightntwrk", repo: "example-bboard" },
   "example-dex": { owner: "midnightntwrk", repo: "example-dex" },
   dex: { owner: "midnightntwrk", repo: "example-dex" },
+  "example-hello-world": {
+    owner: "midnightntwrk",
+    repo: "example-hello-world"
+  },
+  "hello-world": { owner: "midnightntwrk", repo: "example-hello-world" },
+  "example-kitties": { owner: "midnightntwrk", repo: "example-kitties" },
+  kitties: { owner: "midnightntwrk", repo: "example-kitties" },
+  cryptokitties: { owner: "midnightntwrk", repo: "example-kitties" },
+  "example-nft-contracts": {
+    owner: "midnightntwrk",
+    repo: "example-nft-contracts"
+  },
+  "nft-contracts": { owner: "midnightntwrk", repo: "example-nft-contracts" },
+  nft: { owner: "midnightntwrk", repo: "example-nft-contracts" },
+  "example-locker": { owner: "midnightntwrk", repo: "example-locker" },
+  locker: { owner: "midnightntwrk", repo: "example-locker" },
+  "example-zkloan": { owner: "midnightntwrk", repo: "example-zkloan" },
+  zkloan: { owner: "midnightntwrk", repo: "example-zkloan" },
+  "example-battleship": {
+    owner: "midnightntwrk",
+    repo: "example-battleship"
+  },
+  "example-private-party": {
+    owner: "midnightntwrk",
+    repo: "example-private-party"
+  },
+  "private-party": { owner: "midnightntwrk", repo: "example-private-party" },
+  "midnight-dust-generator": {
+    owner: "midnightntwrk",
+    repo: "midnight-dust-generator"
+  },
+  "dust-generator": {
+    owner: "midnightntwrk",
+    repo: "midnight-dust-generator"
+  },
+  "midnight-tip-jar": { owner: "midnightntwrk", repo: "midnight-tip-jar" },
+  "tip-jar": { owner: "midnightntwrk", repo: "midnight-tip-jar" },
+  "midnight-leaderboard": {
+    owner: "midnightntwrk",
+    repo: "midnight-leaderboard"
+  },
+  leaderboard: { owner: "midnightntwrk", repo: "midnight-leaderboard" },
   // Developer Tools
   "create-mn-app": { owner: "midnightntwrk", repo: "create-mn-app" },
+  "midnight-local-dev": {
+    owner: "midnightntwrk",
+    repo: "midnight-local-dev"
+  },
+  "local-dev": { owner: "midnightntwrk", repo: "midnight-local-dev" },
   "midnight-wallet": { owner: "midnightntwrk", repo: "midnight-wallet" },
   wallet: { owner: "midnightntwrk", repo: "midnight-wallet" },
   // Infrastructure
@@ -1705,7 +1764,22 @@ var REPO_ALIASES = {
   // @effectstream/midnight-contracts and the evm-midnight-v2 / zswap-da templates.
   // NOTE: repo currently has NO LICENSE — treat indexed content as reference only.
   effectstream: { owner: "effectstream", repo: "effectstream" },
-  "effect-stream": { owner: "effectstream", repo: "effectstream" }
+  "effect-stream": { owner: "effectstream", repo: "effectstream" },
+  // Community Examples & Learning Resources (Olanetsoft)
+  "midnight-mcp": { owner: "Olanetsoft", repo: "midnight-mcp" },
+  mcp: { owner: "Olanetsoft", repo: "midnight-mcp" },
+  "compact-playground": { owner: "Olanetsoft", repo: "compact-playground" },
+  playground: { owner: "Olanetsoft", repo: "compact-playground" },
+  "compact-by-example": { owner: "Olanetsoft", repo: "compact-by-example" },
+  "learn-compact": { owner: "Olanetsoft", repo: "learn-compact" },
+  "example-dust-sponsorship": {
+    owner: "Olanetsoft",
+    repo: "example-dust-sponsorship"
+  },
+  "dust-sponsorship": {
+    owner: "Olanetsoft",
+    repo: "example-dust-sponsorship"
+  }
 };
 var EXAMPLES = [
   {
@@ -6346,38 +6420,7 @@ var versionCheckResult = {
 var toolCallCount = 0;
 var VERSION_CHECK_INTERVAL = 10;
 async function checkForUpdates() {
-  try {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), 5e3);
-    const response = await fetch(
-      "https://registry.npmjs.org/midnight-mcp/latest",
-      { signal: controller.signal }
-    );
-    clearTimeout(timeoutId);
-    if (!response.ok) return;
-    const data = await response.json();
-    const latestVersion = data.version;
-    if (latestVersion !== CURRENT_VERSION) {
-      versionCheckResult = {
-        isOutdated: true,
-        latestVersion,
-        lastChecked: Date.now(),
-        updateMessage: `\u{1F6A8} UPDATE AVAILABLE: v${latestVersion} (you have v${CURRENT_VERSION})`
-      };
-      logger.warn(
-        `Outdated version detected: v${CURRENT_VERSION} -> v${latestVersion}`
-      );
-    } else {
-      versionCheckResult = {
-        ...versionCheckResult,
-        lastChecked: Date.now()
-      };
-    }
-  } catch (error) {
-    logger.debug("Version check failed (non-blocking)", {
-      error: error instanceof Error ? error.message : String(error)
-    });
-  }
+  return;
 }
 function maybeCheckForUpdates() {
   toolCallCount++;
@@ -6602,13 +6645,14 @@ function registerCompletionsHandler(server) {
     };
   });
 }
+var DEPRECATION_PREFIX = "[DEPRECATED] midnight-mcp is being retired \u2014 use Kapa (docs Q&A) + Midnight Expert (dev): https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert \u2014 ";
 function registerToolHandlers(server) {
   server.setRequestHandler(ListToolsRequestSchema, async () => {
     logger.debug("Listing tools");
     return {
       tools: allTools.map((tool) => ({
         name: tool.name,
-        description: tool.description,
+        description: DEPRECATION_PREFIX + tool.description,
         inputSchema: tool.inputSchema,
         // Include output schema if defined
         ...tool.outputSchema && { outputSchema: tool.outputSchema },
@@ -7805,19 +7849,29 @@ async function extractContractStructure(input) {
 }
 
 // src/tools/repository/handlers.ts
+var ALLOWED_REPO_OWNERS = new Set(
+  [
+    ...Object.values(REPO_ALIASES).map((a) => a.owner),
+    ...DEFAULT_REPOSITORIES.map((r) => r.owner),
+    ...config.allowedRepoOwners
+  ].map((owner) => owner.toLowerCase())
+);
 function resolveRepo(repoName) {
   const name = repoName || "compact";
   const normalized = name.toLowerCase().replace(/^midnightntwrk\//, "");
   const alias = REPO_ALIASES[normalized];
   if (alias) return alias;
-  for (const config of DEFAULT_REPOSITORIES) {
-    if (config.repo.toLowerCase() === normalized) {
-      return { owner: config.owner, repo: config.repo };
+  for (const config2 of DEFAULT_REPOSITORIES) {
+    if (config2.repo.toLowerCase() === normalized) {
+      return { owner: config2.owner, repo: config2.repo };
     }
   }
   if (name.includes("/")) {
     const [owner, repo] = name.split("/");
-    return { owner, repo };
+    if (owner && repo && ALLOWED_REPO_OWNERS.has(owner.toLowerCase())) {
+      return { owner, repo };
+    }
+    return null;
   }
   return null;
 }
@@ -9357,7 +9411,9 @@ async function healthCheck(input) {
     const status = await getHealthStatus();
     return {
       ...status,
-      rateLimit: formatRateLimitStatus(),
+      // Return the structured object (not a formatted string) so the value
+      // conforms to the tool's outputSchema, which declares rateLimit as an object.
+      rateLimit: getRateLimitStatus(),
       cacheStats: {
         search: searchCache.getStats(),
         file: fileCache.getStats(),
@@ -9367,7 +9423,7 @@ async function healthCheck(input) {
   }
   return {
     ...getQuickHealthStatus(),
-    rateLimit: formatRateLimitStatus()
+    rateLimit: getRateLimitStatus()
   };
 }
 async function getStatus(_input) {
@@ -9390,6 +9446,17 @@ async function getStatus(_input) {
     }
   };
 }
+function isNewerVersion(candidate, base) {
+  const a = candidate.split(".").map((n) => parseInt(n, 10) || 0);
+  const b = base.split(".").map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    const x = a[i] ?? 0;
+    const y = b[i] ?? 0;
+    if (x > y) return true;
+    if (x < y) return false;
+  }
+  return false;
+}
 async function checkVersion(_input) {
   try {
     const response = await fetch(
@@ -9406,24 +9473,25 @@ async function checkVersion(_input) {
     }
     const data = await response.json();
     const latestVersion = data.version;
-    const isUpToDate = CURRENT_VERSION === latestVersion;
-    return {
+    const isUpToDate = !isNewerVersion(latestVersion, CURRENT_VERSION);
+    const result = {
       currentVersion: CURRENT_VERSION,
       latestVersion,
       isUpToDate,
-      message: isUpToDate ? "\u2705 You are running the latest version!" : `\u26A0\uFE0F UPDATE AVAILABLE: v${latestVersion} (you have v${CURRENT_VERSION})`,
-      updateInstructions: isUpToDate ? null : {
-        step1: "Clear npx cache: rm -rf ~/.npm/_npx (macOS/Linux) or del /s /q %LocalAppData%\\npm-cache\\_npx (Windows)",
-        step2: "Restart Claude Desktop completely (Cmd+Q / Alt+F4, then reopen)",
-        step3: "Or update config to use: npx -y midnight-mcp@latest (forces latest)",
-        alternative: "You can also install globally: npm install -g midnight-mcp@latest"
-      },
-      newFeatures: isUpToDate ? null : [
-        "Auto-update config tool - AI agents update your config automatically",
-        "midnight-extract-contract-structure - Static analysis with 10 pre-compilation checks",
-        "MCP Logging, Progress, Completions capabilities"
-      ]
+      message: isUpToDate ? "\u2705 You are running the latest published version. Note: midnight-mcp is deprecated \u2014 migrate to Kapa (docs Q&A) + Midnight Expert (dev): https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert" : `\u26A0\uFE0F A newer version (v${latestVersion}) exists, but midnight-mcp is deprecated \u2014 migrate to Kapa (docs Q&A) + Midnight Expert (dev): https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert`
     };
+    if (!isUpToDate) {
+      result.updateInstructions = {
+        note: "midnight-mcp is deprecated; updating is not recommended.",
+        kapa: "claude mcp add --transport http midnight https://midnight.mcp.kapa.ai",
+        midnightExpert: "curl -fsSL https://midnightntwrk.expert/install.sh | bash",
+        guide: "https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert"
+      };
+      result.newFeatures = [
+        "midnight-mcp is deprecated \u2014 see the migration guide for the official replacements."
+      ];
+    }
+    return result;
   } catch (error) {
     return {
       currentVersion: CURRENT_VERSION,
@@ -11173,7 +11241,7 @@ var suggestToolOutputSchema = {
 var metaTools = [
   {
     name: "midnight-list-tool-categories",
-    description: "\u{1F4CB} DISCOVERY TOOL: List available tool categories for progressive exploration. Use this FIRST to understand what capabilities are available, then drill into specific categories with midnight-list-category-tools. Reduces cognitive load by organizing 28 tools into 7 logical groups.",
+    description: "\u{1F4CB} DISCOVERY TOOL: List available tool categories for progressive exploration. Use this FIRST to understand what capabilities are available, then drill into specific categories with midnight-list-category-tools. Reduces cognitive load by organizing the available tools into logical groups.",
     inputSchema: {
       type: "object",
       properties: {
@@ -11266,8 +11334,44 @@ USAGE GUIDANCE:
 ];
 setMetaTools(metaTools);
 
+// src/tools/deprecation/index.ts
+var BLOG_URL = "https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert";
+var deprecationTools = [
+  {
+    name: "midnight-new-mcp",
+    description: "Show where midnight-mcp has moved. midnight-mcp is deprecated; Midnight now uses the official Kapa MCP (docs Q&A) and Midnight Expert (hands-on dev). Call this for the install commands and the migration guide.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    },
+    annotations: {
+      readOnlyHint: true,
+      idempotentHint: true,
+      title: "\u27A1\uFE0F Migrate off midnight-mcp",
+      category: "health"
+    },
+    handler: async () => ({
+      status: "deprecated",
+      message: "midnight-mcp is being retired. Midnight has two official replacements.",
+      kapa: {
+        purpose: "Docs Q&A / search",
+        install: "claude mcp add --transport http midnight https://midnight.mcp.kapa.ai",
+        url: "https://midnight.mcp.kapa.ai"
+      },
+      midnightExpert: {
+        purpose: "Hands-on dev (Claude Code plugins)",
+        install: "curl -fsSL https://midnightntwrk.expert/install.sh | bash",
+        url: "https://midnightntwrk.expert"
+      },
+      guide: BLOG_URL
+    })
+  }
+];
+
 // src/tools/index.ts
 var allTools = [
+  ...deprecationTools,
+  // Redirect to the official replacements, surfaced first
   ...metaTools,
   // Discovery tools first for visibility
   ...searchTools,
@@ -11289,4 +11393,4 @@ export {
   startServer,
   startHttpServer
 };
-//# sourceMappingURL=chunk-F4KM42XU.js.map
+//# sourceMappingURL=chunk-VBZPDFKP.js.map

package/dist/db-3WSIJCLE.js

@@ -0,0 +1,7 @@
+import {
+  vectorStore
+} from "./chunk-KRDOSQPS.js";
+export {
+  vectorStore
+};
+//# sourceMappingURL=db-3WSIJCLE.js.map

package/dist/index.js

@@ -9,10 +9,10 @@ import {
   promptDefinitions,
   startHttpServer,
   startServer
-} from "./chunk-F4KM42XU.js";
+} from "./chunk-VBZPDFKP.js";
 import {
   logger
-} from "./chunk-RCQYFKD3.js";
+} from "./chunk-KRDOSQPS.js";
 export {
   allResources,
   allTools,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "midnight-mcp",
-  "version": "0.2.20",
-  "description": "Model Context Protocol Server for Midnight Blockchain Development",
+  "version": "0.3.0",
+  "description": "[DEPRECATED — migrate to Kapa + Midnight Expert: https://docs.midnight.network/blog/migrating-to-kapa-and-midnight-expert] Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -10,7 +10,7 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "start": "node dist/bin.js --stdio",
+    "start": "node dist/bin.js",
     "start:http": "node dist/bin.js --http",
     "dev": "NODE_ENV=development tsup --watch",
     "test": "vitest",

package/dist/db-VCUUBGDV.js

@@ -1,7 +0,0 @@
-import {
-  vectorStore
-} from "./chunk-RCQYFKD3.js";
-export {
-  vectorStore
-};
-//# sourceMappingURL=db-VCUUBGDV.js.map