moltalyzer-mcp 1.1.1 → 1.3.0

package/README.md

@@ -1,35 +1,44 @@
 # moltalyzer-mcp
 
-MCP server for [Moltalyzer](https://moltalyzer.xyz) — crypto intelligence, GitHub trends, prediction market signals, and token analysis via x402 micropayments.
+MCP server for [Moltalyzer](https://moltalyzer.xyz) — crypto intelligence, GitHub trends, prediction market signals, and token analysis.
 
 Works with Claude Desktop, Claude Code, ChatGPT, Cursor, and any MCP-compatible client.
 
-## Setup
+**16 tools total.** 4 free tools (no setup needed). 12 paid tools via x402 micropayments ($0.005–$0.05 per call).
 
-### 1. Get a wallet with USDC on Base
+## Quick Start
 
-You need an EVM wallet private key with USDC on Base Mainnet. Each tool call costs $0.005–$0.05.
+### Option A: Free tier (no wallet needed)
 
-### 2. Add to your MCP client
+4 tools available immediately: health check, API info, intelligence sample, Moltbook sample.
 
-**Claude Desktop** (`claude_desktop_config.json`):
+**Claude Code:**
+```bash
+claude mcp add moltalyzer -- npx -y moltalyzer-mcp
+```
 
+Or add to `.claude/settings.json`:
 ```json
 {
   "mcpServers": {
     "moltalyzer": {
       "command": "npx",
-      "args": ["-y", "moltalyzer-mcp"],
-      "env": {
-        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
-      }
+      "args": ["-y", "moltalyzer-mcp"]
     }
   }
 }
 ```
 
-**Claude Code** (`.claude/settings.json`):
+### Option B: Full access via x402 micropayments
 
+All 16 tools. Pay per call with USDC on Base Mainnet (~$0.005–$0.05 per call). No subscription.
+
+**Claude Code:**
+```bash
+claude mcp add moltalyzer -e EVM_PRIVATE_KEY=0xYOUR_KEY -- npx -y moltalyzer-mcp
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
 ```json
 {
   "mcpServers": {
@@ -45,7 +54,6 @@ You need an EVM wallet private key with USDC on Base Mainnet. Each tool call cos
 ```
 
 **Cursor** (`.cursor/mcp.json`):
-
 ```json
 {
   "mcpServers": {
@@ -60,16 +68,34 @@ You need an EVM wallet private key with USDC on Base Mainnet. Each tool call cos
 }
 ```
 
+To get USDC on Base: [Coinbase](https://coinbase.com), [Bridge from other chains](https://bridge.base.org/).
+
 ## Tools
 
-### Moltbook (Crypto Community Intelligence)
+### Free Tools (no wallet needed)
+
+| Tool | Description |
+|------|-------------|
+| `get_health` | API health check — status, job statuses, x402 connectivity |
+| `get_api_info` | All endpoints, pricing, changelog, and rate limits |
+| `get_intelligence_sample` | Free sample of the Master Intelligence Digest (rate limited: 1/20min) |
+| `get_moltbook_sample` | Free sample of the Moltbook community digest (rate limited: 1/20min) |
+
+### Moltbook — Crypto Community Intelligence
 
 | Tool | Description | Price |
 |------|-------------|-------|
 | `get_moltbook_digest` | Latest hourly community sentiment digest — topics, narratives, hot discussions | $0.005 |
 | `get_moltbook_history` | Historical hourly digests (1-24h lookback) | $0.02 |
 
-### GitHub (Trending Repos)
+### Master Intelligence Digest — Cross-Domain Synthesis
+
+| Tool | Description | Price |
+|------|-------------|-------|
+| `get_intelligence_digest` | Latest 4-hourly synthesis of all feeds — crypto, GitHub, Polymarket, tokens, macro | $0.01 |
+| `get_intelligence_history` | Historical master digests (1-168h lookback) | $0.03 |
+
+### GitHub — Trending Repos
 
 | Tool | Description | Price |
 |------|-------------|-------|
@@ -77,14 +103,14 @@ You need an EVM wallet private key with USDC on Base Mainnet. Each tool call cos
 | `get_github_history` | Historical daily digests (1-30 days) | $0.05 |
 | `get_github_repos` | Top trending repos, filterable by language | $0.01 |
 
-### Polymarket (Predetermined Outcome Detection)
+### Polymarket — Predetermined Outcome Detection
 
 | Tool | Description | Price |
 |------|-------------|-------|
 | `get_polymarket_signal` | Single signal — markets where outcome is already known by insiders | $0.01 |
 | `get_polymarket_signals` | Batch of up to 20 signals, with polling support | $0.03 |
 
-### Tokens (Real-Time Token Intelligence)
+### Tokens — Real-Time Token Intelligence
 
 | Tool | Description | Price |
 |------|-------------|-------|
@@ -92,31 +118,24 @@ You need an EVM wallet private key with USDC on Base Mainnet. Each tool call cos
 | `get_token_signals` | Batch of up to 20 signals, filter by chain/tier/score | $0.05 |
 | `get_token_history` | Historical signals by date range (max 7 days, paginated) | $0.03 |
 
-### Master Intelligence Digest (Cross-Domain Synthesis)
-
-| Tool | Description | Price |
-|------|-------------|-------|
-| `get_intelligence_digest` | Latest cross-domain synthesis of all data sources — executive summary, narratives, signals | $0.01 |
-| `get_intelligence_history` | Historical master digests (1-168 hours lookback) | $0.03 |
-
 ## Environment Variables
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `EVM_PRIVATE_KEY` | Yes | Wallet private key (0x-prefixed) with USDC on Base Mainnet |
+| `EVM_PRIVATE_KEY` | No | Wallet private key (0x-prefixed) with USDC on Base Mainnet. Required for paid tools. |
 | `MOLTALYZER_API_URL` | No | Override API base URL (default: `https://api.moltalyzer.xyz`) |
 
-## How it works
+## How Payments Work
 
-This MCP server wraps the [Moltalyzer x402 API](https://api.moltalyzer.xyz/api). When an AI agent calls a tool, the server:
+When an AI agent calls a paid tool, the server:
 
 1. Makes an HTTP request to the API endpoint
-2. Receives a 402 Payment Required response
+2. Receives a `402 Payment Required` response
 3. Automatically signs a USDC payment on Base using your wallet
 4. Retries the request with the payment signature
 5. Returns the data to the agent
 
-All payments use the [x402 protocol](https://www.x402.org/) — sub-cent micropayments with no API keys, accounts, or subscriptions.
+All payments use the [x402 protocol](https://www.x402.org/) — sub-cent micropayments with no API keys, accounts, or subscriptions required.
 
 ## License
 

package/build/index.d.ts

@@ -1,3 +1,4 @@
 #!/usr/bin/env node
-export {};
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createSandboxServer(): McpServer;
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwEpE,wBAAgB,mBAAmB,cAElC"}

package/build/index.js

@@ -10,42 +10,64 @@ import { register as registerGithub } from "./tools/github.js";
 import { register as registerPolymarket } from "./tools/polymarket.js";
 import { register as registerTokens } from "./tools/tokens.js";
 import { register as registerIntelligence } from "./tools/intelligence.js";
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+import { register as registerFree } from "./tools/free.js";
+import { register as registerPulse } from "./tools/pulse.js";
+// Support both ESM (import.meta.url) and CJS (__dirname) for Smithery scanning
+const __dirname_resolved = typeof import.meta?.url === 'string'
+    ? dirname(fileURLToPath(import.meta.url))
+    : typeof __dirname !== 'undefined' ? __dirname : process.cwd();
+let pkg;
+try {
+    pkg = JSON.parse(readFileSync(join(__dirname_resolved, "..", "package.json"), "utf-8"));
+}
+catch {
+    pkg = { version: "1.3.0" };
+}
 // All logging to stderr (stdout reserved for MCP protocol)
 const log = (...args) => console.error("[moltalyzer-mcp]", ...args);
-// Validate env before starting
-if (!process.env.EVM_PRIVATE_KEY) {
-    log("ERROR: EVM_PRIVATE_KEY environment variable is required.\n" +
-        "Set it to your wallet private key (0x-prefixed hex string) " +
-        "with USDC on Base Mainnet for x402 micropayments.\n\n" +
-        "Example MCP config:\n" +
-        JSON.stringify({
-            mcpServers: {
-                moltalyzer: {
-                    command: "npx",
-                    args: ["-y", "moltalyzer-mcp"],
-                    env: { EVM_PRIVATE_KEY: "0x..." },
-                },
-            },
-        }, null, 2));
-    process.exit(1);
-}
-async function main() {
-    const fetchWithPayment = createFetchWithPayment();
+function createServer() {
     const server = new McpServer({
         name: "moltalyzer-mcp",
         version: pkg.version,
     });
-    // Register all tool modules
-    registerMoltbook(server, fetchWithPayment);
-    registerGithub(server, fetchWithPayment);
-    registerPolymarket(server, fetchWithPayment);
-    registerTokens(server, fetchWithPayment);
-    registerIntelligence(server, fetchWithPayment);
+    // Free tools always available — no wallet or API key needed
+    registerFree(server);
+    const hasWallet = !!process.env.EVM_PRIVATE_KEY;
+    if (hasWallet) {
+        const fetchWithPayment = createFetchWithPayment();
+        registerMoltbook(server, fetchWithPayment);
+        registerGithub(server, fetchWithPayment);
+        registerPolymarket(server, fetchWithPayment);
+        registerTokens(server, fetchWithPayment);
+        registerIntelligence(server, fetchWithPayment);
+        registerPulse(server, fetchWithPayment);
+        log(`Server started with 23 tools (8 free + 15 paid via x402)`);
+    }
+    else {
+        log("WARNING: EVM_PRIVATE_KEY not set — running in free-tier mode (4 tools).\n" +
+            "To unlock all 16 tools with x402 micropayments, add your wallet private key:\n\n" +
+            JSON.stringify({
+                mcpServers: {
+                    moltalyzer: {
+                        command: "npx",
+                        args: ["-y", "moltalyzer-mcp"],
+                        env: { EVM_PRIVATE_KEY: "0x..." },
+                    },
+                },
+            }, null, 2) +
+            "\n\nAlternatively, get a free API key at https://moltalyzer.xyz for 5 digests/day.");
+        log("Server started with 8 free tools");
+    }
+    return server;
+}
+// Smithery sandbox export — allows registry to scan tools without real credentials
+export function createSandboxServer() {
+    return createServer();
+}
+async function main() {
+    const server = createServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    log("Server started with 12 tools");
 }
 main().catch((err) => {
     log("Fatal error:", err);

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE3E,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAErF,2DAA2D;AAC3D,MAAM,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAAC;AAE/E,+BAA+B;AAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;IACjC,GAAG,CACD,4DAA4D;QAC1D,6DAA6D;QAC7D,uDAAuD;QACvD,uBAAuB;QACvB,IAAI,CAAC,SAAS,CACZ;YACE,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,CAAC;oBAC9B,GAAG,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE;iBAClC;aACF;SACF,EACD,IAAI,EACJ,CAAC,CACF,CACJ,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAC;IAElD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC,CAAC;IAEH,4BAA4B;IAC5B,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3C,cAAc,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,cAAc,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzC,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AACtC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/tools/free.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=free.d.ts.map

package/build/tools/free.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"free.d.ts","sourceRoot":"","sources":["../../src/tools/free.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAgFzC"}

package/build/tools/free.js

@@ -0,0 +1,77 @@
+import { BASE_URL, fetchWithTimeout } from "../client.js";
+import { errorResult } from "./error.js";
+export function register(server) {
+    server.registerTool("get_health", {
+        description: "Check Moltalyzer API health and service status — returns overall status (ok/degraded), active job statuses, and x402 facilitator connectivity. Free, no payment or API key required.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetch, `${BASE_URL}/health`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_api_info", {
+        description: "Get Moltalyzer API overview — all available endpoints, pricing per call, recent changelog, and rate limits. Use this to discover what tools and data feeds are available. Free, no payment or API key required.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetch, `${BASE_URL}/api`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_intelligence_sample", {
+        description: "Get a free sample of the Master Intelligence Digest — a cross-domain synthesis combining crypto community sentiment, GitHub trending repos, Polymarket prediction signals, token intelligence, BTC derivatives, Fear & Greed index, and macro data. Generated every 4 hours. Rate limited to 1 request per 20 minutes. No payment or API key required. To get live data, use get_intelligence_digest ($0.01 via x402) or sign up for a free API key at https://moltalyzer.xyz.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetch, `${BASE_URL}/api/intelligence/sample`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_moltbook_sample", {
+        description: "Get a free sample of the Moltbook community digest — AI-generated analysis of crypto community sentiment, trending topics, emerging narratives, and hot discussions. Updated hourly. Rate limited to 1 request per 20 minutes. No payment or API key required. To get live data, use get_moltbook_digest (free, 1 req/5min) or sign up for a free API key at https://moltalyzer.xyz.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetch, `${BASE_URL}/api/moltbook/sample`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_tokens_latest", {
+        description: "Get the most recent token intelligence signal — hybrid rule+LLM scoring across Ethereum, Base, and BSC. Returns symbol, score (0-100), tier (meme/longterm), liquidity, volume, and risk assessment. Free, rate limited to 1 request per 5 minutes. No payment or API key required.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetch, `${BASE_URL}/api/tokens/latest`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_polymarket_latest", {
+        description: "Get the most recent Polymarket predetermined outcome signal — detects markets where the outcome is already known by insiders. Returns question, confidence level, reasoning, and insider type. Free, rate limited to 1 request per 5 minutes. No payment or API key required.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetch, `${BASE_URL}/api/polymarket/latest`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_pulse_brief", {
+        description: "Get the latest Pulse narrative intelligence brief — cross-source AI/business narrative tracking from Reddit, HN, GitHub, and HuggingFace. Returns title, summary, top insights, and narrative count. Free, no payment or API key required.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetch, `${BASE_URL}/api/pulse/ai-business/digest/brief`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_pulse_latest", {
+        description: "Get the full Pulse narrative intelligence digest — narrativeArcs, actionableSignals, sourceMix, and all insights. Tracks how stories form across multiple sources. Free, rate limited to 1 request per 5 minutes. No payment or API key required.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetch, `${BASE_URL}/api/pulse/ai-business/digest/latest`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=free.js.map

package/build/tools/free.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"free.js","sourceRoot":"","sources":["../../src/tools/free.ts"],"names":[],"mappings":"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"}

package/build/tools/pulse.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, fetchFn: typeof fetch): void;
+//# sourceMappingURL=pulse.d.ts.map

package/build/tools/pulse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.d.ts","sourceRoot":"","sources":["../../src/tools/pulse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,KAAK,QAiChE"}

package/build/tools/pulse.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { BASE_URL, fetchWithTimeout } from "../client.js";
+import { errorResult } from "./error.js";
+export function register(server, fetchFn) {
+    server.registerTool("get_pulse_digest", {
+        description: "Get the latest Pulse narrative intelligence digest — cross-source synthesis of AI/business narratives forming across Reddit, HN, GitHub, and HuggingFace. Tracks narrative lifecycle (emerging → developing → peak → fading). Includes narrativeArcs, actionableSignals, sourceMix, and topInsights. Updated every 4 hours. Costs $0.01 USDC via x402.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetchFn, `${BASE_URL}/api/pulse/ai-business/digest/latest`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_pulse_narratives", {
+        description: "Get all active Pulse narratives with lifecycle stage, source count, and momentum. Narratives track specific stories gaining traction across 2+ sources. Costs $0.01 USDC via x402.",
+    }, async () => {
+        const res = await fetchWithTimeout(fetchFn, `${BASE_URL}/api/pulse/ai-business/narratives`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.registerTool("get_pulse_narrative_detail", {
+        description: "Get detailed view of a specific Pulse narrative — full content items, source breakdown, and stage history. Costs $0.01 USDC via x402.",
+        inputSchema: {
+            id: z.number().int().describe("Narrative ID (from get_pulse_narratives)"),
+        },
+    }, async ({ id }) => {
+        const res = await fetchWithTimeout(fetchFn, `${BASE_URL}/api/pulse/ai-business/narratives/${id}`);
+        if (!res.ok)
+            return errorResult(res);
+        const data = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=pulse.js.map

package/build/tools/pulse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../src/tools/pulse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,OAAqB;IAC/D,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE;QACtC,WAAW,EACT,wVAAwV;KAC3V,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,GAAG,QAAQ,sCAAsC,CAAC,CAAC;QAC/F,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,sBAAsB,EAAE;QAC1C,WAAW,EACT,oLAAoL;KACvL,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,GAAG,QAAQ,mCAAmC,CAAC,CAAC;QAC5F,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,4BAA4B,EAAE;QAChD,WAAW,EACT,uIAAuI;QACzI,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;SAC1E;KACF,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QAClB,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,GAAG,QAAQ,qCAAqC,EAAE,EAAE,CAAC,CAAC;QAClG,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "moltalyzer-mcp",
-  "version": "1.1.1",
-  "description": "MCP server for Moltalyzer — crypto intelligence, GitHub trends, and prediction market signals via x402 micropayments",
+  "version": "1.3.0",
+  "description": "MCP server for Moltalyzer — crypto intelligence, GitHub trends, prediction market signals, and cross-source narrative intelligence via x402 micropayments",
   "type": "module",
   "bin": {
     "moltalyzer-mcp": "build/index.js"
@@ -13,6 +13,7 @@
     "build": "tsc && chmod +x build/index.js",
     "prepare": "npm run build"
   },
+  "mcpName": "io.github.jcislo/moltalyzer-mcp",
   "keywords": [
     "mcp",
     "moltalyzer",