@agentkey/mcp 0.0.4 → 0.0.6

package/dist/index.js

@@ -41,12 +41,13 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const readline = __importStar(require("readline"));
+const dynamic_js_1 = require("./dynamic.js");
 // --- Configuration ---
 const AGENTKEY_BASE_URL = process.env.AGENTKEY_BASE_URL || "https://api.agentkey.app";
 const AGENTKEY_API_KEY = process.env.AGENTKEY_API_KEY || "";
 // --- CLI: --list-tools ---
 if (process.argv.includes("--list-tools")) {
-    console.log(`AgentKey MCP Server v0.0.4
+    console.log(`AgentKey MCP Server v0.0.6
 
 Tools:
   agentkey_search    Search the web, news, images, videos, or places
@@ -54,7 +55,9 @@ Tools:
   agentkey_scrape    Scrape a webpage and extract content as markdown/html/text
                      Providers: Firecrawl, Jina Reader, ScrapeNinja
   agentkey_social    Query social media (search, posts, comments, user profiles)
-                     Platforms: Twitter/X, Reddit
+                     Platforms: Twitter, Reddit, Xiaohongshu, Instagram, Zhihu, TikTok, Douyin, Bilibili, Weibo, Threads, YouTube
+  agentkey_crypto    Query blockchain & crypto data (prices, NFTs, balances, txs, ENS)
+                     Provider: Chainbase
 
 Environment:
   AGENTKEY_BASE_URL  API base URL (default: https://api.agentkey.app)
@@ -273,7 +276,7 @@ else {
                 ok: false,
                 status: 429,
                 data: {
-                    error: "Rate limit exceeded. Please wait a moment and try again, or upgrade your plan at https://agentkey.app",
+                    error: "Rate limit exceeded. Do NOT retry immediately — tell the user the service is busy and suggest trying again in a few seconds.",
                 },
             };
         }
@@ -292,320 +295,756 @@ else {
             ],
         };
     }
+    /**
+     * Compact search results to reduce token consumption.
+     * Strips fields that are empty/null/zero and removes indentation.
+     */
+    function compactResult(data) {
+        const compact = JSON.parse(JSON.stringify(data, (_, v) => v === null || v === "" || v === 0 || (Array.isArray(v) && v.length === 0) ? undefined : v));
+        return {
+            content: [
+                { type: "text", text: JSON.stringify(compact) },
+            ],
+        };
+    }
     // --- MCP Server ---
     const server = new mcp_js_1.McpServer({
         name: "AgentKey",
-        version: "0.0.4",
+        version: "0.0.6",
+        description: `AgentKey provides 4 tools: search, scrape, social, crypto.
+
+MOST IMPORTANT RULE — USE YOUR OWN KNOWLEDGE FIRST:
+- If you can answer from your training data (facts, concepts, history, definitions, explanations), do so WITHOUT calling any tool.
+- Only call a tool when the user needs REAL-TIME or RECENT data that is beyond your knowledge cutoff.
+- Examples that need NO tool: "what is DeFi", "explain OAuth", "compare React vs Vue", "who is Vitalik Buterin", "what is proof of stake".
+- Examples that NEED a tool: "BTC price now", "latest news about OpenAI", "trending on Twitter today", "current top holders of USDT".
+
+DECISION TREE (only when a tool IS needed):
+1. Crypto prices, on-chain data, wallets, NFTs → agentkey_crypto
+2. Social media content (Twitter, Reddit, Instagram, etc.) → agentkey_social
+3. Full content of a specific URL → agentkey_scrape
+4. Web search, news, general real-time info → agentkey_search
+
+GLOBAL RULES:
+- Call at most ONE tool per turn. Never batch multiple tool calls in parallel.
+- Analyze results before deciding if another call is needed.
+- If a tool returns useful results, answer the user — do not call another tool "for more context".
+- Prefer the most specific tool. agentkey_crypto > agentkey_search for "BTC price". agentkey_social > agentkey_search for "what people think about X on Twitter".`,
     });
-    // Search tool
-    server.tool("agentkey_search", `Search the web, news, images, videos, or places via AgentKey unified API.
+    // --- Built-in (static) tool definitions ---
+    // Only used as fallback when the REST API server is unreachable for dynamic loading.
+    function registerBuiltinTools() {
+        // Search tool
+        server.tool("agentkey_search", `Search the web, news, images, videos, or places via AgentKey unified API.
 Aggregates results from Serper, Tavily, Brave, and Perplexity with automatic failover.
 
-IMPORTANT: Do NOT use this tool for Twitter/X or Reddit queries. Use the "agentkey_social" tool instead for any social media content, discussions, tweets, or Reddit posts.
+THINK BEFORE CALLING — use your own knowledge first:
+- If you can answer from your training data (facts, concepts, history, definitions), do so WITHOUT calling this tool.
+- Only call when the user needs REAL-TIME or RECENT information beyond your knowledge cutoff.
+- Examples that do NOT need search: "what is kubernetes", "explain OAuth 2.0", "compare React vs Vue".
+- Examples that NEED search: "latest news about OpenAI", "current stock price of AAPL", "what happened in tech this week".
+- If the user explicitly says "search for" or "look up", respect that intent and call.
+
+ROUTING — use the right tool:
+- Social media queries (Twitter, Reddit, Instagram, etc.) → use agentkey_social instead.
+- Crypto prices or on-chain data → use agentkey_crypto instead.
+
+STRICT RULE — MAXIMUM ONE SEARCH CALL AT A TIME:
+- You MUST call this tool at most ONCE per turn. Wait for results, analyze them, and only then decide if another search is needed.
+- NEVER batch multiple search calls in parallel.
+
+QUERY OPTIMIZATION:
+- ONE well-crafted query beats multiple narrow queries. For "latest news about X", search "X" with type="news" and time_range="week" — do NOT split into "X funding", "X partnership", "X product launch" as separate calls.
+- Do NOT search the same topic from different angles or in multiple languages. Use one comprehensive query.
+- If you already have a URL from search results and need details, use agentkey_scrape instead of searching again.
+- Default num to 5. Use 10 only when the user explicitly needs comprehensive results.
 
 Preferences:
-- Default provider to "auto" for best speed and reliability. Use a specific provider only when the user explicitly requests it.
-- Set "lang" based on the language of the user's query (e.g. Chinese→"zh", English→"en", Japanese→"ja"). The user can also explicitly override.
-- Default num to 10 unless the user specifies otherwise.
+- Default provider to "auto" for best speed and reliability.
+- Set "lang" based on the language of the user's query (e.g. Chinese→"zh", English→"en", Japanese→"ja").
 - Default type to "web" unless the user asks for news, images, videos, or places.
 - Use time_range when the user asks for "recent", "latest", "this week", "today" etc.
 - Use include_domains/exclude_domains when the user wants results from or excluding specific sites.`, {
-        query: zod_1.z.string().describe("Search query"),
-        provider: zod_1.z
-            .enum(["auto", "serper", "tavily", "brave", "perplexity"])
-            .optional()
-            .describe("Search provider. Default 'auto' (fastest & cheapest). Only specify when user explicitly asks."),
-        type: zod_1.z
-            .enum(["web", "news", "images", "videos", "places"])
-            .optional()
-            .describe("Search type. Default 'web'. Use 'news' for recent articles, 'images' for pictures, 'videos' for video content, 'places' for locations/businesses."),
-        search_depth: zod_1.z
-            .enum(["basic", "advanced"])
-            .optional()
-            .describe("Search depth. 'basic' for fast results, 'advanced' for more thorough and detailed results. Default 'basic'."),
-        num: zod_1.z
-            .coerce.number()
-            .min(1)
-            .max(50)
-            .optional()
-            .describe("Number of results, default 10"),
-        country: zod_1.z
-            .string()
-            .optional()
-            .describe("Country code (ISO 3166-1 alpha-2) to localize results, e.g. 'us', 'cn', 'jp'"),
-        lang: zod_1.z
-            .string()
-            .optional()
-            .describe("Language code for results. Auto-detect from user's query language: Chinese→'zh', English→'en', Japanese→'ja', etc. User can override."),
-        time_range: zod_1.z
-            .enum(["day", "week", "month", "year"])
-            .optional()
-            .describe("Time range filter. Use 'day' for today, 'week' for this week, 'month' for this month, 'year' for this year. Useful for news and recent content."),
-        include_domains: zod_1.z
-            .array(zod_1.z.string())
-            .optional()
-            .describe("Only include results from these domains, e.g. ['github.com', 'arxiv.org']"),
-        exclude_domains: zod_1.z
-            .array(zod_1.z.string())
-            .optional()
-            .describe("Exclude results from these domains, e.g. ['pinterest.com', 'quora.com']"),
-        page: zod_1.z
-            .coerce.number()
-            .min(1)
-            .optional()
-            .describe("Page number for pagination, starting from 1"),
-    }, async ({ query, provider, type, search_depth, num, country, lang, time_range, include_domains, exclude_domains, page, }) => {
-        const body = {
-            query,
-            provider: provider || "auto",
-        };
-        if (type)
-            body.type = type;
-        if (search_depth)
-            body.search_depth = search_depth;
-        if (num)
-            body.num = num;
-        if (country)
-            body.country = country;
-        if (lang)
-            body.lang = lang;
-        if (time_range)
-            body.time_range = time_range;
-        if (include_domains?.length)
-            body.include_domains = include_domains;
-        if (exclude_domains?.length)
-            body.exclude_domains = exclude_domains;
-        if (page)
-            body.page = page;
-        try {
-            const { ok, data } = await callAPI("/v1/search", body);
-            if (!ok) {
-                return errorResult(`Search failed: ${data.error || JSON.stringify(data)}`);
+            query: zod_1.z.string().describe("Search query"),
+            provider: zod_1.z
+                .enum(["auto", "serper", "tavily", "brave", "perplexity"])
+                .optional()
+                .describe("Search provider. Default 'auto' (fastest & cheapest). Only specify when user explicitly asks."),
+            type: zod_1.z
+                .enum(["web", "news", "images", "videos", "places"])
+                .optional()
+                .describe("Search type. Default 'web'. Use 'news' for recent articles, 'images' for pictures, 'videos' for video content, 'places' for locations/businesses."),
+            search_depth: zod_1.z
+                .enum(["basic", "advanced"])
+                .optional()
+                .describe("Search depth. 'basic' for fast results, 'advanced' for more thorough and detailed results. Default 'basic'."),
+            num: zod_1.z
+                .coerce.number()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Number of results, default 5. Use 10 only when user needs comprehensive coverage."),
+            country: zod_1.z
+                .string()
+                .optional()
+                .describe("Country code (ISO 3166-1 alpha-2) to localize results, e.g. 'us', 'cn', 'jp'"),
+            lang: zod_1.z
+                .string()
+                .optional()
+                .describe("Language code for results. Auto-detect from user's query language: Chinese→'zh', English→'en', Japanese→'ja', etc. User can override."),
+            time_range: zod_1.z
+                .enum(["day", "week", "month", "year"])
+                .optional()
+                .describe("Time range filter. Use 'day' for today, 'week' for this week, 'month' for this month, 'year' for this year. Useful for news and recent content."),
+            include_domains: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Only include results from these domains, e.g. ['github.com', 'arxiv.org']"),
+            exclude_domains: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Exclude results from these domains, e.g. ['pinterest.com', 'quora.com']"),
+            page: zod_1.z
+                .coerce.number()
+                .min(1)
+                .optional()
+                .describe("Page number for pagination, starting from 1"),
+        }, async ({ query, provider, type, search_depth, num, country, lang, time_range, include_domains, exclude_domains, page, }) => {
+            const body = {
+                query,
+                provider: provider || "auto",
+            };
+            if (type)
+                body.type = type;
+            if (search_depth)
+                body.search_depth = search_depth;
+            if (num)
+                body.num = num;
+            if (country)
+                body.country = country;
+            if (lang)
+                body.lang = lang;
+            if (time_range)
+                body.time_range = time_range;
+            if (include_domains?.length)
+                body.include_domains = include_domains;
+            if (exclude_domains?.length)
+                body.exclude_domains = exclude_domains;
+            if (page)
+                body.page = page;
+            try {
+                const { ok, data } = await callAPI("/v1/search", body);
+                if (!ok) {
+                    return errorResult(`Search failed: ${data.error || JSON.stringify(data)}`);
+                }
+                const results = data.results;
+                const count = results?.length ?? 0;
+                const hint = count > 0
+                    ? `\n\n[${count} results returned. Analyze these before making additional searches. Use agentkey_scrape only if you need the full content of a specific URL above.]`
+                    : `\n\n[No results. Try broader keywords or a different type/time_range. Do NOT retry the same query.]`;
+                const compact = compactResult(data);
+                compact.content[0].text += hint;
+                return compact;
             }
-            return textResult(data);
-        }
-        catch (err) {
-            return errorResult(`Failed to connect to AgentKey server at ${AGENTKEY_BASE_URL}: ${err}`);
-        }
-    });
-    // Scrape tool
-    server.tool("agentkey_scrape", `Scrape a webpage and extract its content as markdown, HTML, text, or screenshot via AgentKey unified API.
+            catch (err) {
+                return errorResult(`Failed to connect to AgentKey server at ${AGENTKEY_BASE_URL}: ${err}`);
+            }
+        });
+        // Scrape tool
+        server.tool("agentkey_scrape", `Scrape a webpage and extract its content as markdown, HTML, text, or screenshot via AgentKey unified API.
 Aggregates Firecrawl, Jina Reader, and ScrapeNinja with automatic failover.
 
+THINK BEFORE CALLING — scraping is expensive:
+- Only scrape when you have a specific URL AND need its CURRENT content.
+- If the user asks about a concept or topic, use agentkey_search first — do NOT jump to scraping.
+- Never scrape speculatively or "just to check". You must have a clear reason to read a specific page.
+- If search results already contain enough information (snippets, descriptions), do NOT scrape the source URL.
+
+STRICT RULE — MAXIMUM ONE SCRAPE CALL AT A TIME:
+- You MUST call this tool at most ONCE per turn. Do NOT batch-scrape multiple URLs in parallel.
+- Scrape only the single most relevant URL. NEVER scrape 2+ pages "to be thorough".
+
 Preferences:
 - Default provider to "auto" (uses Jina Reader — fastest and cheapest).
 - Default format to "markdown" which is best for LLM consumption.
 - Use "include_links": true when the user wants to know what links are on the page.
 - Use CSS selectors (include_selectors/exclude_selectors) when the user wants specific parts of the page.
 - Use "screenshot" format only when the user explicitly asks to see what the page looks like.`, {
-        url: zod_1.z
-            .string()
-            .describe("URL to scrape (must start with http:// or https://)"),
-        provider: zod_1.z
-            .enum(["auto", "firecrawl", "jina", "scrapeninja"])
-            .optional()
-            .describe("Scrape provider. Default 'auto' (Jina Reader). Use 'firecrawl' for JS-heavy pages or advanced extraction."),
-        format: zod_1.z
-            .enum(["markdown", "html", "text", "screenshot"])
-            .optional()
-            .describe("Output format. Default 'markdown'. Best for LLM consumption."),
-        include_selectors: zod_1.z
-            .array(zod_1.z.string())
-            .optional()
-            .describe("CSS selectors to include, e.g. ['.article', '#main-content']"),
-        exclude_selectors: zod_1.z
-            .array(zod_1.z.string())
-            .optional()
-            .describe("CSS selectors to exclude, e.g. ['.nav', '.footer', '.sidebar']"),
-        include_links: zod_1.z
-            .boolean()
-            .optional()
-            .describe("Include extracted links from the page"),
-        include_images: zod_1.z
-            .boolean()
-            .optional()
-            .describe("Include extracted image URLs from the page"),
-        timeout: zod_1.z
-            .coerce.number()
-            .min(1)
-            .max(120)
-            .optional()
-            .describe("Timeout in seconds, default 30"),
-        country: zod_1.z
-            .string()
-            .optional()
-            .describe("Proxy country code for geo-restricted content, e.g. 'us', 'cn'"),
-        wait_for: zod_1.z
-            .coerce.number()
-            .optional()
-            .describe("Wait milliseconds before extracting content. Useful for pages with delayed JS rendering."),
-    }, async ({ url, provider, format, include_selectors, exclude_selectors, include_links, include_images, timeout, country, wait_for, }) => {
-        const body = {
-            url,
-            provider: provider || "auto",
-        };
-        if (format)
-            body.format = format;
-        if (include_selectors?.length)
-            body.include_selectors = include_selectors;
-        if (exclude_selectors?.length)
-            body.exclude_selectors = exclude_selectors;
-        if (include_links)
-            body.include_links = include_links;
-        if (include_images)
-            body.include_images = include_images;
-        if (timeout)
-            body.timeout = timeout;
-        if (country)
-            body.country = country;
-        if (wait_for)
-            body.wait_for = wait_for;
-        try {
-            const { ok, data } = await callAPI("/v1/scrape", body);
-            if (!ok) {
-                return errorResult(`Scrape failed: ${data.error || JSON.stringify(data)}`);
+            url: zod_1.z
+                .string()
+                .describe("URL to scrape (must start with http:// or https://)"),
+            provider: zod_1.z
+                .enum(["auto", "firecrawl", "jina", "scrapeninja"])
+                .optional()
+                .describe("Scrape provider. Default 'auto' (Jina Reader). Use 'firecrawl' for JS-heavy pages or advanced extraction."),
+            format: zod_1.z
+                .enum(["markdown", "html", "text", "screenshot"])
+                .optional()
+                .describe("Output format. Default 'markdown'. Best for LLM consumption."),
+            include_selectors: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("CSS selectors to include, e.g. ['.article', '#main-content']"),
+            exclude_selectors: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("CSS selectors to exclude, e.g. ['.nav', '.footer', '.sidebar']"),
+            include_links: zod_1.z
+                .boolean()
+                .optional()
+                .describe("Include extracted links from the page"),
+            include_images: zod_1.z
+                .boolean()
+                .optional()
+                .describe("Include extracted image URLs from the page"),
+            timeout: zod_1.z
+                .coerce.number()
+                .min(1)
+                .max(120)
+                .optional()
+                .describe("Timeout in seconds, default 30"),
+            country: zod_1.z
+                .string()
+                .optional()
+                .describe("Proxy country code for geo-restricted content, e.g. 'us', 'cn'"),
+            wait_for: zod_1.z
+                .coerce.number()
+                .optional()
+                .describe("Wait milliseconds before extracting content. Useful for pages with delayed JS rendering."),
+        }, async ({ url, provider, format, include_selectors, exclude_selectors, include_links, include_images, timeout, country, wait_for, }) => {
+            const body = {
+                url,
+                provider: provider || "auto",
+            };
+            if (format)
+                body.format = format;
+            if (include_selectors?.length)
+                body.include_selectors = include_selectors;
+            if (exclude_selectors?.length)
+                body.exclude_selectors = exclude_selectors;
+            if (include_links)
+                body.include_links = include_links;
+            if (include_images)
+                body.include_images = include_images;
+            if (timeout)
+                body.timeout = timeout;
+            if (country)
+                body.country = country;
+            if (wait_for)
+                body.wait_for = wait_for;
+            try {
+                const { ok, data } = await callAPI("/v1/scrape", body);
+                if (!ok) {
+                    return errorResult(`Scrape failed: ${data.error || JSON.stringify(data)}`);
+                }
+                // Truncate long scrape content to avoid token explosion
+                const MAX_CONTENT_LENGTH = 15000;
+                const content = data.content;
+                if (content && content.length > MAX_CONTENT_LENGTH) {
+                    data.content =
+                        content.slice(0, MAX_CONTENT_LENGTH) +
+                            `\n\n[... content truncated at ${MAX_CONTENT_LENGTH} chars. Total: ${content.length} chars. Use include_selectors to extract specific sections if you need more targeted content.]`;
+                }
+                return textResult(data);
             }
-            return textResult(data);
-        }
-        catch (err) {
-            return errorResult(`Failed to connect to AgentKey server at ${AGENTKEY_BASE_URL}: ${err}`);
-        }
-    });
-    // Social media tool
-    server.tool("agentkey_social", `Search and browse Twitter/X and Reddit content in real time. Returns actual social media data (posts, comments, profiles, trending topics) that web search cannot access directly.
+            catch (err) {
+                return errorResult(`Failed to connect to AgentKey server at ${AGENTKEY_BASE_URL}: ${err}`);
+            }
+        });
+        // Social media tool
+        server.tool("agentkey_social", `Search and browse social media content in real time across 11 platforms.
 
-USE THIS TOOL WHEN the user:
-- Mentions "Twitter", "X", "tweet", "推特", "推文", or any Twitter/X related query
-- Mentions "Reddit", "subreddit", "r/", or any Reddit related query
-- Asks about social media discussions, opinions, posts, or comments on a topic
-- Wants to look up a social media user's profile, posts, or followers
-- Asks for trending topics or what people are saying about something on social media
-- Asks for "最新讨论", "社区讨论", "网友评论", "大家怎么看" about any topic
+Platforms: twitter, reddit, xiaohongshu (小红书), instagram, zhihu (知乎), tiktok, douyin (抖音), bilibili (B站), weibo (微博), threads, youtube.
 
-Platform detection:
-- "twitter" — for tweets, X posts, 推特, 推文, Twitter users, trending
-- "reddit" — for Reddit posts, subreddit content, Reddit discussions, r/ anything
+THINK BEFORE CALLING — use your own knowledge first:
+- For general knowledge about platforms, creators, or public figures, answer from your training data.
+- Only call when the user needs REAL-TIME social media content: recent posts, live discussions, current trends, or specific post details.
+- Examples that do NOT need this tool: "who is Elon Musk on Twitter", "what is Reddit", "how does TikTok algorithm work".
+- Examples that NEED this tool: "what is @elonmusk tweeting about today", "trending topics on Weibo now", "latest posts in r/cryptocurrency".
 
-Type guide (default "search" if not specified):
-- search: Search posts/tweets by keyword. Requires "query".
-- posts: Get a user's tweets (Twitter) or subreddit posts (Reddit). Requires "username" or "subreddit".
-- comments/latest_comments: Get replies to a post. Requires "post_id".
-- user: Get user profile. Requires "username".
-- detail: Get a single post's full content. Requires "post_id".
-- replies/media/highlights: User's reply tweets, media tweets, or highlights. Requires "username".
-- followers/following: User's social graph. Requires "username".
-- retweets: Users who retweeted. Requires "post_id".
-- trending: Trending topics (Twitter only). Optional "country".
+USE THIS TOOL (instead of agentkey_search) when the user asks about real-time social media content.
+
+STRICT RULE — ONE CALL AT A TIME. Pick ONE platform per call.
+
+Platform guide:
+- "twitter" — tweets, trending. Use "username".
+- "reddit" — subreddit discussions. Use "subreddit".
+- "xiaohongshu" — 小红书 notes, products. Use "note_id"/"share_text".
+- "instagram" — posts, reels, stories, hashtags. Use "shortcode"/"media_id".
+- "zhihu" — 知乎 Q&A, articles, topics. Use "user_url_token"/"question_id"/"article_id".
+- "tiktok" — TikTok videos, hashtags, music. Use "aweme_id"/"sec_user_id"/"unique_id".
+- "douyin" — 抖音 videos, hot search, series. Use "aweme_id"/"sec_user_id".
+- "bilibili" — B站 videos. Use "bv_id"/"av_id".
+- "weibo" — 微博 posts, hot search. Use "uid"/"status_id".
+- "threads" — Threads posts. Use "username"/"user_id".
+- "youtube" — YouTube videos, channels, shorts. Use "video_id"/"channel_id".
+
+Common types: search, posts, comments, user, detail, followers, following.
+See full type list in the enum.`, {
+            platform: zod_1.z
+                .enum(["twitter", "reddit", "xiaohongshu", "instagram", "zhihu", "tiktok", "douyin", "bilibili", "weibo", "threads", "youtube"])
+                .describe("Social media platform"),
+            type: zod_1.z
+                .enum([
+                "search", "posts", "comments", "user", "detail", "followers", "following", "highlights",
+                "latest_comments", "replies", "media", "retweets", "trending",
+                "faved", "search_users", "search_images", "search_products", "search_groups",
+                "product_detail", "product_review_overview", "product_reviews", "product_recs",
+                "topic_info", "topic_feed", "creator_feed", "creator_hot_feed",
+                "search_hashtags", "general_search", "user_brief", "user_about", "tagged", "reels",
+                "stories", "highlight_stories", "comment_replies", "explore", "recommended_reels",
+                "location_info", "location_posts", "hashtag_posts",
+                "articles", "answers", "hot_list", "columns", "topics", "videos",
+                "hashtag_detail", "hashtag_videos", "music_detail", "music_videos", "liked", "home_feed",
+                "hot_search", "mix_detail", "mix_videos", "series_detail", "series_videos",
+                "popular", "search_by_type",
+                "ai_search", "timeline", "reposts", "likes", "album", "super_topics",
+                "search_top", "search_recent",
+                "channel_videos", "channel_shorts", "related", "captions", "search_shorts", "search_channels",
+            ])
+                .optional()
+                .describe("Query type. Default 'search'."),
+            query: zod_1.z.string().optional().describe("Search query."),
+            username: zod_1.z.string().optional().describe("Username without @ prefix."),
+            user_id: zod_1.z.string().optional().describe("User ID."),
+            post_id: zod_1.z.string().optional().describe("Post/tweet/note/video ID."),
+            note_id: zod_1.z.string().optional().describe("Xiaohongshu note ID."),
+            share_text: zod_1.z.string().optional().describe("Xiaohongshu sharing link."),
+            shortcode: zod_1.z.string().optional().describe("Instagram post shortcode."),
+            media_id: zod_1.z.string().optional().describe("Instagram media ID."),
+            comment_id: zod_1.z.string().optional().describe("Comment ID."),
+            hashtag: zod_1.z.string().optional().describe("Hashtag without #."),
+            location_id: zod_1.z.string().optional().describe("Instagram location ID."),
+            highlight_id: zod_1.z.string().optional().describe("Instagram highlight ID."),
+            sku_id: zod_1.z.string().optional().describe("Xiaohongshu product SKU ID."),
+            topic_id: zod_1.z.string().optional().describe("Xiaohongshu topic page ID."),
+            subreddit: zod_1.z.string().optional().describe("Subreddit name without r/."),
+            user_url_token: zod_1.z.string().optional().describe("Zhihu user URL token."),
+            question_id: zod_1.z.string().optional().describe("Zhihu question ID."),
+            article_id: zod_1.z.string().optional().describe("Zhihu article ID."),
+            column_id: zod_1.z.string().optional().describe("Zhihu column ID."),
+            answer_id: zod_1.z.string().optional().describe("Zhihu answer ID."),
+            sec_user_id: zod_1.z.string().optional().describe("TikTok/Douyin sec_user_id."),
+            unique_id: zod_1.z.string().optional().describe("TikTok username (unique_id)."),
+            aweme_id: zod_1.z.string().optional().describe("TikTok/Douyin video ID."),
+            music_id: zod_1.z.string().optional().describe("Music/audio ID."),
+            ch_id: zod_1.z.string().optional().describe("Hashtag/challenge ID."),
+            share_url: zod_1.z.string().optional().describe("Share URL."),
+            mix_id: zod_1.z.string().optional().describe("Douyin mix/collection ID."),
+            series_id: zod_1.z.string().optional().describe("Douyin series ID."),
+            av_id: zod_1.z.string().optional().describe("Bilibili AV ID."),
+            bv_id: zod_1.z.string().optional().describe("Bilibili BV ID."),
+            search_type: zod_1.z.string().optional().describe("Bilibili search type (video/bangumi/live/article/user)."),
+            uid: zod_1.z.string().optional().describe("Weibo user ID."),
+            status_id: zod_1.z.string().optional().describe("Weibo status/post ID."),
+            category: zod_1.z.string().optional().describe("Category filter."),
+            video_id: zod_1.z.string().optional().describe("YouTube video ID."),
+            channel_id: zod_1.z.string().optional().describe("YouTube channel ID."),
+            channel_url: zod_1.z.string().optional().describe("YouTube channel URL."),
+            sort: zod_1.z.enum(["relevance", "hot", "top", "new", "latest", "comments"]).optional().describe("Sort order."),
+            time: zod_1.z.enum(["hour", "day", "week", "month", "year", "all"]).optional().describe("Time filter."),
+            num: zod_1.z.coerce.number().min(1).max(100).optional().describe("Number of results, default 10."),
+            page: zod_1.z.coerce.number().min(1).optional().describe("Page number."),
+            country: zod_1.z.string().optional().describe("Country code."),
+            cursor: zod_1.z.string().optional().describe("Pagination cursor."),
+        }, async (params) => {
+            const body = {};
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined && v !== null)
+                    body[k] = v;
+            }
+            try {
+                const { ok, data } = await callAPI("/v1/social", body);
+                if (!ok) {
+                    return errorResult(`Social query failed: ${data.error || JSON.stringify(data)}`);
+                }
+                const results = data.results;
+                const count = results?.length ?? 0;
+                const hint = count > 0
+                    ? `\n\n[${count} results returned. Analyze these and answer the user. Only make a follow-up call if the user explicitly asks for more details.]`
+                    : `\n\n[No results. Try broader keywords or a different type/sort. Do NOT retry the same query.]`;
+                const compact = compactResult(data);
+                compact.content[0].text += hint;
+                return compact;
+            }
+            catch (err) {
+                return errorResult(`Failed to connect to AgentKey server at ${AGENTKEY_BASE_URL}: ${err}`);
+            }
+        });
+        // Crypto tool
+        server.tool("agentkey_crypto", `Query blockchain and crypto data in real time. Three data sources in one tool:
+(1) Chainbase on-chain data — token holders, wallet balances, NFTs, transactions, ENS domains, DeFi portfolios, smart contract calls, SQL on-chain queries.
+(2) CoinMarketCap market data — crypto rankings, price quotes, market cap, trending coins, gainers/losers, categories, global metrics.
+(3) Crypto social intelligence (Tops) — trending crypto narratives, social mentions, Twitter/X crypto discussions, topic discovery.
+
+THINK BEFORE CALLING — use your own knowledge first:
+- For crypto concepts, protocol explanations, or historical facts, answer from your training data WITHOUT calling this tool.
+- Only call when the user needs REAL-TIME data: live prices, current rankings, on-chain balances, recent transactions, or today's trends.
+- Examples that do NOT need this tool: "what is DeFi", "explain impermanent loss", "how does Uniswap work", "what is proof of stake".
+- Examples that NEED this tool: "BTC price now", "top gainers today", "check wallet balance at 0x...", "trending crypto narratives this week".
+
+Supported chains (Chainbase): Ethereum (1), BSC (56), Polygon (137), Avalanche (43114), Arbitrum (42161), Optimism (10), Base (8453), zkSync (324).
+
+Common token contracts (Ethereum):
+- USDT: 0xdAC17F958D2ee523a2206206994597C13D831ec7
+- USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
+- WETH: 0xC02aaA39b223FE8D0A0e5c4F27eAD9083C756Cc2
+- DAI: 0x6B175474E89094C44Da98b954EedeAC495271d0F
+- WBTC: 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599
+
+Routing — match user intent to the right type:
+
+CoinMarketCap market data (use symbol like "BTC", "ETH" — no contract address needed):
+- "top coins" / "crypto rankings" / "币圈排行" → cmc_listings (sort by market_cap)
+- "BTC price" / "ETH price" / "coin price by name" → cmc_quotes (needs symbol like "BTC,ETH")
+- "what is Bitcoin" / "coin info" / "coin logo" → cmc_info (needs symbol)
+- "total market cap" / "BTC dominance" / "市场总览" → cmc_global_metrics
+- "trending coins" / "热门币种" → cmc_trending
+- "biggest gainers" / "biggest losers" / "涨幅榜" / "跌幅榜" → cmc_gainers_losers (sort_dir: "desc" for gainers, "asc" for losers)
+- "most popular coins" / "most visited" → cmc_most_visited
+- "DeFi category" / "meme coins" / "crypto categories" → cmc_categories or cmc_category (needs category_id)
+- "convert 1 BTC to USD" / "币价换算" → cmc_price_conversion (needs amount, symbol, convert)
+- "find coin by symbol" / "coin ID lookup" → cmc_map (needs symbol)
+
+Chainbase on-chain data (use contract_address or wallet address):
+- "on-chain token price" / "token price by contract" → token_price (needs contract_address)
+- "token metadata by contract" → token_metadata (needs contract_address)
+- "price history" / "历史价格" → token_price_history (needs contract_address, from_timestamp, end_timestamp)
+- "who holds" / "top holders" / "持币大户" → token_top_holders (needs contract_address)
+- "token transfers" / "转账记录" → token_transfers (needs contract_address)
+- "wallet balance" / "ETH balance" / "余额" → balance (needs address)
+- "ERC20 holdings" / "持仓" → tokens (needs address)
+- "NFT holdings" → nfts (needs address)
+- "DeFi portfolio" → portfolios (needs address)
+- "latest block" → block_latest
+- "block detail" → block_detail (needs block_number)
+- "transaction detail" → tx_detail (needs hash)
+- "transaction history" → tx_list (needs address)
+- "NFT floor price" → nft_floor_price (needs contract_address)
+- "NFT collection" → nft_collection (needs contract_address)
+- "trending NFT" → nft_collection_trending
+- "ENS → address" → ens_resolve (needs domain)
+- "address → ENS" → ens_reverse (needs address)
+- "address label" → address_labels (needs address)
+- "call contract function" → contract_call (needs contract_address, function_name, abi)
+- "SQL query" → sql_execute (needs sql)
+
+Crypto social intelligence (Tops):
+- "what's trending in crypto" / "加密热点" → trending
+- "topic detail" → topic (needs topic_id)
+- "topic posts/tweets" → topic_posts (needs topic_id)
+- "crypto mentions" → mentions (needs query)
+- "narrative search" → tops_search (needs query)
+
+Decision guide — CoinMarketCap vs Chainbase:
+- Use cmc_* types when user asks by coin NAME/SYMBOL (BTC, ETH) without a specific contract address
+- Use Chainbase types when user provides a contract address (0x...) or needs on-chain data (holders, transfers, balances, NFTs)
+- For general "what's the price of Bitcoin" → cmc_quotes; for "price of token 0xA0b8..." → token_price
+
+SQL fallback: Use sql_execute for complex queries. Common tables: {chain}.blocks, {chain}.transactions, {chain}.token_transfers, {chain}.token_metas, {chain}.logs
 
 Preferences:
-- Strip @ from Twitter usernames (e.g. @elonmusk → "elonmusk"), strip r/ from subreddits (e.g. r/LocalLLaMA → "LocalLLaMA").
-- Use "sort": "latest" or "new" when user asks for latest/newest/最新 content.
-- Use "time": "week" or "day" when user asks for recent discussions.`, {
-        platform: zod_1.z
-            .enum(["twitter", "reddit"])
-            .describe("Social media platform"),
-        type: zod_1.z
-            .enum([
-            "search",
-            "posts",
-            "comments",
-            "user",
-            "detail",
-            "latest_comments",
-            "replies",
-            "media",
-            "highlights",
-            "followers",
-            "following",
-            "retweets",
-            "trending",
-        ])
-            .optional()
-            .describe("Query type. Default 'search'. See tool description for platform-specific types and required parameters."),
-        query: zod_1.z
-            .string()
-            .optional()
-            .describe("Search query (required for type=search)"),
-        username: zod_1.z
-            .string()
-            .optional()
-            .describe("Username without @ (for type=posts/user/replies/media/highlights/followers/following)"),
-        user_id: zod_1.z
-            .string()
-            .optional()
-            .describe("Twitter user ID (for type=highlights, alternative to username)"),
-        post_id: zod_1.z
-            .string()
-            .optional()
-            .describe("Post/tweet ID (for type=detail/comments/latest_comments/retweets)"),
-        subreddit: zod_1.z
-            .string()
-            .optional()
-            .describe("Subreddit name without r/ (for Reddit type=posts)"),
-        sort: zod_1.z
-            .enum(["relevance", "hot", "top", "new", "latest", "comments"])
-            .optional()
-            .describe("Sort order. Default 'relevance' for search, 'hot' for posts."),
-        time: zod_1.z
-            .enum(["hour", "day", "week", "month", "year", "all"])
-            .optional()
-            .describe("Time filter for sort=top results"),
-        num: zod_1.z
-            .coerce.number()
-            .min(1)
-            .max(100)
-            .optional()
-            .describe("Number of results, default 10"),
-        country: zod_1.z
-            .string()
-            .optional()
-            .describe("Country for trending topics (Twitter only). Default 'UnitedStates'."),
-        cursor: zod_1.z
-            .string()
-            .optional()
-            .describe("Pagination cursor from previous response's next_cursor"),
-    }, async ({ platform, type, query, username, user_id, post_id, subreddit, sort, time, num, country, cursor, }) => {
-        const body = { platform };
-        if (type)
-            body.type = type;
-        if (query)
-            body.query = query;
-        if (username)
-            body.username = username;
-        if (user_id)
-            body.user_id = user_id;
-        if (post_id)
-            body.post_id = post_id;
-        if (subreddit)
-            body.subreddit = subreddit;
-        if (sort)
-            body.sort = sort;
-        if (time)
-            body.time = time;
-        if (num)
-            body.num = num;
-        if (country)
-            body.country = country;
-        if (cursor)
-            body.cursor = cursor;
-        try {
-            const { ok, data } = await callAPI("/v1/social", body);
-            if (!ok) {
-                return errorResult(`Social query failed: ${data.error || JSON.stringify(data)}`);
+- Default chain_id to 1 (Ethereum) for Chainbase types.
+- If user says a token name without contract address, prefer cmc_quotes (by symbol) over token_price (by contract).
+- Default page=1, limit=20 for paginated results.
+- Default convert to "USD" for CoinMarketCap types.`, {
+            type: zod_1.z
+                .enum([
+                "token_price",
+                "token_metadata",
+                "token_price_history",
+                "token_holders",
+                "token_top_holders",
+                "token_transfers",
+                "nft_metadata",
+                "nft_collection",
+                "nft_collection_items",
+                "nft_search",
+                "nft_transfers",
+                "nft_owner",
+                "nft_owners",
+                "nft_floor_price",
+                "nft_price_history",
+                "nft_collection_trending",
+                "balance",
+                "tokens",
+                "nfts",
+                "portfolios",
+                "block_latest",
+                "block_detail",
+                "tx_detail",
+                "tx_list",
+                "ens",
+                "ens_resolve",
+                "ens_reverse",
+                "spaceid_resolve",
+                "spaceid_reverse",
+                "address_labels",
+                "contract_call",
+                "sql_execute",
+                "trending",
+                "topic",
+                "topic_posts",
+                "mentions",
+                "tops_search",
+                "cmc_listings",
+                "cmc_quotes",
+                "cmc_info",
+                "cmc_map",
+                "cmc_global_metrics",
+                "cmc_trending",
+                "cmc_gainers_losers",
+                "cmc_most_visited",
+                "cmc_categories",
+                "cmc_category",
+                "cmc_price_conversion",
+            ])
+                .describe("Query type — see tool description for routing guide"),
+            chain_id: zod_1.z
+                .coerce.number()
+                .optional()
+                .describe("Blockchain chain ID. Default 1 (Ethereum). Common: BSC=56, Polygon=137, Arbitrum=42161, Base=8453, Optimism=10, Avalanche=43114, zkSync=324."),
+            contract_address: zod_1.z
+                .string()
+                .optional()
+                .describe("Token or NFT contract address (0x...)"),
+            address: zod_1.z
+                .string()
+                .optional()
+                .describe("Wallet address (0x...) for balance, tx, ENS reverse, etc."),
+            token_id: zod_1.z
+                .string()
+                .optional()
+                .describe("NFT token ID within a collection"),
+            hash: zod_1.z.string().optional().describe("Transaction hash for tx_detail"),
+            block_number: zod_1.z
+                .coerce.number()
+                .optional()
+                .describe("Block number for block_detail"),
+            domain: zod_1.z
+                .string()
+                .optional()
+                .describe("ENS or Space ID domain name (e.g. 'vitalik.eth')"),
+            query: zod_1.z
+                .string()
+                .optional()
+                .describe("Search keyword for nft_search, mentions, or tops_search"),
+            name: zod_1.z.string().optional().describe("NFT collection name for nft_search"),
+            topic_id: zod_1.z
+                .string()
+                .optional()
+                .describe("Topic ID for topic/topic_posts (from trending results)"),
+            sql: zod_1.z
+                .string()
+                .optional()
+                .describe("SQL query for sql_execute. Example: SELECT * FROM ethereum.blocks ORDER BY number DESC LIMIT 5"),
+            function_name: zod_1.z
+                .string()
+                .optional()
+                .describe("Smart contract function name for contract_call (e.g. 'balanceOf')"),
+            abi: zod_1.z
+                .string()
+                .optional()
+                .describe("Contract ABI as JSON string for contract_call"),
+            params: zod_1.z
+                .array(zod_1.z.string())
+                .optional()
+                .describe("Function parameters for contract_call (array of strings)"),
+            from_block: zod_1.z.coerce.number().optional().describe("Start block number"),
+            to_block: zod_1.z.coerce.number().optional().describe("End block number"),
+            from_timestamp: zod_1.z
+                .coerce.number()
+                .optional()
+                .describe("Start timestamp (unix seconds)"),
+            end_timestamp: zod_1.z
+                .coerce.number()
+                .optional()
+                .describe("End timestamp (unix seconds)"),
+            sort: zod_1.z
+                .string()
+                .optional()
+                .describe("Sort order for applicable queries"),
+            page: zod_1.z
+                .coerce.number()
+                .min(1)
+                .optional()
+                .describe("Page number, default 1"),
+            limit: zod_1.z
+                .coerce.number()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Results per page, default 20"),
+            language: zod_1.z
+                .string()
+                .optional()
+                .describe("Language for trending topics (e.g. 'en', 'zh')"),
+            // CoinMarketCap params
+            symbol: zod_1.z
+                .string()
+                .optional()
+                .describe("Comma-separated coin symbols for cmc_* types (e.g. 'BTC,ETH'). Use this instead of contract_address for CoinMarketCap queries."),
+            slug: zod_1.z
+                .string()
+                .optional()
+                .describe("Comma-separated coin slugs (e.g. 'bitcoin,ethereum')"),
+            cmc_id: zod_1.z
+                .string()
+                .optional()
+                .describe("Comma-separated CoinMarketCap IDs"),
+            convert: zod_1.z
+                .string()
+                .optional()
+                .describe("Conversion currency for cmc_* types (e.g. 'USD', 'EUR', 'BTC'). Default 'USD'."),
+            category_id: zod_1.z
+                .string()
+                .optional()
+                .describe("CoinMarketCap category ID for cmc_category"),
+            time_period: zod_1.z
+                .enum(["1h", "24h", "7d", "30d"])
+                .optional()
+                .describe("Time period for cmc_trending/cmc_gainers_losers/cmc_most_visited. Default '24h'."),
+            sort_dir: zod_1.z
+                .enum(["asc", "desc"])
+                .optional()
+                .describe("Sort direction. For cmc_gainers_losers: 'desc'=gainers first, 'asc'=losers first."),
+            amount: zod_1.z
+                .coerce.number()
+                .optional()
+                .describe("Amount for cmc_price_conversion (e.g. 1.5)"),
+            cryptocurrency_type: zod_1.z
+                .enum(["all", "coins", "tokens"])
+                .optional()
+                .describe("Filter for cmc_listings: 'all', 'coins', or 'tokens'"),
+            tag: zod_1.z
+                .string()
+                .optional()
+                .describe("Filter tag for cmc_listings (e.g. 'defi', 'filesharing')"),
+            price_min: zod_1.z.coerce.number().optional().describe("Min USD price filter for cmc_listings"),
+            price_max: zod_1.z.coerce.number().optional().describe("Max USD price filter for cmc_listings"),
+            market_cap_min: zod_1.z.coerce.number().optional().describe("Min market cap filter for cmc_listings"),
+            market_cap_max: zod_1.z.coerce.number().optional().describe("Max market cap filter for cmc_listings"),
+            volume_24h_min: zod_1.z.coerce.number().optional().describe("Min 24h volume filter for cmc_listings"),
+            volume_24h_max: zod_1.z.coerce.number().optional().describe("Max 24h volume filter for cmc_listings"),
+        }, async ({ type, chain_id, contract_address, address, token_id, hash, block_number, domain, query, name, topic_id, sql, function_name, abi, params, from_block, to_block, from_timestamp, end_timestamp, sort, page, limit, language, symbol, slug, cmc_id, convert, category_id, time_period, sort_dir, amount, cryptocurrency_type, tag, price_min, price_max, market_cap_min, market_cap_max, volume_24h_min, volume_24h_max, }) => {
+            const body = { type };
+            if (chain_id)
+                body.chain_id = chain_id;
+            if (contract_address)
+                body.contract_address = contract_address;
+            if (address)
+                body.address = address;
+            if (token_id)
+                body.token_id = token_id;
+            if (hash)
+                body.hash = hash;
+            if (block_number)
+                body.block_number = block_number;
+            if (domain)
+                body.domain = domain;
+            if (query)
+                body.query = query;
+            if (name)
+                body.name = name;
+            if (topic_id)
+                body.topic_id = topic_id;
+            if (sql)
+                body.sql = sql;
+            if (function_name)
+                body.function_name = function_name;
+            if (abi)
+                body.abi = abi;
+            if (params?.length)
+                body.params = params;
+            if (from_block)
+                body.from_block = from_block;
+            if (to_block)
+                body.to_block = to_block;
+            if (from_timestamp)
+                body.from_timestamp = from_timestamp;
+            if (end_timestamp)
+                body.end_timestamp = end_timestamp;
+            if (sort)
+                body.sort = sort;
+            if (page)
+                body.page = page;
+            if (limit)
+                body.limit = limit;
+            if (language)
+                body.language = language;
+            if (symbol)
+                body.symbol = symbol;
+            if (slug)
+                body.slug = slug;
+            if (cmc_id)
+                body.cmc_id = cmc_id;
+            if (convert)
+                body.convert = convert;
+            if (category_id)
+                body.category_id = category_id;
+            if (time_period)
+                body.time_period = time_period;
+            if (sort_dir)
+                body.sort_dir = sort_dir;
+            if (amount)
+                body.amount = amount;
+            if (cryptocurrency_type)
+                body.cryptocurrency_type = cryptocurrency_type;
+            if (tag)
+                body.tag = tag;
+            if (price_min)
+                body.price_min = price_min;
+            if (price_max)
+                body.price_max = price_max;
+            if (market_cap_min)
+                body.market_cap_min = market_cap_min;
+            if (market_cap_max)
+                body.market_cap_max = market_cap_max;
+            if (volume_24h_min)
+                body.volume_24h_min = volume_24h_min;
+            if (volume_24h_max)
+                body.volume_24h_max = volume_24h_max;
+            try {
+                const { ok, data } = await callAPI("/v1/crypto", body);
+                if (!ok) {
+                    return errorResult(`Crypto query failed: ${data.error || JSON.stringify(data)}`);
+                }
+                const compact = compactResult(data);
+                compact.content[0].text +=
+                    `\n\n[Data returned. Present the results to the user. Do NOT make follow-up crypto calls unless the user asks for additional data.]`;
+                return compact;
             }
-            return textResult(data);
-        }
-        catch (err) {
-            return errorResult(`Failed to connect to AgentKey server at ${AGENTKEY_BASE_URL}: ${err}`);
-        }
-    });
+            catch (err) {
+                return errorResult(`Failed to connect to AgentKey server at ${AGENTKEY_BASE_URL}: ${err}`);
+            }
+        });
+    } // end registerBuiltinTools()
     // --- Start ---
+    const POLL_INTERVAL_MS = parseInt(process.env.AGENTKEY_POLL_INTERVAL || "30000", 10);
     async function main() {
-        const transport = new stdio_js_1.StdioServerTransport();
-        await server.connect(transport);
-        console.error("AgentKey MCP Server running on stdio");
+        let dynamicManager = null;
+        // Try dynamic tool loading from /v1/tools first
+        const registry = await (0, dynamic_js_1.fetchToolRegistry)(AGENTKEY_BASE_URL);
+        if (registry && registry.tools.length > 0) {
+            dynamicManager = new dynamic_js_1.DynamicToolManager(server, callAPI, AGENTKEY_BASE_URL, POLL_INTERVAL_MS);
+            const count = dynamicManager.registerAll(registry);
+            dynamicManager.startPolling();
+            console.error(`AgentKey MCP Server running on stdio (dynamic: ${count} tools, hot-reload every ${POLL_INTERVAL_MS / 1000}s)`);
+        }
+        else {
+            // REST API server not reachable — fall back to hardcoded tool definitions.
+            registerBuiltinTools();
+            console.error("AgentKey MCP Server running on stdio (using built-in tool definitions)");
+        }
         console.error(`  API: ${AGENTKEY_BASE_URL}`);
         console.error(`  Key: ${AGENTKEY_API_KEY ? "****" + AGENTKEY_API_KEY.slice(-4) : "(not set)"}`);
+        const transport = new stdio_js_1.StdioServerTransport();
+        await server.connect(transport);
+        // Cleanup on shutdown
+        const cleanup = () => {
+            dynamicManager?.stopPolling();
+        };
+        process.on("beforeExit", cleanup);
     }
     // Graceful shutdown
     process.on("SIGINT", () => {