{"id":49129432,"url":"https://github.com/vdalhambra/financekit-mcp","last_synced_at":"2026-04-24T14:01:06.077Z","repository":{"id":351047526,"uuid":"1208957928","full_name":"vdalhambra/financekit-mcp","owner":"vdalhambra","description":"Financial Market Intelligence MCP Server — stock quotes, technical analysis, crypto data, and portfolio insights for AI agents","archived":false,"fork":false,"pushed_at":"2026-04-13T12:17:54.000Z","size":110,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T12:29:11.211Z","etag":null,"topics":["ai-agent","claude-code","crypto","fastmcp","finance","mcp","mcp-server","stocks","technical-analysis"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vdalhambra.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-13T00:37:43.000Z","updated_at":"2026-04-13T12:17:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vdalhambra/financekit-mcp","commit_stats":null,"previous_names":["vdalhambra/financekit-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/vdalhambra/financekit-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdalhambra%2Ffinancekit-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdalhambra%2Ffinancekit-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdalhambra%2Ffinancekit-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdalhambra%2Ffinancekit-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vdalhambra","download_url":"https://codeload.github.com/vdalhambra/financekit-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdalhambra%2Ffinancekit-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32226408,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","claude-code","crypto","fastmcp","finance","mcp","mcp-server","stocks","technical-analysis"],"created_at":"2026-04-21T17:00:34.046Z","updated_at":"2026-04-24T14:01:06.055Z","avatar_url":"https://github.com/vdalhambra.png","language":"Python","funding_links":["https://github.com/sponsors/vdalhambra"],"categories":["Data Sources","Market Data \u0026 Data Sources","💰 Finance \u0026 Crypto","📦 Other"],"sub_categories":["Arbitrage"],"readme":"[![PyPI version](https://img.shields.io/pypi/v/financekit-mcp)](https://pypi.org/project/financekit-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![Glama MCP Server](https://glama.ai/mcp/servers/vdalhambra/financekit-mcp/badges/score.svg)](https://glama.ai/mcp/servers/vdalhambra/financekit-mcp)\n\n\u003c!-- mcp-name: io.github.vdalhambra/financekit-mcp --\u003e\n\n# FinanceKit MCP\n\n**Financial Market Intelligence for AI Agents** — real-time stock quotes, technical analysis, crypto data, and portfolio insights via the Model Context Protocol (MCP).\n\nFinanceKit is an MCP server that gives Claude Code, Cursor, Windsurf, and any AI agent instant access to financial market data. No API keys required for stocks and crypto.\n\n\u003e **Try it now — no install needed:** [Open FinanceKit in the MCPize Playground](https://mcpize.com/mcp/financekit-mcp/playground) — runs in your browser, free tier (100 calls/month)\n\n## Use Cases\n\nHere are concrete examples of what you can ask your AI agent once FinanceKit is installed:\n\n- **\"Run full technical analysis on TSLA and tell me if it's a buy\"** — Get RSI, MACD, Bollinger Bands, ADX, Stochastic, and pattern detection with a plain-English signal summary\n- **\"Compare AAPL vs MSFT vs GOOGL performance over the last 6 months\"** — Side-by-side returns, volatility, Sharpe ratio, and max drawdown\n- **\"Analyze my portfolio: AAPL:50, NVDA:20, MSFT:30, AMZN:10\"** — Total value, sector allocation, concentration risk, and diversification score\n- **\"What are the trending cryptocurrencies right now? Any worth watching?\"** — Top trending coins from CoinGecko with price data and momentum\n- **\"Give me a market overview — how are the major indices doing?\"** — S\u0026P 500, NASDAQ, Dow, VIX, and market sentiment in one call\n- **\"Is Bitcoin overbought? Show me RSI and Bollinger Band analysis\"** — Full technical analysis works on crypto too, not just stocks\n\n## Why FinanceKit?\n\n| Feature | FinanceKit MCP | Yahoo Finance API | Alpha Vantage | TradingView |\n|---------|---------------|-------------------|---------------|-------------|\n| Works with Claude Code / Cursor | Yes | No | No | No |\n| No API key needed | Yes | Yes | No (free tier) | No |\n| Technical analysis built-in | 10+ indicators | Raw data only | Limited | Manual |\n| Crypto + stocks in one tool | Yes | Stocks only | Separate APIs | Manual |\n| Portfolio analysis | Yes | No | No | No |\n| MCP native (stdio + HTTP) | Yes | REST only | REST only | Web only |\n| Free | Yes | Yes | Rate limited | Paid |\n\n## Tools (12)\n\n### Stocks\n| Tool | Description |\n|------|-------------|\n| `stock_quote` | Current price, change, volume, P/E, market cap |\n| `company_info` | Sector, financials, valuation metrics, description |\n| `multi_quote` | Batch quotes for up to 10 tickers at once |\n\n### Crypto\n| Tool | Description |\n|------|-------------|\n| `crypto_price` | Price, market cap, 1h/24h/7d changes, ATH data |\n| `crypto_trending` | Top 10 trending coins on CoinGecko |\n| `crypto_search` | Find coins by name or symbol |\n| `crypto_top_coins` | Top N coins ranked by market cap |\n\n### Technical Analysis\n| Tool | Description |\n|------|-------------|\n| `technical_analysis` | Full analysis: RSI, MACD, Bollinger Bands, SMA/EMA, ADX, Stochastic, ATR, OBV + pattern detection (Golden Cross, Death Cross, overbought/oversold) with plain-English signal summary |\n| `price_history` | Historical OHLCV data with summary statistics |\n\n### Market Overview\n| Tool | Description |\n|------|-------------|\n| `market_overview` | Major indices (S\u0026P 500, NASDAQ, Dow), VIX, market sentiment |\n\n### Portfolio \u0026 Comparison\n| Tool | Description |\n|------|-------------|\n| `compare_assets` | Side-by-side returns, volatility, Sharpe ratio, drawdown |\n| `portfolio_analysis` | Total value, allocation weights, sector breakdown, concentration risk |\n\n## Installation\n\n### ⭐ Recommended: MCPize (hosted, no setup)\n\nThe fastest way to get started. No terminal, no config files, no Python setup — works in any MCP client:\n\n👉 **[Install FinanceKit on MCPize](https://mcpize.com/mcp/financekit-mcp)** — Free tier available (100 calls/month)\n\nOr add to your MCP config directly:\n\n```json\n{\n  \"mcpServers\": {\n    \"financekit\": {\n      \"url\": \"https://financekit-mcp.mcpize.run/mcp\"\n    }\n  }\n}\n```\n\n**Why MCPize?**\n- ✅ Zero setup — works immediately in Claude Desktop, Cursor, Windsurf, Claude Code\n- ✅ Always up-to-date — new features deployed automatically\n- ✅ Scales with you — upgrade to Pro ($29/mo) for 10,000 calls + priority + all premium tools\n- ✅ Reliable uptime — managed cloud infrastructure\n- ✅ Analytics — track how your agents use the tools\n\nSee [pricing](#pricing) below for all tiers including Team, Business, and Enterprise.\n\n---\n\n### 💻 Advanced: Self-hosted (developers)\n\nFor those who prefer to run the server locally:\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code CLI\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nclaude mcp add financekit -- uvx --from financekit-mcp financekit\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Desktop / Cursor / Windsurf (local)\u003c/b\u003e\u003c/summary\u003e\n\n```json\n{\n  \"mcpServers\": {\n    \"financekit\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"financekit-mcp\", \"financekit\"]\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eFrom PyPI\u003c/b\u003e\u003c/summary\u003e\n\n```bash\npip install financekit-mcp\nfinancekit\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eFrom source\u003c/b\u003e\u003c/summary\u003e\n\n```bash\ngit clone https://github.com/vdalhambra/financekit-mcp.git\ncd financekit-mcp\nuv sync\nuv run financekit\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eSmithery\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nnpx -y @smithery/cli install @vdalhambra/financekit --client claude\n```\n\u003c/details\u003e\n\n\u003e **Note:** Self-hosted = full feature access but you manage updates, uptime, and infrastructure. For most users, MCPize is the better choice.\n\n---\n\n## Pricing\n\n| Tier | Price | Calls/month | Includes |\n|------|-------|-------------|----------|\n| **Free** | $0 | 100 | 5 basic tools (quotes, company info, crypto price) |\n| **Hobby** | $9/mo | 2,500 | Most tools — no portfolio or market overview |\n| **Pro** ⭐ | $29/mo | 10,000 | All 12 tools + priority + premium features |\n| **Team** | $79/mo | 50,000 | Pro + 5 seats + CSV export + email support |\n| **Business** | $179/mo | 200,000 | Team + webhooks + alerts + SLA |\n| **Enterprise** | $499/mo | Unlimited | Business + white-label + on-prem + dedicated support |\n\n**Annual plans:** Get 2 months free (pay for 10, use 12).\n\n**Bundle:** Combine with [SiteAudit MCP](https://github.com/vdalhambra/siteaudit-mcp) for **$39/mo** (Pro Combo — save 19%).\n\n👉 **[View all pricing on MCPize](https://mcpize.com/mcp/financekit-mcp)**\n\n## Data Sources\n\n- **Stocks**: Yahoo Finance (via yfinance) — free, no API key\n- **Crypto**: CoinGecko API (free tier, 10K calls/month)\n- **Technical Indicators**: Calculated locally using the `ta` library (RSI, MACD, Bollinger Bands, ADX, Stochastic, ATR, OBV)\n\nAll data is cached to minimize API calls: quotes (60s), historical data (1h), crypto (2min), company info (24h).\n\n## Examples\n\n### Technical Analysis Output\n\n```\nSymbol: AAPL\nCurrent Price: 260.48\nIndicators:\n  RSI(14): 55.65 — neutral\n  MACD: histogram positive — bullish momentum\n  Bollinger Bands: price within bands — normal\n  SMA(50): 260.84\n  ADX: 18.3 — weak/no trend\nPatterns:\n  Golden Cross: false\n  Overbought: false\n```\n\n### Portfolio Analysis Output\n\n```\nTotal Value: $45,230.50\nPositions: 3\nConcentration Risk: MODERATE\nSector Breakdown:\n  Technology: 85.2%\n  Communication Services: 14.8%\n```\n\n## Compatible AI Agents\n\nFinanceKit works with any AI agent or IDE that supports the Model Context Protocol:\n\n- **Claude Code** (CLI) — `claude mcp add`\n- **Claude Desktop** — `claude_desktop_config.json`\n- **Cursor** — `.cursor/mcp.json`\n- **Windsurf** — MCP settings\n- **Copilot** — MCP configuration\n- **Any MCP client** — stdio or HTTP transport\n\n## Support this project\n\nIf FinanceKit is useful to you, please consider supporting ongoing development:\n\n- 💎 **[Upgrade to Pro on MCPize](https://mcpize.com/mcp/financekit-mcp)** — Best way to support + get premium features\n- ⭐ **Star this repo** — Helps other developers find it\n- 💖 **[Sponsor on GitHub](https://github.com/sponsors/vdalhambra)** — One-time or recurring support\n- 🐦 **Share on Twitter/X** — Tag [@ElAgenteRayo](https://twitter.com/ElAgenteRayo)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvdalhambra%2Ffinancekit-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvdalhambra%2Ffinancekit-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvdalhambra%2Ffinancekit-mcp/lists"}