mcp-crypto-price 4.0.0 → 5.0.0

package/README.md

@@ -17,8 +17,8 @@ A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency
 - **BREAKING**: CoinCap v2 API removed. Now uses v3 API exclusively. A `COINCAP_API_KEY` is required (free tier available at [pro.coincap.io/dashboard](https://pro.coincap.io/dashboard))
 - Streamable HTTP transport added (while keeping STDIO compatibility)
 - Smithery CLI scripts to build and run the HTTP server
-- **6 new tools**: `assets.search`, `market.global`, `assets.compare`, `analysis.candlestick`, `price.convert`, `assets.info`
-- **Dot-notation tool naming**: All tools organized into a navigable tree (`price.*`, `market.*`, `assets.*`, `analysis.*`)
+- **6 new tools**: `assets-search`, `market-global`, `assets-compare`, `analysis-candlestick`, `price-convert`, `assets-info`
+- **Hierarchical tool naming**: All tools organized into category-prefixed names (`price-*`, `market-*`, `assets-*`, `analysis-*`)
 - **Output schemas**: All tools now declare `outputSchema` with `structuredContent` for type-safe responses
 - **MCP best practices**: `isError` flag on validation errors, server description, and `asset://{symbol}` resource template
 
@@ -136,7 +136,7 @@ Launch Claude Desktop to start using the crypto analysis tools.
 
 ## Tools
 
-#### price.get
+#### price-get
 
 Gets current price and 24h stats for any cryptocurrency, including:
 - Current price in USD
@@ -145,14 +145,14 @@ Gets current price and 24h stats for any cryptocurrency, including:
 - Market cap
 - Market rank
 
-#### price.convert
+#### price-convert
 
 Converts a cryptocurrency amount into any fiat currency:
 - Uses real-time price data and USD-based exchange rates
 - Parameters: `symbol` (e.g. `BTC`), `amount` (default 1), `currency` (default `usd`)
 - Example: 2.5 BTC in EUR
 
-#### market.analysis
+#### market-analysis
 
 Provides detailed market analysis including:
 - Top 5 exchanges by volume
@@ -160,7 +160,7 @@ Provides detailed market analysis including:
 - Volume distribution analysis
 - VWAP (Volume Weighted Average Price)
 
-#### market.global
+#### market-global
 
 Provides an overview of the entire cryptocurrency market:
 - Total market capitalization across all assets
@@ -169,14 +169,14 @@ Provides an overview of the entire cryptocurrency market:
 - Bitcoin dominance percentage
 - Top gainers and losers
 
-#### market.rates
+#### market-rates
 
 Returns USD-based conversion rates for fiat currencies and cryptocurrencies:
 - All fiat currency rates (USD base)
 - Top 10 cryptocurrency rates
 - Optional `slug` parameter (e.g. `euro`, `bitcoin`) for a single rate lookup
 
-#### market.exchanges
+#### market-exchanges
 
 Lists top cryptocurrency exchanges ranked by 24h volume:
 - Exchange name, rank, and 24h volume in USD
@@ -184,7 +184,7 @@ Lists top cryptocurrency exchanges ranked by 24h volume:
 - Optional `exchangeId` parameter (e.g. `binance`) for single exchange details
 - Optional `limit` parameter (1–50, default 10)
 
-#### assets.top
+#### assets-top
 
 Lists top cryptocurrencies ranked by market cap, including:
 - Current price in USD
@@ -192,14 +192,14 @@ Lists top cryptocurrencies ranked by market cap, including:
 - Market cap and rank
 - Configurable result count (1–50, default 10)
 
-#### assets.search
+#### assets-search
 
 Searches for cryptocurrencies by name or symbol with fuzzy matching:
 - Returns matching assets with symbol, name, price, and rank
 - Configurable result count (1–50, default 10)
 - Example: search "bit" returns Bitcoin, Bitcoin Cash, BitTorrent, etc.
 
-#### assets.info
+#### assets-info
 
 Returns detailed metadata for a single cryptocurrency:
 - ID, rank, symbol, and name
@@ -207,14 +207,14 @@ Returns detailed metadata for a single cryptocurrency:
 - Circulating supply and max supply
 - VWAP (24h)
 
-#### assets.compare
+#### assets-compare
 
 Compares 2–5 cryptocurrencies side by side:
 - Price, 24h change, market cap, volume, and rank for each asset
 - Comma-separated symbols (e.g. `BTC,ETH,SOL`)
 - Highlights best performer by 24h change
 
-#### analysis.historical
+#### analysis-historical
 
 Analyzes historical price data with:
 - Customizable time intervals (5min to 1 day)
@@ -223,7 +223,7 @@ Analyzes historical price data with:
 - Volatility metrics
 - High/low price ranges
 
-#### analysis.technical
+#### analysis-technical
 
 Returns the latest technical indicators for any cryptocurrency:
 - SMA (Simple Moving Average) with period
@@ -232,7 +232,7 @@ Returns the latest technical indicators for any cryptocurrency:
 - MACD with signal line, histogram, and Bullish/Bearish label
 - VWAP (Volume Weighted Average Price, 24h)
 
-#### analysis.candlestick
+#### analysis-candlestick
 
 Retrieves OHLCV candlestick data from a specific exchange:
 - Open, high, low, close, and volume for each candle

package/dist/http.js

@@ -39,7 +39,7 @@ const serverCard = {
     },
     tools: [
         {
-            name: 'price.get',
+            name: 'price-get',
             description: 'Get current price and 24h stats for a cryptocurrency',
             inputSchema: {
                 type: 'object',
@@ -81,7 +81,7 @@ const serverCard = {
             },
         },
         {
-            name: 'market.analysis',
+            name: 'market-analysis',
             description: 'Get detailed market analysis including top exchanges and volume distribution',
             inputSchema: {
                 type: 'object',
@@ -138,7 +138,7 @@ const serverCard = {
             },
         },
         {
-            name: 'analysis.historical',
+            name: 'analysis-historical',
             description: 'Get historical price analysis with customizable timeframe',
             inputSchema: {
                 type: 'object',
@@ -197,7 +197,7 @@ const serverCard = {
             },
         },
         {
-            name: 'assets.top',
+            name: 'assets-top',
             description: 'Get top cryptocurrencies ranked by market cap',
             inputSchema: {
                 type: 'object',
@@ -250,7 +250,7 @@ const serverCard = {
             },
         },
         {
-            name: 'analysis.technical',
+            name: 'analysis-technical',
             description: 'Get the latest technical indicators for a cryptocurrency including SMA, EMA, RSI, MACD, and VWAP',
             inputSchema: {
                 type: 'object',
@@ -326,7 +326,7 @@ const serverCard = {
             },
         },
         {
-            name: 'market.rates',
+            name: 'market-rates',
             description: "Get USD-based conversion rates for fiat currencies and cryptocurrencies. Optionally pass a slug (e.g. 'euro', 'us-dollar', 'bitcoin') to look up a single rate.",
             inputSchema: {
                 type: 'object',
@@ -366,7 +366,7 @@ const serverCard = {
             },
         },
         {
-            name: 'market.exchanges',
+            name: 'market-exchanges',
             description: "Get top cryptocurrency exchanges ranked by 24h volume. Optionally pass an exchangeId (e.g. 'binance', 'coinbase') to get details for a specific exchange.",
             inputSchema: {
                 type: 'object',
@@ -423,7 +423,7 @@ const serverCard = {
             },
         },
         {
-            name: 'assets.search',
+            name: 'assets-search',
             description: 'Search for cryptocurrencies by name, symbol, or partial match. Returns multiple matching assets with their ID, name, symbol, rank, and current price.',
             inputSchema: {
                 type: 'object',
@@ -471,7 +471,7 @@ const serverCard = {
             },
         },
         {
-            name: 'market.global',
+            name: 'market-global',
             description: 'Get a global overview of the cryptocurrency market including total market capitalization, 24-hour trading volume, Bitcoin dominance percentage, and the number of active cryptocurrencies.',
             inputSchema: {
                 type: 'object',
@@ -500,7 +500,7 @@ const serverCard = {
             },
         },
         {
-            name: 'assets.compare',
+            name: 'assets-compare',
             description: 'Compare 2-5 cryptocurrencies side-by-side including price, 24h change, volume, market cap, and rank. Pass symbols as a comma-separated list (e.g. "BTC,ETH,SOL").',
             inputSchema: {
                 type: 'object',
@@ -555,7 +555,7 @@ const serverCard = {
             },
         },
         {
-            name: 'analysis.candlestick',
+            name: 'analysis-candlestick',
             description: 'Get OHLCV candlestick data for a cryptocurrency from a specific exchange. Useful for charting and technical analysis.',
             inputSchema: {
                 type: 'object',
@@ -623,7 +623,7 @@ const serverCard = {
             },
         },
         {
-            name: 'price.convert',
+            name: 'price-convert',
             description: 'Convert a cryptocurrency amount to any fiat currency (e.g. USD, EUR, JPY). Uses real-time exchange rates for accurate conversions.',
             inputSchema: {
                 type: 'object',
@@ -673,7 +673,7 @@ const serverCard = {
             },
         },
         {
-            name: 'assets.info',
+            name: 'assets-info',
             description: 'Get detailed metadata for a cryptocurrency including ID, rank, supply, max supply, VWAP, market cap, and 24h volume.',
             inputSchema: {
                 type: 'object',

package/dist/index.js

@@ -37,7 +37,7 @@ export function createServer({ config, }) {
             },
         ],
     });
-    server.registerTool('price.get', {
+    server.registerTool('price-get', {
         title: 'Get Crypto Price',
         description: 'Get real-time price, 24-hour change percentage, trading volume, and market cap for any cryptocurrency by symbol or name.',
         inputSchema: GetPriceArgumentsSchema.shape,
@@ -53,7 +53,7 @@ export function createServer({ config, }) {
         const result = await handleGetPrice(args);
         return result;
     });
-    server.registerTool('market.analysis', {
+    server.registerTool('market-analysis', {
         title: 'Get Market Analysis',
         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,
@@ -69,7 +69,7 @@ export function createServer({ config, }) {
         const result = await handleGetMarketAnalysis(args);
         return result;
     });
-    server.registerTool('analysis.historical', {
+    server.registerTool('analysis-historical', {
         title: 'Get Historical Analysis',
         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,
@@ -85,7 +85,7 @@ export function createServer({ config, }) {
         const result = await handleGetHistoricalAnalysis(args);
         return result;
     });
-    server.registerTool('assets.top', {
+    server.registerTool('assets-top', {
         title: 'Get Top Assets',
         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,
@@ -101,7 +101,7 @@ export function createServer({ config, }) {
         const result = await handleGetTopAssets(args);
         return result;
     });
-    server.registerTool('analysis.technical', {
+    server.registerTool('analysis-technical', {
         title: 'Get Technical Analysis',
         description: 'Get the latest technical indicators for a cryptocurrency including SMA, EMA, RSI, MACD, and VWAP to assess momentum, trend direction, and overbought/oversold conditions.',
         inputSchema: GetTechnicalAnalysisSchema.shape,
@@ -117,7 +117,7 @@ export function createServer({ config, }) {
         const result = await handleGetTechnicalAnalysis(args);
         return result;
     });
-    server.registerTool('market.rates', {
+    server.registerTool('market-rates', {
         title: 'Get Currency Rates',
         description: "Get USD-based conversion rates for fiat currencies and cryptocurrencies. Optionally pass a slug (e.g. 'euro', 'us-dollar', 'bitcoin') to look up a single rate.",
         inputSchema: GetRatesSchema.shape,
@@ -133,7 +133,7 @@ export function createServer({ config, }) {
         const result = await handleGetRates(args);
         return result;
     });
-    server.registerTool('market.exchanges', {
+    server.registerTool('market-exchanges', {
         title: 'Get Exchanges',
         description: "Get top cryptocurrency exchanges ranked by 24h volume. Optionally pass an exchangeId (e.g. 'binance', 'coinbase') to get details for a specific exchange including volume, trading pairs, and market share.",
         inputSchema: GetExchangesSchema.shape,
@@ -149,7 +149,7 @@ export function createServer({ config, }) {
         const result = await handleGetExchanges(args);
         return result;
     });
-    server.registerTool('assets.search', {
+    server.registerTool('assets-search', {
         title: 'Search Crypto Assets',
         description: 'Search for cryptocurrencies by name, symbol, or partial match. Returns multiple matching assets with their ID, name, symbol, rank, and current price.',
         inputSchema: SearchAssetsSchema.shape,
@@ -165,7 +165,7 @@ export function createServer({ config, }) {
         const result = await handleSearchAssets(args);
         return result;
     });
-    server.registerTool('market.global', {
+    server.registerTool('market-global', {
         title: 'Get Global Metrics',
         description: 'Get a global overview of the cryptocurrency market including total market capitalization, 24-hour trading volume, Bitcoin dominance percentage, and the number of active cryptocurrencies.',
         inputSchema: GetGlobalMetricsSchema.shape,
@@ -181,7 +181,7 @@ export function createServer({ config, }) {
         const result = await handleGetGlobalMetrics(args);
         return result;
     });
-    server.registerTool('assets.compare', {
+    server.registerTool('assets-compare', {
         title: 'Compare Cryptocurrencies',
         description: 'Compare 2-5 cryptocurrencies side-by-side including price, 24h change, volume, market cap, and rank. Pass symbols as a comma-separated list (e.g. "BTC,ETH,SOL").',
         inputSchema: CompareCryptoSchema.shape,
@@ -197,7 +197,7 @@ export function createServer({ config, }) {
         const result = await handleCompareCrypto(args);
         return result;
     });
-    server.registerTool('analysis.candlestick', {
+    server.registerTool('analysis-candlestick', {
         title: 'Get Candlestick Data',
         description: 'Get OHLCV candlestick data for a cryptocurrency from a specific exchange. Useful for charting and technical analysis.',
         inputSchema: GetCandlestickDataSchema.shape,
@@ -213,7 +213,7 @@ export function createServer({ config, }) {
         const result = await handleGetCandlestickData(args);
         return result;
     });
-    server.registerTool('price.convert', {
+    server.registerTool('price-convert', {
         title: 'Get Price Conversion',
         description: 'Convert a cryptocurrency amount to any fiat currency (e.g. USD, EUR, JPY). Uses real-time exchange rates for accurate conversions.',
         inputSchema: GetPriceConversionSchema.shape,
@@ -229,7 +229,7 @@ export function createServer({ config, }) {
         const result = await handleGetPriceConversion(args);
         return result;
     });
-    server.registerTool('assets.info', {
+    server.registerTool('assets-info', {
         title: 'Get Asset Info',
         description: 'Get detailed metadata for a cryptocurrency including ID, rank, supply, max supply, VWAP, market cap, and 24h volume.',
         inputSchema: GetAssetInfoSchema.shape,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-crypto-price",
-  "version": "4.0.0",
+  "version": "5.0.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": {