{"_id":"market-data-analyzer","_rev":"11-051caa410363b2050fbad0a25e6b537b","name":"market-data-analyzer","dist-tags":{"latest":"2.1.4"},"versions":{"2.1.1":{"name":"market-data-analyzer","version":"2.1.1","keywords":["mcp","finance","stocks","crypto","technical-analysis","portfolio","market-data","trading","yahoo-finance","coingecko"],"license":"MIT","_id":"market-data-analyzer@2.1.1","maintainers":[{"name":"aivp","email":"wasuppeople3@gmail.com"}],"bin":{"market-data-analyzer":"dist/index.js"},"dist":{"shasum":"2fcd72c33826c3597e5e4d94bf57791aae3c3f80","tarball":"https://registry.npmjs.org/market-data-analyzer/-/market-data-analyzer-2.1.1.tgz","fileCount":38,"integrity":"sha512-sZwMqRbUKvM6ODm9FgppRaL+kYY+anuBR8EtmXnXe2n2fEVz0W2hsCESw5Ywe4Ym27Vh7LlSn11ReMSFQPWqTA==","signatures":[{"sig":"MEUCIEbUVrhRuhW4pyuRu2iNp9KwQm+WD+hH4v/GFKFhYnNjAiEA8vnjX94KsZYktWiAFSxhwfY50AZ053tSjA/E2JlfNT4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":118452},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"4c2db3d7214a1ecbb45e5c3d246105a0288cd2ea","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","start:sse":"node dist/index.js --sse","prepublishOnly":"npm run build"},"_npmUser":{"name":"aivp","email":"wasuppeople3@gmail.com"},"_npmVersion":"11.11.0","description":"MCP server for financial market data analysis -- live stock analysis, screening, portfolio analytics, crypto analysis, and market overview using free APIs.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/market-data-analyzer_2.1.1_1774963706961_0.6266823136960116","host":"s3://npm-registry-packages-npm-production"}},"2.1.3":{"name":"market-data-analyzer","version":"2.1.3","keywords":["mcp","finance","stocks","crypto","technical-analysis","portfolio","market-data","trading","yahoo-finance","coingecko"],"license":"MIT","_id":"market-data-analyzer@2.1.3","maintainers":[{"name":"aivp","email":"wasuppeople3@gmail.com"}],"bin":{"market-data-analyzer":"dist/index.js"},"dist":{"shasum":"399cdd123b71e8f6fcc0be44bb3fec57e98b3b22","tarball":"https://registry.npmjs.org/market-data-analyzer/-/market-data-analyzer-2.1.3.tgz","fileCount":26,"integrity":"sha512-ZTinHDj6/3PvQs3SBYGgWflAuvwN96t+BDsQrqUAB3c18N/YUyIIJiEWmdtc3oU56SMnzkMCijx3xYP4PjYn6A==","signatures":[{"sig":"MEQCIBAckxiqyXlVqnh3p0mQNDwuRBNeV1vjBty2R7FrbTI/AiAZ6bw8R+PXf7kuoAVv+5W8gb92xuuc6YFa9nNHEuln9w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":108326},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"90f4c3072f2309527d7163ea89461f69604894e2","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","start:sse":"node dist/index.js --sse","prepublishOnly":"npm run build"},"_npmUser":{"name":"aivp","email":"wasuppeople3@gmail.com"},"_npmVersion":"11.11.0","description":"MCP server for financial market data analysis -- live stock analysis, screening, portfolio analytics, crypto analysis, and market overview using free APIs.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/market-data-analyzer_2.1.3_1775025175598_0.8317524934144098","host":"s3://npm-registry-packages-npm-production"}},"2.1.4":{"name":"market-data-analyzer","version":"2.1.4","description":"MCP server for financial market data analysis -- live stock analysis, screening, portfolio analytics, crypto analysis, and market overview using free APIs.","mcpName":"io.github.vpatser1/market-data-analyzer","repository":{"type":"git","url":"git+https://github.com/vpatser1/mcp-servers.git","directory":"market-data-analyzer"},"homepage":"https://aivp-mcp.vercel.app","type":"module","main":"dist/index.js","bin":{"market-data-analyzer":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","start:sse":"node dist/index.js --sse","dev":"tsc --watch","prepublishOnly":"npm run build"},"keywords":["mcp","finance","stocks","crypto","technical-analysis","portfolio","market-data","trading","yahoo-finance","coingecko"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0"},"engines":{"node":">=18.0.0"},"gitHead":"31655a90ad0cac3d56211a1e7a88dccaaef73640","types":"./dist/index.d.ts","_id":"market-data-analyzer@2.1.4","bugs":{"url":"https://github.com/vpatser1/mcp-servers/issues"},"_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-+7Nyomc7JxN6k7G/rfOPDj0Zjtp/UoS1auZ66aIDzosP6V5ktcBtgPuRBHJydrcU7YtOL7CvVtiOo/RAE+TO4A==","shasum":"6674f03744a4acc8fb92c84b152ad9b6ad122c56","tarball":"https://registry.npmjs.org/market-data-analyzer/-/market-data-analyzer-2.1.4.tgz","fileCount":26,"unpackedSize":115753,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFCdqdWACuSwov38PAFsOzmNe67lTs4mBvZ/HSu6ASFoAiAnwO/DoOjv9NKZJB/zKBtPIGgZ0Xq6EWrgt9iHa1D/PA=="}]},"_npmUser":{"name":"aivp","email":"wasuppeople3@gmail.com"},"directories":{},"maintainers":[{"name":"aivp","email":"wasuppeople3@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/market-data-analyzer_2.1.4_1785828917051_0.8063016952767241"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T11:24:29.804Z","modified":"2026-08-04T07:35:17.334Z","2.0.0":"2026-03-31T11:24:30.050Z","2.0.1":"2026-03-31T12:41:34.482Z","2.1.0":"2026-03-31T12:58:59.000Z","2.1.1":"2026-03-31T13:28:27.109Z","2.1.2":"2026-04-01T06:26:34.947Z","2.1.3":"2026-04-01T06:32:55.763Z","2.1.4":"2026-08-04T07:35:17.194Z"},"license":"MIT","keywords":["mcp","finance","stocks","crypto","technical-analysis","portfolio","market-data","trading","yahoo-finance","coingecko"],"description":"MCP server for financial market data analysis -- live stock analysis, screening, portfolio analytics, crypto analysis, and market overview using free APIs.","maintainers":[{"name":"aivp","email":"wasuppeople3@gmail.com"}],"readme":"# Market Data Analyzer MCP Server\n\nFinance-focused MCP server providing live market data analysis. Analyze stocks with technical indicators, screen for opportunities, track portfolios, compare assets, monitor market conditions, and analyze crypto -- all powered by free APIs (Yahoo Finance + CoinGecko).\n\n## Pricing\n\n| Plan | Price | Includes |\n|------|-------|----------|\n| **Basic** | $15/mo | `analyze_stock`, `screen_stocks`, `market_overview` — [Buy →](https://buy.stripe.com/4gM9AL76idaA3QLe7RgIo08) |\n| **Pro** | $25/mo | All 6 tools + priority data refresh — [Buy →](https://buy.stripe.com/14A6oz76i3A01ID3tdgIo09) |\n\nFree trial: 3 calls total (shared across all tools), no credit card. License keys are emailed instantly after checkout. Activate via the `LICENSE_KEY` environment variable. More info: [aivp-mcp.vercel.app](https://aivp-mcp.vercel.app)\n\n## Tools\n\n### `analyze_stock`\nDeep analysis of a stock symbol with live Yahoo Finance data.\n\n**Output:** Price overview, SMA (20/50/200), RSI (14), MACD (12,26,9), support/resistance levels, golden/death cross detection, signal summary.\n\n```json\n{ \"symbol\": \"AAPL\" }\n```\n\n### `screen_stocks`\nScreen ~70 popular stocks by criteria with live data.\n\n**Filters:** Market cap range, P/E ratio, sector, volume threshold, price range.\n\n```json\n{\n  \"sector\": \"tech\",\n  \"max_pe\": 40,\n  \"min_market_cap\": 500000000000,\n  \"limit\": 10\n}\n```\n\n### `analyze_portfolio`\nAnalyze a portfolio of holdings with live price lookup.\n\n**Output:** Total value, P&L per position, allocation %, sector breakdown, diversification score (HHI-based), concentration warnings.\n\n```json\n{\n  \"holdings\": [\n    { \"symbol\": \"AAPL\", \"shares\": 100, \"avg_cost\": 150.00 },\n    { \"symbol\": \"MSFT\", \"shares\": 50, \"avg_cost\": 380.00 },\n    { \"symbol\": \"JPM\", \"shares\": 75, \"avg_cost\": 195.00 }\n  ]\n}\n```\n\n### `compare_assets`\nCompare 2-5 assets side by side over a configurable period.\n\n**Output:** Returns, volatility, Sharpe ratio, max drawdown, correlation matrix, rankings.\n\n```json\n{\n  \"symbols\": [\"AAPL\", \"MSFT\", \"GOOGL\"],\n  \"period\": \"1y\"\n}\n```\n\n### `market_overview`\nLive market snapshot with no arguments needed.\n\n**Output:** Major indices (S&P 500, NASDAQ, DOW, Russell 2000), VIX interpretation, sector ETF performance, crypto & commodities, market sentiment score.\n\n```json\n{}\n```\n\n### `crypto_analysis`\nCrypto-specific analysis via CoinGecko free API.\n\n**Output:** Price, 24h/7d/30d changes, volume, market cap, dominance, supply metrics, ATH/ATL, fear & greed approximation, global crypto market context.\n\n```json\n{ \"symbol\": \"BTC\" }\n```\n\n## Installation\n\nNo install step needed — run straight from npm:\n\n```bash\nnpx -y market-data-analyzer\n```\n\nOr install globally:\n\n```bash\nnpm install -g market-data-analyzer\n```\n\n## Usage\n\n### Stdio transport (default)\n```bash\nnpx -y market-data-analyzer\n```\n\n### SSE transport\n```bash\nnpx -y market-data-analyzer --sse\n# or with custom port\nPORT=8080 npx -y market-data-analyzer --sse\n```\n\n### Claude Desktop configuration\n```json\n{\n  \"mcpServers\": {\n    \"market-data-analyzer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"market-data-analyzer\"],\n      \"env\": { \"LICENSE_KEY\": \"<your license key — omit for free trial>\" }\n    }\n  }\n}\n```\n\n### SSE endpoints\n- `GET /sse` -- SSE connection endpoint\n- `POST /messages?sessionId=<id>` -- Message endpoint\n- `GET /health` -- Health check\n\n## Data Sources\n\n| Source | Used By | Rate Limits |\n|--------|---------|-------------|\n| Yahoo Finance (free) | `analyze_stock`, `screen_stocks`, `analyze_portfolio`, `compare_assets`, `market_overview` | Unofficial, best-effort |\n| CoinGecko (free API) | `crypto_analysis` | 10-30 calls/min |\n\nAll price data is cached in-memory with a 5-minute TTL to minimize API calls and improve response times.\n\n## Technical Details\n\n- **Runtime:** Node.js 18+\n- **Language:** TypeScript (strict mode, ES modules)\n- **Protocol:** Model Context Protocol (MCP) via `@modelcontextprotocol/sdk`\n- **Dependencies:** `@modelcontextprotocol/sdk` + `zod` only\n- **Caching:** In-memory with 5-minute TTL for all price data\n- **Calculations:** SMA, EMA, RSI, MACD, Sharpe ratio, max drawdown, HHI diversification, support/resistance -- all implemented from scratch\n\n## Project Structure\n\n```\nsrc/\n  index.ts              # Server setup, tool registration, transports\n  types.ts              # TypeScript interfaces\n  tools/\n    analyze_stock.ts    # Stock analysis with technical indicators\n    screen_stocks.ts    # Stock screener with live data\n    analyze_portfolio.ts # Portfolio analytics\n    compare_assets.ts   # Multi-asset comparison\n    market_overview.ts  # Market snapshot\n    crypto_analysis.ts  # Crypto analysis via CoinGecko\n  utils/\n    api.ts              # Yahoo Finance + CoinGecko API helpers\n    cache.ts            # In-memory TTL cache\n    math.ts             # Financial math (SMA, RSI, MACD, etc.)\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","homepage":"https://aivp-mcp.vercel.app","repository":{"type":"git","url":"git+https://github.com/vpatser1/mcp-servers.git","directory":"market-data-analyzer"},"bugs":{"url":"https://github.com/vpatser1/mcp-servers/issues"}}