kaito-mcp-server 0.2.17 → 1.0.0

package/README.md

@@ -4,15 +4,35 @@
 [![CI](https://github.com/MetaSearch-IO/kaito-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/MetaSearch-IO/kaito-mcp-server/actions/workflows/ci.yml)
 [![license](https://img.shields.io/npm/l/kaito-mcp-server)](./LICENSE)
 
-MCP server for [Kaito AI](https://kaito.ai) crypto market intelligence API. Provides crypto market intelligence tools, reference resources, and prompt templates for sentiment analysis, mindshare tracking, social intelligence, and more.
+MCP proxy for [Kaito AI](https://kaito.ai) crypto market intelligence API. Provides crypto market intelligence tools, reference resources, and prompt templates for sentiment analysis, mindshare tracking, social intelligence, and more.
 
 ## Getting Started
 
 All configurations require a [Kaito API key](https://kaito.ai). Set it as the `KAITO_API_KEY` environment variable.
 
-### Standard configuration
+### Option A: Direct HTTP (recommended)
 
-The following config works across most MCP clients (Claude Desktop, Cursor, Windsurf, etc.):
+For MCP clients that support remote HTTP servers (Claude.ai, Claude Desktop, Claude Code, etc.):
+
+```json
+{
+  "mcpServers": {
+    "kaito": {
+      "type": "http",
+      "url": "https://bff.kaito.ai/api/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+No local installation required.
+
+### Option B: npx (stdio proxy)
+
+For MCP clients that only support local stdio servers:
 
 ```json
 {
@@ -28,39 +48,34 @@ The following config works across most MCP clients (Claude Desktop, Cursor, Wind
 }
 ```
 
-This configuration runs the server over local **stdio** transport.
-
-### Claude.ai (web)
+This runs a thin local proxy that forwards all requests to the Kaito API over HTTP.
 
-The repository in its default form is a local `stdio` MCP server. That works with local MCP clients such as Claude Desktop, Claude Code, Cursor, and VS Code, but it does **not** make the server directly connectable from the Claude web app by itself.
+### Client-specific setup
 
-If you want to use this server in Claude web:
+#### Claude.ai (web)
 
-- deploy it behind a remote HTTP MCP transport, then add it as a remote connector in Claude
-- or use Claude Desktop / another local MCP client instead
+Use [Option A](#option-a-direct-http-recommended) — add it as a remote MCP connector in Claude settings.
 
-Anthropic's current remote MCP support includes tools, prompts, and resources, but this repo ships as local `stdio` by default.
-
-### Claude Desktop (one-click)
+#### Claude Desktop (one-click)
 
 Download the latest [kaito-mcp-server.mcpb](https://github.com/MetaSearch-IO/kaito-mcp-server/releases/latest/download/kaito-mcp-server.mcpb) and open it — Claude Desktop will handle the rest.
 
-> **Note:** MCPB installs a pinned version and does not auto-update. To get the latest version, re-download the `.mcpb` from the latest release — or switch to the [standard configuration](#standard-configuration) which uses `@latest` to always pull the newest version.
+> **Note:** MCPB installs a pinned version and does not auto-update. To get the latest version, re-download the `.mcpb` from the latest release — or switch to the [standard configuration](#option-b-npx-stdio-proxy) which uses `@latest` to always pull the newest version.
 
-### Claude Desktop (manual)
+#### Claude Desktop (manual)
 
-Add the [standard config](#standard-configuration) to your `claude_desktop_config.json`:
+Add [Option A](#option-a-direct-http-recommended) or [Option B](#option-b-npx-stdio-proxy) to your `claude_desktop_config.json`:
 
 - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-### Claude Code
+#### Claude Code
 
 ```bash
 claude mcp add kaito -e KAITO_API_KEY=your-api-key -- npx -y kaito-mcp-server@latest
 ```
 
-### VS Code
+#### VS Code
 
 Add the following to your User Settings (JSON) or `.vscode/settings.json`:
 
@@ -80,11 +95,11 @@ Add the following to your User Settings (JSON) or `.vscode/settings.json`:
 }
 ```
 
-### Cursor
+#### Cursor
 
-Go to **Cursor Settings → MCP → Add new MCP Server**, and paste the [standard config](#standard-configuration).
+Go to **Cursor Settings → MCP → Add new MCP Server**, and paste [Option B](#option-b-npx-stdio-proxy).
 
-### Other MCP Clients
+#### Other MCP Clients
 
 For any MCP-compatible client, the server can be started with:
 
@@ -94,6 +109,13 @@ KAITO_API_KEY=your-api-key npx -y kaito-mcp-server@latest
 
 The transport is **stdio**. Use this command in your client's MCP server configuration.
 
+### Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `KAITO_API_KEY` | Yes | — | Your Kaito API key |
+| `KAITO_MCP_URL` | No | `https://bff.kaito.ai/api/mcp` | Override the remote MCP endpoint (e.g., for staging) |
+
 ## Tools
 
 ### Reference
@@ -103,8 +125,6 @@ The transport is **stdio**. Use this command in your client's MCP server configu
 | `kaito_tokens` | List or search supported token values, symbols, and project names |
 | `kaito_narratives` | List or search supported narrative IDs and display names |
 
-These two tools exist specifically so clients that expose tools but not `resources/read` can still resolve valid token and narrative values before calling other Kaito tools.
-
 ### Search & Discovery
 
 | Tool | Description |
@@ -154,14 +174,6 @@ These two tools exist specifically so clients that expose tools but not `resourc
 | Tokens | `kaito://tokens` | All supported token values, symbols, and project names (no auth required) |
 | Narratives | `kaito://narratives` | All supported narrative IDs (no auth required) |
 
-Some MCP clients expose resources directly and some only expose tools. `kaito_tokens` and `kaito_narratives` provide the same reference data through normal tool calls, so token and narrative resolution still works even when `resources/read` is unavailable.
-
-Practical example:
-
-- if the user asks about "Hyperliquid", call `kaito_tokens` with `query="Hyperliquid"` first
-- use the returned `token` value such as `HYPERLIQUID` in downstream tools
-- keep `symbol` values such as `HYPE` as reference metadata, not as the canonical tool parameter unless that is also the returned token value
-
 ## Prompt Templates
 
 | Prompt | Description |
@@ -183,15 +195,13 @@ npm run build
 
 ### Testing
 
-Smoke tests hit the real Kaito API to verify all endpoints are reachable:
+Integration tests hit the real Kaito API via the proxy:
 
 ```bash
 KAITO_API_KEY=your-key npm test
-KAITO_API_KEY=your-key npm test -- -t "Mindshare & Sentiment"
-KAITO_API_KEY=your-key npm test -- -t "KOL Analytics"
 ```
 
-Resource and reference-lookup tests run without an API key; authenticated endpoint checks are skipped if `KAITO_API_KEY` is not set.
+Tests are skipped if `KAITO_API_KEY` is not set.
 
 ### MCP Inspector
 

package/build/__tests__/proxy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=proxy.test.d.ts.map

package/build/__tests__/proxy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/proxy.test.ts"],"names":[],"mappings":""}

package/build/__tests__/proxy.test.js

@@ -0,0 +1,132 @@
+import { spawn } from "node:child_process";
+import { resolve } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+const ENTRY = resolve(import.meta.dirname, "../../build/index.js");
+const API_KEY = process.env.KAITO_API_KEY;
+const MCP_URL = process.env.KAITO_MCP_URL ?? "https://bff.kaito.ai/api/mcp";
+function shouldSkip() {
+    return !API_KEY;
+}
+/** Send a JSON-RPC request over stdin and read the JSON-RPC response from stdout. */
+function sendRequest(proc, request) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error("Timed out waiting for response")), 30_000);
+        let buffer = "";
+        const onData = (chunk) => {
+            buffer += chunk.toString();
+            // JSON-RPC messages are newline-delimited
+            const lines = buffer.split("\n");
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const parsed = JSON.parse(line);
+                    if (parsed.id === request.id) {
+                        clearTimeout(timeout);
+                        proc.stdout.off("data", onData);
+                        resolve(parsed);
+                        return;
+                    }
+                }
+                catch {
+                    // incomplete JSON, keep buffering
+                }
+            }
+            // Keep the last incomplete line in the buffer
+            buffer = lines[lines.length - 1];
+        };
+        proc.stdout.on("data", onData);
+        proc.stdin.write(JSON.stringify(request) + "\n");
+    });
+}
+describe.skipIf(shouldSkip())("proxy integration", () => {
+    let proc;
+    beforeEach(() => {
+        proc = spawn("node", [ENTRY], {
+            env: {
+                ...process.env,
+                KAITO_API_KEY: API_KEY,
+                KAITO_MCP_URL: MCP_URL,
+            },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+    });
+    afterEach(() => {
+        proc?.kill("SIGTERM");
+    });
+    it("initializes and lists tools", async () => {
+        // Initialize
+        const initRes = await sendRequest(proc, {
+            jsonrpc: "2.0",
+            id: 1,
+            method: "initialize",
+            params: {
+                protocolVersion: "2025-03-26",
+                capabilities: {},
+                clientInfo: { name: "test", version: "0.1.0" },
+            },
+        });
+        expect(initRes.result).toBeDefined();
+        expect(initRes.result.serverInfo?.name).toBe("kaito");
+        // Send initialized notification (required before requests)
+        proc.stdin.write(JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" }) +
+            "\n");
+        // Wait briefly for notification to be processed
+        await new Promise((r) => setTimeout(r, 200));
+        // List tools
+        const toolsRes = await sendRequest(proc, {
+            jsonrpc: "2.0",
+            id: 2,
+            method: "tools/list",
+        });
+        expect(toolsRes.result).toBeDefined();
+        const tools = toolsRes.result.tools;
+        expect(Array.isArray(tools)).toBe(true);
+        expect(tools.length).toBeGreaterThan(0);
+        // Verify known tools exist
+        const toolNames = tools.map((t) => t.name);
+        expect(toolNames).toContain("kaito_entities");
+        expect(toolNames).toContain("kaito_advanced_search");
+    });
+    it("forwards tool calls to remote", async () => {
+        // Initialize
+        await sendRequest(proc, {
+            jsonrpc: "2.0",
+            id: 1,
+            method: "initialize",
+            params: {
+                protocolVersion: "2025-03-26",
+                capabilities: {},
+                clientInfo: { name: "test", version: "0.1.0" },
+            },
+        });
+        proc.stdin.write(JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" }) +
+            "\n");
+        await new Promise((r) => setTimeout(r, 200));
+        // Call kaito_entities (reference lookup)
+        const entitiesRes = await sendRequest(proc, {
+            jsonrpc: "2.0",
+            id: 2,
+            method: "tools/call",
+            params: {
+                name: "kaito_entities",
+                arguments: {},
+            },
+        });
+        expect(entitiesRes.result).toBeDefined();
+        expect(entitiesRes.result.content).toBeDefined();
+        // Call kaito_sentiment_entity (requires auth, exercises full proxy path)
+        const sentimentRes = await sendRequest(proc, {
+            jsonrpc: "2.0",
+            id: 3,
+            method: "tools/call",
+            params: {
+                name: "kaito_sentiment_entity",
+                arguments: { token: "BTC" },
+            },
+        });
+        expect(sentimentRes.result).toBeDefined();
+        expect(sentimentRes.result.content).toBeDefined();
+    });
+});
+//# sourceMappingURL=proxy.test.js.map

package/build/__tests__/proxy.test.js.map

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

package/build/index.js

@@ -1,26 +1,88 @@
 #!/usr/bin/env node
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CURRENT_VERSION } from "./package-metadata.js";
-import { createServer } from "./server.js";
-async function checkForUpdates() {
-    try {
-        const res = await fetch("https://registry.npmjs.org/kaito-mcp-server/latest");
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CURRENT_VERSION, SERVER_NAME } from "./package-metadata.js";
+const DEFAULT_MCP_URL = "https://bff.kaito.ai/api/mcp";
+function checkForUpdates() {
+    fetch("https://registry.npmjs.org/kaito-mcp-server/latest")
+        .then((res) => {
         if (!res.ok)
             return;
-        const { version: latest } = (await res.json());
-        if (latest && latest !== CURRENT_VERSION) {
-            console.error(`\n  kaito-mcp-server update available: ${CURRENT_VERSION} → ${latest}\n  Run: npx kaito-mcp-server@latest\n`);
+        return res.json();
+    })
+        .then((data) => {
+        if (data?.version && data.version !== CURRENT_VERSION) {
+            console.error(`\n  kaito-mcp-server update available: ${CURRENT_VERSION} → ${data.version}\n  Run: npx kaito-mcp-server@latest\n`);
         }
-    }
-    catch {
+    })
+        .catch(() => {
         // silently ignore — network issues should never block the server
-    }
+    });
 }
 async function main() {
-    const server = createServer();
-    const transport = new StdioServerTransport();
+    // 1. Validate env
+    const apiKey = process.env.KAITO_API_KEY;
+    if (!apiKey) {
+        console.error("Error: KAITO_API_KEY environment variable is required.\n" +
+            "Get your API key at https://kaito.ai and set it in your MCP config.");
+        process.exit(1);
+    }
+    const mcpUrl = process.env.KAITO_MCP_URL ?? DEFAULT_MCP_URL;
+    // 2. Connect to remote MCP server
+    const remoteTransport = new StreamableHTTPClientTransport(new URL(mcpUrl), {
+        requestInit: {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+            },
+        },
+    });
+    const remoteClient = new Client({ name: `${SERVER_NAME}-proxy`, version: CURRENT_VERSION }, { capabilities: {} });
+    try {
+        await remoteClient.connect(remoteTransport, { timeout: 30_000 });
+    }
+    catch (err) {
+        console.error(`Failed to connect to Kaito MCP server at ${mcpUrl}: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+    // 3. Create local server with forwarding handlers
+    const localServer = new Server({ name: SERVER_NAME, version: CURRENT_VERSION }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {},
+        },
+    });
+    // Forward tools
+    localServer.setRequestHandler(ListToolsRequestSchema, (req) => remoteClient.listTools(req.params));
+    localServer.setRequestHandler(CallToolRequestSchema, (req) => remoteClient.callTool(req.params));
+    // Forward resources
+    localServer.setRequestHandler(ListResourcesRequestSchema, (req) => remoteClient.listResources(req.params));
+    localServer.setRequestHandler(ReadResourceRequestSchema, (req) => remoteClient.readResource(req.params));
+    localServer.setRequestHandler(ListResourceTemplatesRequestSchema, (req) => remoteClient.listResourceTemplates(req.params));
+    // Forward prompts
+    localServer.setRequestHandler(ListPromptsRequestSchema, (req) => remoteClient.listPrompts(req.params));
+    localServer.setRequestHandler(GetPromptRequestSchema, (req) => remoteClient.getPrompt(req.params));
+    // 4. Serve locally via stdio
+    const stdioTransport = new StdioServerTransport();
+    await localServer.connect(stdioTransport);
+    // 5. Graceful shutdown
+    const cleanup = async () => {
+        try {
+            await localServer.close();
+            await remoteClient.close();
+        }
+        catch {
+            // best-effort cleanup
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+    // 6. Background update check
     checkForUpdates();
-    await server.connect(transport);
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,eAAe;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,oDAAoD,CACrD,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO;QACpB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAC;QACtE,IAAI,MAAM,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CACX,0CAA0C,eAAe,MAAM,MAAM,wCAAwC,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,eAAe,EAAE,CAAC;IAClB,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaito-mcp-server",
-  "version": "0.2.17",
+  "version": "1.0.0",
   "description": "MCP server for Kaito AI crypto market intelligence API",
   "license": "MIT",
   "type": "module",
@@ -19,8 +19,7 @@
     "postversion": "node scripts/sync-manifest-version.js && git add manifest.json && git commit --amend --no-edit && git push"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.0",
-    "zod": "^3.23.0"
+    "@modelcontextprotocol/sdk": "^1.27.0"
   },
   "devDependencies": {
     "@types/node": "^22",

package/build/__tests__/reference-search.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=reference-search.test.d.ts.map

package/build/__tests__/reference-search.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reference-search.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/reference-search.test.ts"],"names":[],"mappings":""}

package/build/__tests__/reference-search.test.js

@@ -1,73 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { lookupNarratives, lookupTokens } from "../reference-search.js";
-describe("lookupTokens", () => {
-    const tokens = [
-        {
-            token: "BTC",
-            symbol: "BTC",
-            fullname: "Bitcoin",
-            coingecko_id: "bitcoin",
-        },
-        {
-            token: "HYPERLIQUID",
-            symbol: "HYPE",
-            fullname: "Hyperliquid",
-            coingecko_id: "hyperliquid",
-        },
-        {
-            token: "ETH",
-            symbol: "ETH",
-            fullname: "Ethereum",
-            coingecko_id: "ethereum",
-        },
-    ];
-    it("matches project names to canonical token values", () => {
-        const result = lookupTokens(tokens, "hyperliquid");
-        expect(result.matches[0]?.token).toBe("HYPERLIQUID");
-        expect(result.matches[0]?.symbol).toBe("HYPE");
-    });
-    it("matches symbols directly", () => {
-        const result = lookupTokens(tokens, "hype");
-        expect(result.matches[0]?.token).toBe("HYPERLIQUID");
-    });
-    it("returns 50 rows by default when browsing without a query", () => {
-        const manyTokens = Array.from({ length: 60 }, (_, index) => ({
-            token: `TOKEN${index}`,
-            symbol: `T${index}`,
-            fullname: `Token ${index}`,
-        }));
-        const result = lookupTokens(manyTokens);
-        expect(result.returned).toBe(50);
-        expect(result.matches).toHaveLength(50);
-        expect(result.browse_note).toContain("first 50 tokens");
-    });
-    it("caps explicit limits at 100", () => {
-        const manyTokens = Array.from({ length: 120 }, (_, index) => ({
-            token: `TOKEN${index}`,
-            symbol: `T${index}`,
-            fullname: `Token ${index}`,
-        }));
-        const result = lookupTokens(manyTokens, undefined, 999);
-        expect(result.returned).toBe(100);
-        expect(result.matches).toHaveLength(100);
-    });
-});
-describe("lookupNarratives", () => {
-    const narratives = [
-        {
-            narrative: "AI",
-            fullname: "Artificial Intelligence",
-            description: "AI-related crypto projects.",
-        },
-        {
-            narrative: "L2",
-            fullname: "Layer 2",
-            description: "Rollups and scaling networks.",
-        },
-    ];
-    it("matches narrative display names", () => {
-        const result = lookupNarratives(narratives, "layer 2");
-        expect(result.matches[0]?.narrative).toBe("L2");
-    });
-});
-//# sourceMappingURL=reference-search.test.js.map

package/build/__tests__/reference-search.test.js.map

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

package/build/__tests__/server-consistency.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=server-consistency.test.d.ts.map

package/build/__tests__/server-consistency.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server-consistency.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/server-consistency.test.ts"],"names":[],"mappings":""}