mcp-crypto-price 3.7.0 → 4.0.0

package/README.md

@@ -17,7 +17,9 @@ 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**: `search-assets`, `get-global-metrics`, `compare-crypto`, `get-candlestick-data`, `get-price-conversion`, `get-asset-info`
+- **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.*`)
+- **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
 
 ## Usage
@@ -134,7 +136,7 @@ Launch Claude Desktop to start using the crypto analysis tools.
 
 ## Tools
 
-#### get-crypto-price
+#### price.get
 
 Gets current price and 24h stats for any cryptocurrency, including:
 - Current price in USD
@@ -143,7 +145,14 @@ Gets current price and 24h stats for any cryptocurrency, including:
 - Market cap
 - Market rank
 
-#### get-market-analysis
+#### 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
 
 Provides detailed market analysis including:
 - Top 5 exchanges by volume
@@ -151,40 +160,23 @@ Provides detailed market analysis including:
 - Volume distribution analysis
 - VWAP (Volume Weighted Average Price)
 
-#### get-historical-analysis
-
-Analyzes historical price data with:
-- Customizable time intervals (5min to 1 day)
-- Support for up to 30 days of historical data
-- Price trend analysis
-- Volatility metrics
-- High/low price ranges
-
-#### get-top-assets
-
-Lists top cryptocurrencies ranked by market cap, including:
-- Current price in USD
-- 24-hour price change
-- Market cap and rank
-- Configurable result count (1–50, default 10)
-
-#### get-technical-analysis
+#### market.global
 
-Returns the latest technical indicators for any cryptocurrency:
-- SMA (Simple Moving Average) with period
-- EMA (Exponential Moving Average) with period
-- RSI (Relative Strength Index) with Overbought/Oversold/Neutral signal
-- MACD with signal line, histogram, and Bullish/Bearish label
-- VWAP (Volume Weighted Average Price, 24h)
+Provides an overview of the entire cryptocurrency market:
+- Total market capitalization across all assets
+- 24-hour trading volume
+- Number of active cryptocurrencies
+- Bitcoin dominance percentage
+- Top gainers and losers
 
-#### get-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
 
-#### get-exchanges
+#### market.exchanges
 
 Lists top cryptocurrency exchanges ranked by 24h volume:
 - Exchange name, rank, and 24h volume in USD
@@ -192,50 +184,60 @@ 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)
 
-#### search-assets
+#### assets.top
+
+Lists top cryptocurrencies ranked by market cap, including:
+- Current price in USD
+- 24-hour price change
+- Market cap and rank
+- Configurable result count (1–50, default 10)
+
+#### 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.
 
-#### get-global-metrics
+#### assets.info
 
-Provides an overview of the entire cryptocurrency market:
-- Total market capitalization across all assets
-- 24-hour trading volume
-- Number of active cryptocurrencies
-- Bitcoin dominance percentage
-- Top gainers and losers
+Returns detailed metadata for a single cryptocurrency:
+- ID, rank, symbol, and name
+- Price, 24h change, market cap, and volume
+- Circulating supply and max supply
+- VWAP (24h)
 
-#### compare-crypto
+#### 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
 
-#### get-candlestick-data
+#### analysis.historical
 
-Retrieves OHLCV candlestick data from a specific exchange:
-- Open, high, low, close, and volume for each candle
-- Configurable exchange (e.g. `binance`), quote currency (e.g. `usd`), and interval (`5m`, `15m`, `1h`, `6h`, `1d`)
-- Supports 1–30 days of historical candles
+Analyzes historical price data with:
+- Customizable time intervals (5min to 1 day)
+- Support for up to 30 days of historical data
+- Price trend analysis
+- Volatility metrics
+- High/low price ranges
 
-#### get-price-conversion
+#### analysis.technical
 
-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
+Returns the latest technical indicators for any cryptocurrency:
+- SMA (Simple Moving Average) with period
+- EMA (Exponential Moving Average) with period
+- RSI (Relative Strength Index) with Overbought/Oversold/Neutral signal
+- MACD with signal line, histogram, and Bullish/Bearish label
+- VWAP (Volume Weighted Average Price, 24h)
 
-#### get-asset-info
+#### analysis.candlestick
 
-Returns detailed metadata for a single cryptocurrency:
-- ID, rank, symbol, and name
-- Price, 24h change, market cap, and volume
-- Circulating supply and max supply
-- VWAP (24h)
+Retrieves OHLCV candlestick data from a specific exchange:
+- Open, high, low, close, and volume for each candle
+- Configurable exchange (e.g. `binance`), quote currency (e.g. `usd`), and interval (`5m`, `15m`, `1h`, `6h`, `1d`)
+- Supports 1–30 days of historical candles
 
 ## Resources