mcp-crypto-price 3.0.4 → 3.2.0

package/dist/config/index.js

@@ -16,4 +16,9 @@ export const SERVER_CONFIG = {
     name: "mcp-crypto-price",
     version: readVersion(),
 };
-export const CACHE_TTL = 60000; // 1 minute cache
+export const CACHE_TTL = 60000; // default fallback (ms)
+/** Returns the active cache TTL in ms, reading CACHE_TTL_SECONDS from env at call time. */
+export function getCacheTtl() {
+    const s = parseInt(process.env.CACHE_TTL_SECONDS ?? '60', 10);
+    return Number.isFinite(s) && s >= 10 ? s * 1000 : CACHE_TTL;
+}

package/dist/http.js

@@ -37,6 +37,13 @@ const serverCard = {
                 },
                 required: ['symbol'],
             },
+            annotations: {
+                title: 'Get Crypto Price',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
         },
         {
             name: 'get-market-analysis',
@@ -48,6 +55,13 @@ const serverCard = {
                 },
                 required: ['symbol'],
             },
+            annotations: {
+                title: 'Get Market Analysis',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
         },
         {
             name: 'get-historical-analysis',
@@ -56,11 +70,29 @@ const serverCard = {
                 type: 'object',
                 properties: {
                     symbol: { type: 'string', description: 'Cryptocurrency symbol or name (e.g. BTC or Bitcoin)' },
-                    interval: { type: 'string', enum: ['m5', 'm15', 'm30', 'h1', 'h2', 'h6', 'h12', 'd1'], default: 'h1' },
-                    days: { type: 'number', minimum: 1, maximum: 30, default: 7 },
+                    interval: {
+                        type: 'string',
+                        enum: ['m5', 'm15', 'm30', 'h1', 'h2', 'h6', 'h12', 'd1'],
+                        default: 'h1',
+                        description: 'Data interval: m1=1min, m5=5min, m15=15min, m30=30min, h1=1hr, h2=2hr, h6=6hr, h12=12hr, d1=daily',
+                    },
+                    days: {
+                        type: 'number',
+                        minimum: 1,
+                        maximum: 30,
+                        default: 7,
+                        description: 'Number of days of historical data to retrieve (1-30)',
+                    },
                 },
                 required: ['symbol'],
             },
+            annotations: {
+                title: 'Get Historical Analysis',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
         },
         {
             name: 'get-top-assets',
@@ -68,9 +100,22 @@ const serverCard = {
             inputSchema: {
                 type: 'object',
                 properties: {
-                    limit: { type: 'number', minimum: 1, maximum: 50, default: 10 },
+                    limit: {
+                        type: 'number',
+                        minimum: 1,
+                        maximum: 50,
+                        default: 10,
+                        description: 'Number of top assets to return, ranked by market cap (1-50)',
+                    },
                 },
             },
+            annotations: {
+                title: 'Get Top Assets',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
         },
     ],
     resources: [

package/dist/index.js

@@ -10,12 +10,23 @@ export const configSchema = z.object({
     COINCAP_API_KEY: z
         .string()
         .optional()
-        .describe("API key for CoinCap v3 API (required). Free tier available at https://pro.coincap.io/dashboard"),
+        .describe("API key for CoinCap v3 API. Free tier available at https://pro.coincap.io/dashboard"),
+    CACHE_TTL_SECONDS: z
+        .number()
+        .int()
+        .min(10)
+        .max(3600)
+        .default(60)
+        .optional()
+        .describe("How long to cache API responses in seconds (default: 60). Lower values return fresher data; higher values reduce API usage."),
 });
 export function createServer({ config, }) {
     if (config?.COINCAP_API_KEY && !process.env.COINCAP_API_KEY) {
         process.env.COINCAP_API_KEY = config.COINCAP_API_KEY;
     }
+    if (config?.CACHE_TTL_SECONDS != null) {
+        process.env.CACHE_TTL_SECONDS = String(config.CACHE_TTL_SECONDS);
+    }
     const server = new McpServer({
         name: SERVER_CONFIG.name,
         version: SERVER_CONFIG.version,
@@ -28,36 +39,60 @@ export function createServer({ config, }) {
     });
     server.registerTool("get-crypto-price", {
         title: "Get Crypto Price",
-        description: "Get current price and 24h stats for a cryptocurrency",
+        description: "Get real-time price, 24-hour change percentage, trading volume, and market cap for any cryptocurrency by symbol or name.",
         inputSchema: GetPriceArgumentsSchema.shape,
-        annotations: { readOnlyHint: true, openWorldHint: true },
+        annotations: {
+            title: "Get Crypto Price",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
     }, async (args, _extra) => {
         const result = await handleGetPrice(args);
         return result;
     });
     server.registerTool("get-market-analysis", {
         title: "Get Market Analysis",
-        description: "Get detailed market analysis including top exchanges and volume distribution",
+        description: "Get detailed market analysis for a cryptocurrency including the top 5 exchanges by volume, price per exchange, and volume distribution percentages.",
         inputSchema: GetMarketAnalysisSchema.shape,
-        annotations: { readOnlyHint: true, openWorldHint: true },
+        annotations: {
+            title: "Get Market Analysis",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
     }, async (args, _extra) => {
         const result = await handleGetMarketAnalysis(args);
         return result;
     });
     server.registerTool("get-historical-analysis", {
         title: "Get Historical Analysis",
-        description: "Get historical price analysis with customizable timeframe",
+        description: "Get historical price data for a cryptocurrency with trend analysis including period high/low, price change percentage, and volatility metrics over a customizable timeframe.",
         inputSchema: GetHistoricalAnalysisSchema.shape,
-        annotations: { readOnlyHint: true, openWorldHint: true },
+        annotations: {
+            title: "Get Historical Analysis",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
     }, async (args, _extra) => {
         const result = await handleGetHistoricalAnalysis(args);
         return result;
     });
     server.registerTool("get-top-assets", {
         title: "Get Top Assets",
-        description: "Get top cryptocurrencies ranked by market cap",
+        description: "Get the top cryptocurrencies ranked by market cap, with real-time price, 24-hour change percentage, and market cap for each asset.",
         inputSchema: GetTopAssetsSchema.shape,
-        annotations: { readOnlyHint: true, openWorldHint: true },
+        annotations: {
+            title: "Get Top Assets",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
     }, async (args, _extra) => {
         const result = await handleGetTopAssets(args);
         return result;

package/dist/services/coincap.js

@@ -1,4 +1,4 @@
-import { COINCAP_API_BASE, CACHE_TTL } from '../config/index.js';
+import { COINCAP_API_BASE, getCacheTtl } from '../config/index.js';
 import { AssetsResponseSchema, HistoricalDataSchema, MarketsResponseSchema } from './schemas.js';
 const API_KEY_ERROR_MESSAGE = 'CoinCap API key is required. The v2 API has been sunset and all requests now use the v3 API, which requires an API key.\n\n' +
     'A free tier is available! Get your API key at: https://pro.coincap.io/dashboard\n\n' +
@@ -19,7 +19,7 @@ function getCachedData(key) {
     if (!entry)
         return null;
     const now = Date.now();
-    if (now - entry.timestamp > CACHE_TTL) {
+    if (now - entry.timestamp > getCacheTtl()) {
         cache.delete(key);
         return null;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-crypto-price",
-  "version": "3.0.4",
+  "version": "3.2.0",
   "description": "A Model Context Protocol (MCP) server that provides real-time cryptocurrency data and analysis through CoinCap's API. Features include price tracking, market analysis, and historical trends.",
   "license": "MIT",
   "author": {