{"_id":"@aigroup/finnhub-mcp","name":"@aigroup/finnhub-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aigroup/finnhub-mcp","version":"1.0.0","description":"Node.js MCP server for Finnhub financial data API - Complete implementation with 15 tools for stock market data, crypto, forex, and more","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"aigroup-finnhub-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx watch src/index.ts","start":"node dist/index.js","test":"vitest","test:ui":"vitest --ui","lint":"eslint src/**/*.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm run build","publish:public":"npm publish --access public"},"keywords":["mcp","model-context-protocol","finnhub","finance","stocks","crypto","forex","api","ai","claude","typescript"],"author":{"name":"jackdark425","email":"jackdark425@gmail.com"},"license":"MIT","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.6.0","convict":"^6.2.4","dotenv":"^16.3.0","pino":"^8.17.0","pino-pretty":"^10.3.0","zod":"^3.22.0","tiktoken":"^1.0.0","bullmq":"^5.0.0","ioredis":"^5.3.0","uuid":"^9.0.0"},"devDependencies":{"@types/convict":"^6.1.6","@types/node":"^20.10.0","@types/uuid":"^9.0.0","@typescript-eslint/eslint-plugin":"^6.14.0","@typescript-eslint/parser":"^6.14.0","eslint":"^8.55.0","tsx":"^4.7.0","typescript":"^5.3.0","vitest":"^1.1.0","@vitest/ui":"^1.1.0"},"gitHead":"081ec34af081ce39f8b79fe137c82d41e9ced446","_id":"@aigroup/finnhub-mcp@1.0.0","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-8Uw/HsGSK/JQApAMjdeSM9JLCT++q2zDTtHwYhcIrjUIlll2S4aU8dMcJeiJew/ndOnh+pGG6X/aAuSedP7ROQ==","shasum":"1443f4fa7ba057b99bf3b31623f948b87357f39f","tarball":"https://registry.npmjs.org/@aigroup/finnhub-mcp/-/finnhub-mcp-1.0.0.tgz","fileCount":206,"unpackedSize":361934,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAN+iVWcpbYVbQh8MC/ebW+VRxvlPrtzfZTZBfuJunT6AiBF1NTP2ymz26Ut/0BPbovV+abYGWtYceKRGpuem36fvw=="}]},"_npmUser":{"name":"jackdark425","email":"jackdark425@gmail.com"},"directories":{},"maintainers":[{"name":"jackdark425","email":"jackdark425@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/finnhub-mcp_1.0.0_1773717878621_0.8462778137843763"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-17T03:24:38.529Z","1.0.0":"2026-03-17T03:24:38.793Z","modified":"2026-03-17T03:24:39.022Z"},"maintainers":[{"name":"jackdark425","email":"jackdark425@gmail.com"}],"description":"Node.js MCP server for Finnhub financial data API - Complete implementation with 15 tools for stock market data, crypto, forex, and more","keywords":["mcp","model-context-protocol","finnhub","finance","stocks","crypto","forex","api","ai","claude","typescript"],"author":{"name":"jackdark425","email":"jackdark425@gmail.com"},"license":"MIT","readme":"# aigroup-finnhub-mcp\r\n\r\nNode.js implementation of the MCP (Model Context Protocol) server for Finnhub financial data API.\r\n\r\n## Quick Start with npx\r\n\r\n```bash\r\nnpx aigroup-finnhub-mcp\r\n```\r\n\r\nOr with environment variables:\r\n```bash\r\nFINNHUB_API_KEY=your_api_key npx aigroup-finnhub-mcp\r\n```\r\n\r\n## Features\r\n\r\n- **15 MCP Tools**: Complete set of financial data tools\r\n- **TypeScript**: Full type safety with Zod validation\r\n- **Rate Limiting**: Built-in token bucket rate limiter\r\n- **Retry Logic**: Exponential backoff with jitter\r\n- **Error Handling**: Comprehensive error types and handling\r\n\r\n## Available Tools\r\n\r\n| Tool | Operations | Description |\r\n|------|-----------|-------------|\r\n| `finnhub_stock_market_data` | 7 | Quotes, candles, profiles, financials |\r\n| `finnhub_technical_analysis` | 4 | 50+ indicators, patterns, signals |\r\n| `finnhub_news_sentiment` | 4 | News, sentiment analysis |\r\n| `finnhub_stock_fundamentals` | 5 | Financial metrics, dividends, splits |\r\n| `finnhub_crypto_data` | 4 | Crypto exchanges, symbols, prices |\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install\r\n```\r\n\r\n## Configuration\r\n\r\n1. Copy `.env.example` to `.env`:\r\n```bash\r\ncp .env.example .env\r\n```\r\n\r\n2. Edit `.env` and add your Finnhub API key:\r\n```\r\nFINNHUB_API_KEY=your_api_key_here\r\n```\r\n\r\nGet your API key at [Finnhub Dashboard](https://finnhub.io/dashboard).\r\n\r\n## Usage\r\n\r\n### Development\r\n```bash\r\nnpm run dev\r\n```\r\n\r\n### Build\r\n```bash\r\nnpm run build\r\n```\r\n\r\n### Start\r\n```bash\r\nnpm start\r\n```\r\n\r\n### MCP Configuration (npx)\r\n\r\nAdd to your Claude Desktop config (`%APPDATA%\\\\Claude\\\\claude_desktop_config.json` on Windows or `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"aigroup-finnhub\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"aigroup-finnhub-mcp\"],\r\n      \"env\": {\r\n        \"FINNHUB_API_KEY\": \"d6j77dpr01ql467igom0d6j77dpr01ql467igomg\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nOr using local path:\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"aigroup-finnhub\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"D:/mcp-finnhub-main/mcp-finnhub-node/dist/index.js\"],\r\n      \"env\": {\r\n        \"FINNHUB_API_KEY\": \"d6j77dpr01ql467igom0d6j77dpr01ql467igomg\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## API Reference\r\n\r\n### finnhub_stock_market_data\r\n\r\nOperations:\r\n- `get_quote` - Real-time stock quote\r\n- `get_candles` - Historical OHLCV data\r\n- `get_company_profile` - Company information\r\n- `symbol_lookup` - Search symbols\r\n- `get_basic_financials` - Financial metrics\r\n- `get_financials_as_reported` - SEC financial statements\r\n- `get_earnings_surprises` - Earnings surprises\r\n\r\n### finnhub_technical_analysis\r\n\r\nOperations:\r\n- `get_indicator` - Technical indicators (RSI, MACD, etc.)\r\n- `get_aggregate_signals` - Buy/sell/neutral signals\r\n- `get_pattern_recognition` - Chart patterns\r\n- `get_support_resistance` - S/R levels\r\n\r\n### finnhub_news_sentiment\r\n\r\nOperations:\r\n- `get_company_news` - Company news articles\r\n- `get_market_news` - General market news\r\n- `get_news_sentiment` - News sentiment scores\r\n- `get_insider_sentiment` - Insider trading sentiment\r\n\r\n## Development\r\n\r\n```bash\r\n# Type check\r\nnpm run typecheck\r\n\r\n# Lint\r\nnpm run lint\r\n\r\n# Test\r\nnpm run test\r\n```\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md","_rev":"1-02c676975e080f84bb2702f8e38156f7"}