@agentkey/mcp 0.0.4 → 0.0.5

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.5
 
 Tools:
   agentkey_search    Search the web, news, images, videos, or places
@@ -55,6 +56,8 @@ Tools:
                      Providers: Firecrawl, Jina Reader, ScrapeNinja
   agentkey_social    Query social media (search, posts, comments, user profiles)
                      Platforms: Twitter/X, Reddit
+  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,189 +295,247 @@ 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.5",
+        description: `AgentKey provides 4 tools: search, scrape, social, crypto. Follow this decision tree:
+
+1. Is the user asking about crypto prices, on-chain data, wallets, or NFTs? → Use agentkey_crypto. Do NOT use agentkey_search for crypto prices.
+2. Is the user asking about Twitter/X or Reddit content? → Use agentkey_social. Do NOT use agentkey_search for social media.
+3. Does the user want the full content of a specific URL? → Use agentkey_scrape.
+4. Everything else (web search, news, general questions) → Use 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.
 
+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. If you find yourself about to make 2+ search calls at once, STOP — pick the single best query and make only that one call.
+- After receiving results, answer the user if possible. Only make a follow-up search if the results are clearly insufficient AND you have a meaningfully different query to try.
+
+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 (e.g. "X review" + "X opinion" + "X comparison"). Use one comprehensive query.
+- Do NOT search the same topic in multiple languages. Pick the best language for that topic and search once.
+- 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 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.
 
+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.
+- Only scrape when you actually need the full page content. If search results already gave you enough info (title, snippet, date), do NOT scrape.
+- 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 Twitter/X and Reddit content in real time. Returns actual social media data (posts, comments, profiles, trending topics) that web search cannot access directly.
 
-USE THIS TOOL WHEN the user:
+USE THIS TOOL (instead of agentkey_search) 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
@@ -482,6 +543,13 @@ USE THIS TOOL WHEN the user:
 - Asks for trending topics or what people are saying about something on social media
 - Asks for "最新讨论", "社区讨论", "网友评论", "大家怎么看" about any topic
 
+STRICT RULE — MAXIMUM ONE SOCIAL CALL AT A TIME:
+- You MUST call this tool at most ONCE per turn. Wait for results before deciding if you need another call.
+- NEVER batch multiple social calls in parallel (e.g. search + user profile + posts). Make ONE call, analyze results, then follow up only if needed.
+- If the user says "search social media for X", pick ONE platform (Twitter for crypto/tech news, Reddit for discussions/reviews) — do NOT call both unless explicitly asked.
+- Do NOT fetch user profile + user posts + user followers in separate parallel calls. Start with the most relevant one (usually search or posts).
+- Default num to 10. Do NOT set num > 20 unless the user explicitly asks for more results.
+
 Platform detection:
 - "twitter" — for tweets, X posts, 推特, 推文, Twitter users, trending
 - "reddit" — for Reddit posts, subreddit content, Reddit discussions, r/ anything
@@ -501,111 +569,497 @@ 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)}`);
+            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)}`);
+                }
+                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;
             }
-            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}`);
+            }
+        });
+        // 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.
+
+USE THIS TOOL WHEN the user:
+- Asks about token/coin prices, market cap, rankings (e.g. "BTC price", "top 10 coins", "crypto market cap")
+- Asks about token holders, transfers, on-chain data (e.g. "top USDC holders", "USDT transfers")
+- Asks about NFT collections, floor prices, ownership, rarity, or trending NFTs
+- Asks about wallet balances, token holdings, DeFi portfolio, or transaction history
+- Asks about blockchain data: latest block, block details, transaction details
+- Asks about ENS domains, Space ID domains, or address resolution
+- Asks about trending coins, gainers, losers, or what's hot in crypto markets
+- Asks about crypto categories (DeFi, Layer 1, Meme coins, etc.)
+- Asks about global crypto market metrics, BTC dominance, total market cap
+- Asks to convert between crypto/fiat currencies
+- Asks to query on-chain data with SQL or call a smart contract function
+- Asks about crypto social narratives, mentions, or trending topics
+- Mentions keywords: "token", "coin", "price", "market cap", "holder", "wallet", "balance", "NFT", "block", "transaction", "ENS", "on-chain", "ranking", "trending", "gainers", "losers"
+- Mentions Chinese keywords: "链上", "代币", "币价", "市值", "持币", "钱包", "余额", "持仓", "区块", "交易", "地址", "合约", "涨幅", "跌幅", "排行"
+- Mentions any EVM address (0x...), token contract, transaction hash, or .eth domain
+- Mentions coin symbols like BTC, ETH, SOL, USDT, USDC, etc.
+
+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:
+- 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;
+            }
+            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", () => {