mcp-crypto-price 3.5.12 → 3.7.0

package/README.md

@@ -17,6 +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**: `search-assets`, `get-global-metrics`, `compare-crypto`, `get-candlestick-data`, `get-price-conversion`, `get-asset-info`
+- **MCP best practices**: `isError` flag on validation errors, server description, and `asset://{symbol}` resource template
 
 ## Usage
 
@@ -58,14 +60,15 @@ If your MCP client requires launching via `cmd.exe` on Windows:
 ### Development scripts
 
 ```bash
-npm run build         # Compile TypeScript → dist/
-npm run format        # Format source files with Prettier
-npm run lint          # Check for lint errors (ESLint + typescript-eslint)
-npm run lint:fix      # Auto-fix lint errors
-npm run types:check   # TypeScript type-check without emitting files
-npm test              # Run all tests
-npm run test:coverage # Run tests with coverage report
-npm run inspector     # Open MCP inspector for interactive debugging
+pnpm dev          # Development (HTTP server with hot reload via Smithery CLI)
+pnpm build         # Compile TypeScript → dist/
+pnpm format        # Format source files with Prettier
+pnpm lint          # Check for lint errors (ESLint + typescript-eslint)
+pnpm lint:fix      # Auto-fix lint errors
+pnpm types:check   # TypeScript type-check without emitting files
+pnpm test          # Run all tests with Vitest
+pnpm test:coverage # Run tests with coverage report (Vitest)
+pnpm inspector     # Open MCP inspector for interactive debugging
 ```
 
 ### Run as Streamable HTTP server
@@ -75,27 +78,27 @@ You can run the server over HTTP for environments that support MCP over HTTP str
 - Dev server (recommended during development):
 
 ```bash
-npm run dev
+pnpm dev
 ```
 
 - Build and run the HTTP server:
 
 ```bash
 # Build (outputs to dist/)
-npm run build
+pnpm build
 
 # Start the HTTP server
-npm run start:http
+pnpm start:http
 ```
 
 - Build and run the STDIO server:
 
 ```bash
 # Build (outputs to dist/)
-npm run build
+pnpm build
 
 # Start the STDIO server
-npm run start:stdio
+pnpm start:stdio
 ```
 
 The server listens on port 3000 by default (override with `PORT`). For clients that connect over HTTP (e.g. Smithery, Claude.ai), pass your API key as a query parameter:
@@ -123,7 +126,7 @@ Without a valid API key, all tools will return an error with instructions on how
 
 ## Note for Smithery CLI users
 
-This MCP server works directly via `npx` (configs above) and does not require Smithery.
+This MCP server works directly via `pnpm dlx` (configs above) and does not require Smithery.
 
 If you do use the Smithery CLI, authenticate with `smithery auth login` or by setting `SMITHERY_API_KEY` in your environment. Recent versions of the Smithery CLI do not support passing API keys via `--key` (or older `--profile` patterns).
 
@@ -189,6 +192,72 @@ 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
+
+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
+
+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
+
+#### compare-crypto
+
+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
+
+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
+
+#### get-price-conversion
+
+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
+
+#### get-asset-info
+
+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)
+
+## Resources
+
+The server exposes the following MCP resources:
+
+- **`info://server`** — Server name and version metadata
+- **`asset://{symbol}`** — Cryptocurrency asset information by symbol (e.g. `asset://BTC`), returned as JSON
+
+## Prompts
+
+The server exposes the following MCP prompts that clients can invoke:
+
+| Prompt | Args | Description |
+|--------|------|-------------|
+| `analyze-crypto` | `symbol` | Comprehensive analysis: price, market, historical trends |
+| `compare-cryptocurrencies` | `symbols` | Compare 2-5 cryptos side-by-side |
+| `market-overview` | — | Global market snapshot: metrics, top assets, top exchanges |
+| `crypto-conversion` | `symbol`, `amount?`, `currency?` | Convert crypto amount to fiat |
+| `exchange-analysis` | `symbol` | Exchange landscape analysis for a crypto |
+| `technical-analysis` | `symbol` | Full technical analysis: indicators, candles, trends |
+| `crypto-screener` | `query` | Search and screen cryptos for opportunities |
+
 ## Sample Prompts
 
 - "What's the current price of Bitcoin?"
@@ -199,10 +268,24 @@ Lists top cryptocurrency exchanges ranked by 24h volume:
 - "What are the technical indicators for ETH right now?"
 - "What's the current EUR to USD exchange rate?"
 - "Which crypto exchanges have the highest 24h volume?"
-
-## Project Inspiration
-
-This project was inspired by Alex Andru's [coincap-mcp](https://github.com/QuantGeekDev/coincap-mcp) project.
+- "Search for cryptocurrencies matching 'sol'"
+- "Give me a global overview of the crypto market"
+- "Compare BTC, ETH, and SOL side by side"
+- "Show me 1-hour candlestick data for BTC on Binance over the last 3 days"
+- "Convert 2.5 BTC to EUR"
+- "Get detailed info about the Ethereum asset"
+- "Generate a comprehensive analysis of a cryptocurrency covering price, market, and historical trends"
+- "Find all cryptocurrencies with 'bit' in their name and show me their current prices"
+- "What's the market cap ranking and circulating supply of Cardano?"
+- "Compare the top 3 stablecoins and show which has the highest volume"
+- "Show me how Bitcoin has performed over the past 30 days with daily candles"
+- "Convert 100 SOL to GBP and show the exchange rate"
+- "Give me a full market snapshot: global metrics, top gainers, and BTC dominance"
+- "What are the best and worst performing cryptos in the last 24 hours?"
+- "Show me 15-minute candlestick data for ETH on Coinbase over the last 2 days"
+- "Compare DeFi tokens: UNI, AAVE, COMP, and MKR"
+- "What's the VWAP and max supply of Bitcoin?"
+- "Search for layer-2 tokens and compare the top results"
 
 ## License
 

package/dist/homepage.js

@@ -290,7 +290,7 @@ export function renderHomepage() {
             </div>
             <div class="metric">
               <strong>CLI example</strong>
-              <code>npx @smithery/cli install mcp-crypto-price --client claude</code>
+              <code>pnpm dlx @smithery/cli install mcp-crypto-price --client claude</code>
             </div>
             <div class="metric">
               <strong>Remote endpoint</strong>

package/dist/http.js

@@ -35,6 +35,7 @@ const serverCard = {
     serverInfo: {
         name: SERVER_CONFIG.name,
         version: SERVER_CONFIG.version,
+        description: 'A Model Context Protocol server providing cryptocurrency price, market, and on-chain data from CoinCap.',
     },
     tools: [
         {
@@ -204,6 +205,167 @@ const serverCard = {
                 openWorldHint: true,
             },
         },
+        {
+            name: 'search-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: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Search query — cryptocurrency name, symbol, or partial match (e.g. "bit", "eth", "doge")',
+                    },
+                    limit: {
+                        type: 'number',
+                        minimum: 1,
+                        maximum: 50,
+                        default: 10,
+                        description: 'Maximum number of results to return (1-50, default 10)',
+                    },
+                },
+                required: ['query'],
+            },
+            annotations: {
+                title: 'Search Crypto Assets',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        },
+        {
+            name: '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: {
+                type: 'object',
+            },
+            annotations: {
+                title: 'Get Global Metrics',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        },
+        {
+            name: 'compare-crypto',
+            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',
+                properties: {
+                    symbols: {
+                        type: 'string',
+                        description: 'Comma-separated list of 2-5 cryptocurrency symbols or names to compare (e.g. "BTC,ETH,SOL")',
+                    },
+                },
+                required: ['symbols'],
+            },
+            annotations: {
+                title: 'Compare Cryptocurrencies',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        },
+        {
+            name: 'get-candlestick-data',
+            description: 'Get OHLCV candlestick data for a cryptocurrency from a specific exchange. Useful for charting and technical analysis.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    symbol: {
+                        type: 'string',
+                        description: 'Cryptocurrency symbol or name (e.g. BTC or Bitcoin)',
+                    },
+                    exchange: {
+                        type: 'string',
+                        default: 'poloniex',
+                        description: 'Exchange ID (e.g. "poloniex", "bittrex", "kraken", "binance")',
+                    },
+                    quote: {
+                        type: 'string',
+                        default: 'usd',
+                        description: 'Quote currency ID (e.g. "usd", "usdt", "btc")',
+                    },
+                    interval: {
+                        type: 'string',
+                        enum: ['m5', 'm15', 'm30', 'h1', 'h2', 'h6', 'h12', 'd1'],
+                        default: 'h1',
+                        description: 'Candle interval: m5=5min, m15=15min, m30=30min, h1=1hr, h2=2hr, h6=6hr, h12=12hr, d1=daily',
+                    },
+                    days: {
+                        type: 'number',
+                        minimum: 1,
+                        maximum: 30,
+                        default: 1,
+                        description: 'Number of days of candlestick data to retrieve (1-30)',
+                    },
+                },
+                required: ['symbol'],
+            },
+            annotations: {
+                title: 'Get Candlestick Data',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        },
+        {
+            name: '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: {
+                type: 'object',
+                properties: {
+                    symbol: {
+                        type: 'string',
+                        description: 'Cryptocurrency symbol to convert from (e.g. BTC, ETH)',
+                    },
+                    amount: {
+                        type: 'number',
+                        minimum: 0,
+                        exclusiveMinimum: 0,
+                        default: 1,
+                        description: 'Amount of the cryptocurrency to convert (default 1)',
+                    },
+                    currency: {
+                        type: 'string',
+                        default: 'usd',
+                        description: 'Target currency code (e.g. "usd", "eur", "gbp", "jpy")',
+                    },
+                },
+                required: ['symbol'],
+            },
+            annotations: {
+                title: 'Get Price Conversion',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        },
+        {
+            name: 'get-asset-info',
+            description: 'Get detailed metadata for a cryptocurrency including ID, rank, supply, max supply, VWAP, market cap, and 24h volume.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    symbol: {
+                        type: 'string',
+                        description: 'Cryptocurrency symbol or name (e.g. BTC or Bitcoin)',
+                    },
+                },
+                required: ['symbol'],
+            },
+            annotations: {
+                title: 'Get Asset Info',
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        },
     ],
     resources: [
         {
@@ -212,12 +374,42 @@ const serverCard = {
             description: 'Basic server information',
             mimeType: 'application/json',
         },
+        {
+            name: 'asset-info',
+            uri: 'asset://{symbol}',
+            description: 'Cryptocurrency asset information by symbol (e.g. asset://BTC)',
+            mimeType: 'application/json',
+        },
     ],
     prompts: [
         {
             name: 'analyze-crypto',
             description: 'Generate a comprehensive analysis of a cryptocurrency covering price, market, and historical trends',
         },
+        {
+            name: 'compare-cryptocurrencies',
+            description: 'Compare 2-5 cryptocurrencies side-by-side covering price, market cap, volume, and 24h performance',
+        },
+        {
+            name: 'market-overview',
+            description: 'Get a comprehensive overview of the cryptocurrency market including global metrics, top assets, and top exchanges',
+        },
+        {
+            name: 'crypto-conversion',
+            description: 'Convert a cryptocurrency amount to a fiat currency with real-time rates',
+        },
+        {
+            name: 'exchange-analysis',
+            description: 'Analyze trading activity for a cryptocurrency across exchanges, including volume distribution and top markets',
+        },
+        {
+            name: 'technical-analysis',
+            description: 'Get a full technical analysis of a cryptocurrency including indicators, candlestick patterns, and historical trends',
+        },
+        {
+            name: 'crypto-screener',
+            description: 'Search for cryptocurrencies matching a query and screen the results for the best opportunities',
+        },
     ],
 };
 const httpServer = http.createServer(async (req, res) => {