kaito-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,104 @@
+# kaito-mcp-server
+
+MCP server for [Kaito AI](https://kaito.ai) crypto market intelligence API. Provides 13 tools, 2 resources, and 2 prompt templates for accessing Kaito's sentiment analysis, mindshare tracking, social intelligence, and more.
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```jsonc
+{
+  "mcpServers": {
+    "kaito": {
+      "command": "npx",
+      "args": ["-y", "kaito-mcp-server"],
+      "env": {
+        "KAITO_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add kaito -- npx -y kaito-mcp-server
+```
+
+Set the environment variable `KAITO_API_KEY` before launching.
+
+## Tools
+
+### Market Data
+
+| Tool | Description |
+|------|-------------|
+| `kaito_sentiment` | Daily sentiment time series for a token |
+| `kaito_mindshare` | Daily mindshare time series for a token |
+| `kaito_narrative_mindshare` | Daily mindshare for a crypto narrative |
+| `kaito_mentions` | Daily mention counts by source |
+| `kaito_engagement` | Daily engagement metrics (total + smart) |
+
+### Search
+
+| Tool | Description |
+|------|-------------|
+| `kaito_advanced_search` | Ranked crypto feeds with AI summaries and filters |
+
+### Social
+
+| Tool | Description |
+|------|-------------|
+| `kaito_smart_followers` | Smart follower count or list for a user |
+| `kaito_smart_following` | Latest 100 smart accounts followed by a user |
+| `kaito_reciprocal_followers` | Mutual followers sorted by smart follower count |
+
+### Rankings
+
+| Tool | Description |
+|------|-------------|
+| `kaito_mindshare_arena` | Project rankings by mindshare |
+| `kaito_pre_tge_arena` | Pre-TGE project rankings by mindshare |
+
+### Events
+
+| Tool | Description |
+|------|-------------|
+| `kaito_events` | Upcoming catalyst events for a token |
+| `kaito_tweet_engagement_info` | Engagement details for a specific tweet |
+
+## Resources
+
+| Resource | URI | Description |
+|----------|-----|-------------|
+| Tokens | `kaito://tokens` | All supported token tickers (no auth required) |
+| Narratives | `kaito://narratives` | All supported narrative IDs (no auth required) |
+
+## Prompt Templates
+
+| Prompt | Description |
+|--------|-------------|
+| `analyze_token` | Comprehensive token analysis workflow (sentiment → mindshare → mentions → engagement → events → search) |
+| `discover_trending` | Trending discovery workflow (mindshare arena → pre-TGE arena → search) |
+
+## Development
+
+```bash
+git clone https://github.com/MetaSearch-IO/kaito-mcp-server.git
+cd kaito-mcp-server
+npm install
+npm run build
+```
+
+Test with the MCP Inspector:
+
+```bash
+KAITO_API_KEY=your-key npx @modelcontextprotocol/inspector node build/index.js
+```
+
+## License
+
+MIT

package/build/client.d.ts

@@ -0,0 +1,8 @@
+export declare class KaitoClient {
+    private apiKey;
+    constructor();
+    request(endpoint: string, params: Record<string, string | undefined>, options?: {
+        requireAuth?: boolean;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/build/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAqB;;IAM7B,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC1C,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAClC,OAAO,CAAC,OAAO,CAAC;CAgDpB"}

package/build/client.js

@@ -0,0 +1,39 @@
+import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
+const BASE_URL = "https://api.kaito.ai/api/v1";
+export class KaitoClient {
+    apiKey;
+    constructor() {
+        this.apiKey = process.env.KAITO_API_KEY;
+    }
+    async request(endpoint, params, options) {
+        const requireAuth = options?.requireAuth ?? true;
+        if (requireAuth && !this.apiKey) {
+            throw new McpError(ErrorCode.InvalidRequest, "KAITO_API_KEY environment variable is not set. Please configure it to use this tool.");
+        }
+        const url = new URL(`${BASE_URL}/${endpoint}`);
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined) {
+                url.searchParams.set(key, value);
+            }
+        }
+        const headers = {};
+        if (this.apiKey) {
+            headers["x-api-key"] = this.apiKey;
+        }
+        const response = await fetch(url.toString(), { headers });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            switch (response.status) {
+                case 401:
+                case 403:
+                    throw new McpError(ErrorCode.InvalidRequest, `Authentication failed (${response.status}): ${body || "Invalid API key"}`);
+                case 429:
+                    throw new McpError(ErrorCode.InvalidRequest, `Rate limit exceeded. Kaito API allows 5 requests/second. ${body}`);
+                default:
+                    throw new McpError(ErrorCode.InternalError, `Kaito API error ${response.status}: ${body || response.statusText}`);
+            }
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/build/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,QAAQ,GAAG,6BAA6B,CAAC;AAE/C,MAAM,OAAO,WAAW;IACd,MAAM,CAAqB;IAEnC;QACE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,MAA0C,EAC1C,OAAmC;QAEnC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;QAEjD,IAAI,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,sFAAsF,CACvF,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACrC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAE1D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACxB,KAAK,GAAG,CAAC;gBACT,KAAK,GAAG;oBACN,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,0BAA0B,QAAQ,CAAC,MAAM,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAC3E,CAAC;gBACJ,KAAK,GAAG;oBACN,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,cAAc,EACxB,4DAA4D,IAAI,EAAE,CACnE,CAAC;gBACJ;oBACE,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,mBAAmB,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,EAAE,CACrE,CAAC;YACN,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,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"}

package/build/prompts/workflows.d.ts

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

package/build/prompts/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/prompts/workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QA4EhD"}

package/build/prompts/workflows.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+export function registerPrompts(server) {
+    server.prompt("analyze_token", "Comprehensive analysis of a crypto token: sentiment, mindshare, mentions, engagement, events, and recent news.", {
+        token: z.string().describe("Token ticker (e.g. BTC, ETH)"),
+        days: z
+            .string()
+            .optional()
+            .describe("Number of days to look back (default: 30)"),
+    }, ({ token, days }) => {
+        const lookback = days || "30";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Perform a comprehensive analysis of the crypto token "${token}" over the last ${lookback} days. Follow these steps in order:
+
+1. **Sentiment**: Call kaito_sentiment for ${token} to understand market sentiment trends.
+2. **Mindshare**: Call kaito_mindshare for ${token} to see its share of crypto Twitter conversation.
+3. **Mentions**: Call kaito_mentions for ${token} to track mention volume across sources.
+4. **Engagement**: Call kaito_engagement for ${token} to measure total and smart engagement.
+5. **Events**: Call kaito_events for ${token} to find upcoming catalysts.
+6. **News & Discussion**: Call kaito_advanced_search with tokens=${token} to find the most relevant recent content.
+
+After gathering all data, provide a structured analysis covering:
+- Overall sentiment trend (bullish/bearish/neutral)
+- Mindshare trajectory (growing/declining/stable)
+- Key events and catalysts ahead
+- Notable discussions and news
+- Summary assessment with key takeaways`,
+                    },
+                },
+            ],
+        };
+    });
+    server.prompt("discover_trending", "Discover trending crypto projects and narratives using mindshare rankings and recent content.", {
+        duration: z
+            .string()
+            .optional()
+            .describe("Time window for rankings: 24h, 7d, 30d (default: 24h)"),
+    }, ({ duration }) => {
+        const window = duration || "24h";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Discover what's trending in crypto right now using a ${window} time window. Follow these steps:
+
+1. **Mindshare Arena**: Call kaito_mindshare_arena with duration=${window} to see top projects by mindshare.
+2. **Pre-TGE Arena**: Call kaito_pre_tge_arena with window=${window} to find trending pre-token projects.
+3. **Trending Content**: Call kaito_advanced_search in discovery mode (no tokens/keyword) to see what's trending.
+
+After gathering all data, provide:
+- Top 10 projects by mindshare with their scores
+- Notable Pre-TGE projects gaining attention
+- Key trending topics and discussions
+- Any emerging narratives or themes
+- Summary of the current market mood`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=workflows.js.map

package/build/prompts/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/prompts/workflows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,MAAM,CACX,eAAe,EACf,gHAAgH,EAChH;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC1D,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2CAA2C,CAAC;KACzD,EACD,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QAClB,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,CAAC;QAC9B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,yDAAyD,KAAK,mBAAmB,QAAQ;;6CAEhE,KAAK;6CACL,KAAK;2CACP,KAAK;+CACD,KAAK;uCACb,KAAK;mEACuB,KAAK;;;;;;;wCAOhC;qBAC3B;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,mBAAmB,EACnB,+FAA+F,EAC/F;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,uDAAuD,CAAC;KACrE,EACD,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,QAAQ,IAAI,KAAK,CAAC;QACjC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,wDAAwD,MAAM;;mEAEf,MAAM;6DACZ,MAAM;;;;;;;;qCAQ9B;qBACxB;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/resources/reference.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KaitoClient } from "../client.js";
+export declare function registerResources(server: McpServer, client: KaitoClient): void;
+//# sourceMappingURL=reference.d.ts.map

package/build/resources/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/resources/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAgDvE"}

package/build/resources/reference.js

@@ -0,0 +1,33 @@
+export function registerResources(server, client) {
+    server.resource("tokens", "kaito://tokens", {
+        description: "List of all supported token tickers on Kaito. Use these values for the 'token' parameter in market data tools.",
+        mimeType: "application/json",
+    }, async () => {
+        const data = await client.request("tokens", {}, { requireAuth: false });
+        return {
+            contents: [
+                {
+                    uri: "kaito://tokens",
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.resource("narratives", "kaito://narratives", {
+        description: "List of all supported crypto narrative IDs on Kaito. Use these values for the 'narrative' parameter in kaito_narrative_mindshare.",
+        mimeType: "application/json",
+    }, async () => {
+        const data = await client.request("narratives", {}, { requireAuth: false });
+        return {
+            contents: [
+                {
+                    uri: "kaito://narratives",
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=reference.js.map

package/build/resources/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/resources/reference.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAmB;IACtE,MAAM,CAAC,QAAQ,CACb,QAAQ,EACR,gBAAgB,EAChB;QACE,WAAW,EACT,gHAAgH;QAClH,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QACxE,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,gBAAgB;oBACrB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,YAAY,EACZ,oBAAoB,EACpB;QACE,WAAW,EACT,mIAAmI;QACrI,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAC/B,YAAY,EACZ,EAAE,EACF,EAAE,WAAW,EAAE,KAAK,EAAE,CACvB,CAAC;QACF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,oBAAoB;oBACzB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/server.d.ts

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

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE,wBAAgB,YAAY,IAAI,SAAS,CAsBxC"}

package/build/server.js

@@ -0,0 +1,28 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KaitoClient } from "./client.js";
+import { registerMarketDataTools } from "./tools/market-data.js";
+import { registerSearchTools } from "./tools/search.js";
+import { registerSocialTools } from "./tools/social.js";
+import { registerRankingsTools } from "./tools/rankings.js";
+import { registerEventsTools } from "./tools/events.js";
+import { registerResources } from "./resources/reference.js";
+import { registerPrompts } from "./prompts/workflows.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "kaito",
+        version: "0.1.0",
+    });
+    const client = new KaitoClient();
+    // 13 Tools
+    registerMarketDataTools(server, client);
+    registerSearchTools(server, client);
+    registerSocialTools(server, client);
+    registerRankingsTools(server, client);
+    registerEventsTools(server, client);
+    // 2 Resources
+    registerResources(server, client);
+    // 2 Prompts
+    registerPrompts(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;IAEjC,WAAW;IACX,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC,cAAc;IACd,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,YAAY;IACZ,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/tools/events.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KaitoClient } from "../client.js";
+export declare function registerEventsTools(server: McpServer, client: KaitoClient): void;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/tools/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAoFzE"}

package/build/tools/events.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+const TOOL_ANNOTATIONS = {
+    readOnlyHint: true,
+    openWorldHint: true,
+};
+export function registerEventsTools(server, client) {
+    server.tool("kaito_events", "Get upcoming catalyst events for a token, with filtering by event type, source, and date range. Use the tokens resource to find valid tickers.", {
+        token: z.string().describe("Token ticker (e.g. BTC, ETH)"),
+        start_date: z
+            .string()
+            .optional()
+            .describe("Filter events starting on or after this date YYYY-MM-DD"),
+        end_date: z
+            .string()
+            .optional()
+            .describe("Filter events starting on or before this date YYYY-MM-DD"),
+        min_announcement_date: z
+            .string()
+            .optional()
+            .describe("Announcement date lower bound YYYY-MM-DD"),
+        max_announcement_date: z
+            .string()
+            .optional()
+            .describe("Announcement date upper bound YYYY-MM-DD"),
+        event_types: z
+            .string()
+            .optional()
+            .describe("Comma-separated event types: Mainnet Release, Testnet Release, Roadmap Update, Token Generation Event, Conference Attendance, Proposal and Voting, Tokenomics Update, Token Unlock, Others"),
+        sources: z
+            .string()
+            .optional()
+            .describe("Comma-separated sources: Twitter Space, Twitter, Podcast, Conference, Vote, Governance, DefiLlama, Token Unlocks"),
+        sort_by: z
+            .enum(["event_date", "project_name", "market_cap", "announcement_date"])
+            .optional()
+            .describe("Sort field"),
+        sort_order: z
+            .enum(["asc", "desc"])
+            .optional()
+            .describe("Sort order"),
+    }, TOOL_ANNOTATIONS, async ({ token, start_date, end_date, min_announcement_date, max_announcement_date, event_types, sources, sort_by, sort_order, }) => {
+        const data = await client.request("events", {
+            token,
+            start_date,
+            end_date,
+            min_announcement_date,
+            max_announcement_date,
+            event_types,
+            sources,
+            sort_by,
+            sort_order,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("kaito_tweet_engagement_info", "Get detailed engagement metrics for a specific tweet including likes, retweets, replies, views, and smart engagement count.", {
+        tweet_id: z.string().describe("Twitter tweet ID (numeric string)"),
+    }, TOOL_ANNOTATIONS, async ({ tweet_id }) => {
+        const data = await client.request("tweet_engagement_info", {
+            tweet_id,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=events.js.map

package/build/tools/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/tools/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,gBAAgB,GAAG;IACvB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;CACX,CAAC;AAEX,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAmB;IACxE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,gJAAgJ,EAChJ;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC1D,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,CAAC;QACvE,qBAAqB,EAAE,CAAC;aACrB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0CAA0C,CAAC;QACvD,qBAAqB,EAAE,CAAC;aACrB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0CAA0C,CAAC;QACvD,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,4LAA4L,CAC7L;QACH,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,kHAAkH,CACnH;QACH,OAAO,EAAE,CAAC;aACP,IAAI,CAAC,CAAC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC;aACvE,QAAQ,EAAE;aACV,QAAQ,CAAC,YAAY,CAAC;QACzB,UAAU,EAAE,CAAC;aACV,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;aACrB,QAAQ,EAAE;aACV,QAAQ,CAAC,YAAY,CAAC;KAC1B,EACD,gBAAgB,EAChB,KAAK,EAAE,EACL,KAAK,EACL,UAAU,EACV,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,OAAO,EACP,OAAO,EACP,UAAU,GACX,EAAE,EAAE;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE;YAC1C,KAAK;YACL,UAAU;YACV,QAAQ;YACR,qBAAqB;YACrB,qBAAqB;YACrB,WAAW;YACX,OAAO;YACP,OAAO;YACP,UAAU;SACX,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,6BAA6B,EAC7B,6HAA6H,EAC7H;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KACnE,EACD,gBAAgB,EAChB,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE;YACzD,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/market-data.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KaitoClient } from "../client.js";
+export declare function registerMarketDataTools(server: McpServer, client: KaitoClient): void;
+//# sourceMappingURL=market-data.d.ts.map

package/build/tools/market-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-data.d.ts","sourceRoot":"","sources":["../../src/tools/market-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,WAAW,QAgKpB"}

package/build/tools/market-data.js

@@ -0,0 +1,132 @@
+import { z } from "zod";
+const TOOL_ANNOTATIONS = {
+    readOnlyHint: true,
+    openWorldHint: true,
+};
+export function registerMarketDataTools(server, client) {
+    server.tool("kaito_sentiment", "Get daily sentiment time series for a crypto token. Returns volume-weighted bullish/bearish scores and notable events. Use the tokens resource to find valid tickers.", {
+        token: z.string().describe("Token ticker (e.g. BTC, ETH)"),
+        start_date: z
+            .string()
+            .optional()
+            .describe("Start date YYYY-MM-DD (default: 30 days ago, earliest: 2020-01-01)"),
+        end_date: z
+            .string()
+            .optional()
+            .describe("End date YYYY-MM-DD (default: tomorrow)"),
+        adjusted: z
+            .boolean()
+            .optional()
+            .describe("Include replies/quotes, exclude org accounts, weight by smart engagement (default: true)"),
+        average: z
+            .boolean()
+            .optional()
+            .describe("Return average sentiment -1 to +1 instead of absolute volume-weighted (default: false)"),
+        gaussian: z
+            .boolean()
+            .optional()
+            .describe("Apply Gaussian smoothing (default: true)"),
+        language: z
+            .enum(["all", "en", "zh", "ko", "others"])
+            .optional()
+            .describe("Language filter (default: all)"),
+        version: z
+            .enum(["2", "3"])
+            .optional()
+            .describe("Sentiment model version (default: 3)"),
+    }, TOOL_ANNOTATIONS, async ({ token, start_date, end_date, adjusted, average, gaussian, language, version }) => {
+        const data = await client.request("sentiment", {
+            token,
+            start_date,
+            end_date,
+            adjusted: adjusted?.toString(),
+            average: average?.toString(),
+            gaussian: gaussian?.toString(),
+            language,
+            version,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("kaito_mindshare", "Get daily mindshare time series for a crypto token. Mindshare = proportion of crypto Twitter conversation about this token. Use the tokens resource to find valid tickers.", {
+        token: z.string().describe("Token ticker (e.g. BTC, ETH)"),
+        start_date: z
+            .string()
+            .optional()
+            .describe("Start date YYYY-MM-DD (default: 30 days ago, earliest: 2020-01-01)"),
+        end_date: z
+            .string()
+            .optional()
+            .describe("End date YYYY-MM-DD (default: tomorrow)"),
+        scope: z
+            .string()
+            .optional()
+            .describe("Set to 'pretge' to filter for Pre-TGE projects only"),
+    }, TOOL_ANNOTATIONS, async ({ token, start_date, end_date, scope }) => {
+        const data = await client.request("mindshare", {
+            token,
+            start_date,
+            end_date,
+            scope,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("kaito_narrative_mindshare", "Get daily mindshare time series for a crypto narrative (e.g. AI, DeFi, L2). Use the narratives resource to find valid narrative IDs.", {
+        narrative: z.string().describe("Narrative ID (e.g. AI, DeFi). See narratives resource."),
+        start_date: z
+            .string()
+            .optional()
+            .describe("Start date YYYY-MM-DD (default: 30 days ago, earliest: 2023-01-01)"),
+        end_date: z
+            .string()
+            .optional()
+            .describe("End date YYYY-MM-DD (default: tomorrow)"),
+    }, TOOL_ANNOTATIONS, async ({ narrative, start_date, end_date }) => {
+        const data = await client.request("narrative_mindshare", {
+            narrative,
+            start_date,
+            end_date,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("kaito_mentions", "Get daily mention counts for a token or keyword, broken down by source (Twitter, Discord, News, etc.).", {
+        token: z.string().optional().describe("Token ticker (e.g. BTC, ETH)"),
+        keyword: z.string().optional().describe("Search keyword"),
+        start_date: z
+            .string()
+            .optional()
+            .describe("Start date YYYY-MM-DD (earliest: 2023-01-01)"),
+        end_date: z
+            .string()
+            .optional()
+            .describe("End date YYYY-MM-DD (default: today)"),
+    }, TOOL_ANNOTATIONS, async ({ token, keyword, start_date, end_date }) => {
+        const data = await client.request("mentions", {
+            token,
+            keyword,
+            start_date,
+            end_date,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("kaito_engagement", "Get daily engagement metrics (total + smart/KOL engagement) for a token or keyword.", {
+        token: z.string().optional().describe("Token ticker (e.g. BTC, ETH)"),
+        keyword: z.string().optional().describe("Search keyword"),
+        start_date: z
+            .string()
+            .optional()
+            .describe("Start date YYYY-MM-DD (earliest: 2023-01-01)"),
+        end_date: z
+            .string()
+            .optional()
+            .describe("End date YYYY-MM-DD (default: today)"),
+    }, TOOL_ANNOTATIONS, async ({ token, keyword, start_date, end_date }) => {
+        const data = await client.request("engagement", {
+            token,
+            keyword,
+            start_date,
+            end_date,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=market-data.js.map

package/build/tools/market-data.js.map

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

package/build/tools/rankings.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KaitoClient } from "../client.js";
+export declare function registerRankingsTools(server: McpServer, client: KaitoClient): void;
+//# sourceMappingURL=rankings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rankings.d.ts","sourceRoot":"","sources":["../../src/tools/rankings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAuE3E"}

package/build/tools/rankings.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+const TOOL_ANNOTATIONS = {
+    readOnlyHint: true,
+    openWorldHint: true,
+};
+export function registerRankingsTools(server, client) {
+    server.tool("kaito_mindshare_arena", "Get project rankings by mindshare score, with optional category and time window filters. Returns up to 100 projects sorted by mindshare.", {
+        duration: z
+            .enum(["all", "24h", "48h", "7d", "30d", "3m", "6m", "12m"])
+            .optional()
+            .describe("Time window (default: 24h)"),
+        language: z
+            .enum(["all", "en", "zh", "ko", "others"])
+            .optional()
+            .describe("Language filter (default: all)"),
+        categories: z
+            .string()
+            .optional()
+            .describe("Comma-separated categories (e.g. L1,DEFI). Case-insensitive."),
+        pre_tge: z
+            .boolean()
+            .optional()
+            .describe("Set true to filter Pre-TGE projects"),
+        ex_official: z
+            .boolean()
+            .optional()
+            .describe("Exclude official project accounts (default: false)"),
+        weighted: z
+            .boolean()
+            .optional()
+            .describe("Weight by smart engagement (default: true)"),
+        nft: z
+            .boolean()
+            .optional()
+            .describe("Include NFT projects (default: false)"),
+    }, TOOL_ANNOTATIONS, async ({ duration, language, categories, pre_tge, ex_official, weighted, nft }) => {
+        const data = await client.request("mindshare_arena", {
+            duration,
+            language,
+            categories,
+            pre_tge: pre_tge?.toString(),
+            ex_official: ex_official?.toString(),
+            weighted: weighted?.toString(),
+            nft: nft?.toString(),
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("kaito_pre_tge_arena", "Get Pre-TGE (pre-token generation event) project rankings by mindshare. Returns up to 100 projects.", {
+        window: z
+            .enum(["all", "24h", "48h", "7d", "30d", "3m", "6m", "12m"])
+            .optional()
+            .describe("Time window (default: 24h)"),
+        language: z
+            .enum(["all", "en", "zh", "others"])
+            .optional()
+            .describe("Language filter (default: all)"),
+    }, TOOL_ANNOTATIONS, async ({ window, language }) => {
+        const data = await client.request("pre_tge_arena", {
+            window,
+            language,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=rankings.js.map

package/build/tools/rankings.js.map

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

package/build/tools/search.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KaitoClient } from "../client.js";
+export declare function registerSearchTools(server: McpServer, client: KaitoClient): void;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAsIzE"}

package/build/tools/search.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+export function registerSearchTools(server, client) {
+    server.tool("kaito_advanced_search", "Search ranked crypto feeds (Twitter & News) with AI summaries, sentiment scores, and extensive filters. Omit tokens/keyword/usernames for discovery mode (trending content).", {
+        tokens: z
+            .string()
+            .optional()
+            .describe("Comma-separated token tickers (e.g. BTC,ETH)"),
+        keyword: z.string().optional().describe("Search keyword"),
+        usernames: z
+            .string()
+            .optional()
+            .describe("Comma-separated Twitter usernames (Twitter source only)"),
+        sources: z
+            .string()
+            .optional()
+            .describe("Comma-separated: Twitter, News (default: Twitter,News)"),
+        min_created_at: z
+            .string()
+            .optional()
+            .describe("Min creation date ISO 8601 (default: 90 days ago)"),
+        max_created_at: z
+            .string()
+            .optional()
+            .describe("Max creation date ISO 8601"),
+        from: z
+            .number()
+            .optional()
+            .describe("Pagination offset 0-500 (default: 0)"),
+        size: z
+            .number()
+            .optional()
+            .describe("Results per page 1-20 (default: 20)"),
+        languages: z
+            .string()
+            .optional()
+            .describe("Comma-separated: en, zh, ko, others (default: en)"),
+        sort_by: z
+            .enum(["relevance", "created_at", "engagement", "smart_engagement", "author", "length", "bookmark", "sentiment", "views"])
+            .optional()
+            .describe("Sort field (default: relevance)"),
+        sort_order: z
+            .enum(["asc", "desc"])
+            .optional()
+            .describe("Sort order (default: desc). asc only works with created_at and sentiment"),
+        tweet_length_type: z
+            .enum(["short", "long", "thread", "article"])
+            .optional()
+            .describe("Twitter only: tweet length type"),
+        tweet_type: z
+            .enum(["tweet", "quote", "reply"])
+            .optional()
+            .describe("Twitter only: tweet type"),
+        sentiment_type: z
+            .enum(["bullish", "bearish", "neutral"])
+            .optional()
+            .describe("Twitter only: sentiment filter"),
+        author_type: z
+            .enum(["Organization", "Individual"])
+            .optional()
+            .describe("Twitter only: author type"),
+        min_bookmark_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: min bookmarks"),
+        max_bookmark_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: max bookmarks"),
+        min_view_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: min views"),
+        max_view_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: max views"),
+        min_smart_engagement_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: min smart engagements"),
+        max_smart_engagement_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: max smart engagements"),
+        min_like_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: min likes"),
+        max_like_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: max likes"),
+        min_reply_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: min replies"),
+        max_reply_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: max replies"),
+        min_retweet_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: min retweets"),
+        max_retweet_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: max retweets"),
+        min_quote_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: min quotes"),
+        max_quote_count: z
+            .number()
+            .optional()
+            .describe("Twitter only: max quotes"),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: true,
+    }, async (params) => {
+        const queryParams = {};
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined) {
+                queryParams[key] = value.toString();
+            }
+        }
+        const data = await client.request("advanced_search", queryParams);
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=search.js.map

package/build/tools/search.js.map

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

package/build/tools/social.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { KaitoClient } from "../client.js";
+export declare function registerSocialTools(server: McpServer, client: KaitoClient): void;
+//# sourceMappingURL=social.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"social.d.ts","sourceRoot":"","sources":["../../src/tools/social.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,QAoFzE"}

package/build/tools/social.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+const TOOL_ANNOTATIONS = {
+    readOnlyHint: true,
+    openWorldHint: true,
+};
+export function registerSocialTools(server, client) {
+    server.tool("kaito_smart_followers", "Get smart follower data for a Twitter user. 'count' mode returns cumulative smart follower count; 'users' mode returns the list of smart followers gained on a specific date.", {
+        user_id: z
+            .string()
+            .optional()
+            .describe("Twitter user ID. One of user_id or username is required."),
+        username: z
+            .string()
+            .optional()
+            .describe("Twitter username. One of user_id or username is required."),
+        date: z
+            .string()
+            .optional()
+            .describe("Date YYYY-MM-DD (default: yesterday, must be >= 2024-01-01)"),
+        mode: z
+            .enum(["count", "users"])
+            .optional()
+            .describe("'count' for cumulative count, 'users' for follower list (default: count)"),
+    }, TOOL_ANNOTATIONS, async ({ user_id, username, date, mode }) => {
+        const data = await client.request("smart_followers", {
+            user_id,
+            username,
+            date,
+            mode,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("kaito_smart_following", "Get the latest 100 smart accounts followed by a Twitter user, in reverse chronological order.", {
+        user_id: z
+            .string()
+            .optional()
+            .describe("Twitter user ID. One of user_id or username is required."),
+        username: z
+            .string()
+            .optional()
+            .describe("Twitter username. One of user_id or username is required."),
+        category: z
+            .enum(["ALL", "Organization", "Individual"])
+            .optional()
+            .describe("Filter by account type"),
+    }, TOOL_ANNOTATIONS, async ({ user_id, username, category }) => {
+        const data = await client.request("smart_following", {
+            user_id,
+            username,
+            category,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool("kaito_reciprocal_followers", "Get reciprocal (mutual) followers for a Twitter user, sorted by smart follower count descending.", {
+        user_id: z
+            .string()
+            .optional()
+            .describe("Twitter user ID. One of user_id or username is required."),
+        username: z
+            .string()
+            .optional()
+            .describe("Twitter username. One of user_id or username is required."),
+    }, TOOL_ANNOTATIONS, async ({ user_id, username }) => {
+        const data = await client.request("reciprocal_followers", {
+            user_id,
+            username,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=social.js.map

package/build/tools/social.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "kaito-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Kaito AI crypto market intelligence API",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "kaito-mcp-server": "./build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node build/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5.7.0"
+  }
+}