{"_id":"@aiorg/mcp-financial-sentiment","name":"@aiorg/mcp-financial-sentiment","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aiorg/mcp-financial-sentiment","version":"0.1.0","description":"MCP server for financial news and sentiment analysis (Finnhub + StockGeist)","type":"module","publishConfig":{"access":"public"},"bin":{"mcp-financial-sentiment":"dist/index.js"},"scripts":{"build":"tsup","dev":"tsup --watch","typecheck":"tsc --noEmit","test":"vitest run","test:watch":"vitest","prepublishOnly":"pnpm build"},"keywords":["mcp","claude","financial","sentiment","finnhub","stockgeist","investing"],"author":{"name":"aiorg.dev"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aiorgdev/mcp-financial-sentiment.git"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.25.2","zod":"^3.24.1"},"devDependencies":{"@types/node":"^22.10.5","tsup":"^8.3.5","typescript":"^5.7.2","vitest":"^2.1.8"},"_id":"@aiorg/mcp-financial-sentiment@0.1.0","gitHead":"b11e258a5203ae2a40432cce5aa6ba36569241a4","bugs":{"url":"https://github.com/aiorgdev/mcp-financial-sentiment/issues"},"homepage":"https://github.com/aiorgdev/mcp-financial-sentiment#readme","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-fsWAdxKk6MYb9eN1T2rFBDr0onS/WoIiUPaVRyvYuDLZYrKd+Pk2T8PzguXgMeSbKL2zCNtxLios8j20UipNuw==","shasum":"d25a23834bbfd2fcb80085c73cb843abde5bd133","tarball":"https://registry.npmjs.org/@aiorg/mcp-financial-sentiment/-/mcp-financial-sentiment-0.1.0.tgz","fileCount":4,"unpackedSize":19451,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEeqVCm/GLgSlH990BgKfCsuRcs19Q3UOXcm8rqGhqDZAiEA0EeIq6W5xK+745m9jtSEyq5m25rHHU9lNPvPjY6lsfA="}]},"_npmUser":{"name":"lukasfryc","email":"fryc.lukasz@gmail.com"},"directories":{},"maintainers":[{"name":"lukasfryc","email":"fryc.lukasz@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-financial-sentiment_0.1.0_1768125642743_0.12988312206720654"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-11T10:00:42.593Z","0.1.0":"2026-01-11T10:00:42.890Z","modified":"2026-01-11T10:00:43.304Z"},"maintainers":[{"name":"lukasfryc","email":"fryc.lukasz@gmail.com"}],"description":"MCP server for financial news and sentiment analysis (Finnhub + StockGeist)","homepage":"https://github.com/aiorgdev/mcp-financial-sentiment#readme","keywords":["mcp","claude","financial","sentiment","finnhub","stockgeist","investing"],"repository":{"type":"git","url":"git+https://github.com/aiorgdev/mcp-financial-sentiment.git"},"author":{"name":"aiorg.dev"},"bugs":{"url":"https://github.com/aiorgdev/mcp-financial-sentiment/issues"},"license":"MIT","readme":"# @aiorg/mcp-financial-sentiment\n\nMCP server for financial news and sentiment analysis. Provides tools for monitoring stock sentiment from news (Finnhub) and social media (StockGeist).\n\n## Features\n\n- **News Analysis**: Fetch and analyze company news from Finnhub\n- **Social Sentiment**: Get sentiment from Reddit and Twitter via StockGeist\n- **Narrative Detection**: Search for specific themes/keywords in headlines\n- **Trigger Checking**: Automatically evaluate sentiment-based investment triggers\n- **Caching**: 15-minute cache to respect API rate limits\n\n## Installation\n\n```bash\nnpx @aiorg/mcp-financial-sentiment\n```\n\nOr add to your Claude Code MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"financial-sentiment\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aiorg/mcp-financial-sentiment\"],\n      \"env\": {\n        \"FINNHUB_API_KEY\": \"${FINNHUB_API_KEY}\",\n        \"STOCKGEIST_API_KEY\": \"${STOCKGEIST_API_KEY}\"\n      }\n    }\n  }\n}\n```\n\n## Setup\n\n### 1. Finnhub API Key (FREE)\n\n1. Go to [finnhub.io/register](https://finnhub.io/register)\n2. Create free account\n3. Copy API key\n4. Add to `.env`: `FINNHUB_API_KEY=your_key_here`\n\nFree tier includes:\n- 60 API calls/minute\n- 1 year of historical news\n- Real-time news updates\n\n### 2. StockGeist API Key (FREE credits)\n\n1. Go to [api.stockgeist.ai/signup](https://api.stockgeist.ai/signup)\n2. Create account (10k free credits)\n3. Copy API key\n4. Add to `.env`: `STOCKGEIST_API_KEY=your_key_here`\n\n## Tools\n\n### `get_news`\n\nFetch recent news for a stock ticker.\n\n```\nInput: { ticker: \"AMZN\", days: 7 }\nOutput: {\n  ticker: \"AMZN\",\n  news: [\n    { headline: \"...\", summary: \"...\", source: \"...\", datetime: \"...\", url: \"...\" }\n  ],\n  totalCount: 15\n}\n```\n\n### `get_social_sentiment`\n\nGet social media sentiment from Reddit and Twitter.\n\n```\nInput: { ticker: \"AMZN\" }\nOutput: {\n  ticker: \"AMZN\",\n  sentiment: {\n    score: -0.35,\n    label: \"bearish\",\n    volume: 1250,\n    sources: { reddit: 800, twitter: 450 }\n  }\n}\n```\n\n### `check_narrative`\n\nSearch for specific narratives/keywords in news headlines.\n\n```\nInput: {\n  ticker: \"AMZN\",\n  keywords: [\"AWS lagging\", \"cloud share loss\", \"Google Cloud gains\"],\n  days: 7\n}\nOutput: {\n  matches: [\n    { headline: \"...\", matchedKeywords: [\"cloud share loss\"], sentiment: \"negative\", url: \"...\" }\n  ],\n  narrativeStrength: \"emerging\"\n}\n```\n\n### `check_triggers`\n\nEvaluate sentiment-based investment triggers.\n\n```\nInput: {\n  ticker: \"AMZN\",\n  triggers: [\n    \"Bearish social sentiment on AWS\",\n    \"AWS lagging narrative in headlines\"\n  ]\n}\nOutput: {\n  ticker: \"AMZN\",\n  triggersChecked: 2,\n  triggersFired: 1,\n  results: [\n    { trigger: \"...\", type: \"sentiment\", status: \"fired\", details: \"...\" }\n  ],\n  recommendation: \"1 trigger(s) fired! Review AMZN for potential action.\"\n}\n```\n\n## Use Cases\n\n### Contrarian Investing\n\nMonitor when sentiment becomes overly negative for quality companies:\n\n```\nUse check_triggers with:\n- \"Bearish analyst sentiment\"\n- \"Negative social media sentiment\"\n- \"Share loss narrative dominates headlines\"\n```\n\n### Morning Briefing\n\nIntegrate with Investor OS `/brief` command to automatically check watchlist sentiment.\n\n### Earnings Watch\n\nBefore earnings, check narrative sentiment to gauge market expectations.\n\n## Caching\n\nAll API responses are cached for 15 minutes to:\n- Respect API rate limits\n- Speed up repeated queries\n- Reduce costs on paid tiers\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-c688b603cdd09dc265d2ab6b542e4cfc"}