mcpField
F
financekit-mcp

financekit-mcp

Local
github.com/vdalhambraFinance9Updated 28w ago

About financekit-mcp

FinanceKit MCP is a financial data server for AI agents and MCP-compatible clients. It provides stock and crypto data, technical indicators, market comparisons, and portfolio analysis through 12 tools.

Key features

  1. 01Stock quotes and company information
  2. 02Crypto prices, trends, and search
  3. 03Technical indicators and pattern detection
  4. 04Historical prices and market overview
  5. 05Asset comparisons and portfolio analysis

Use cases

  1. 01Review technical signals for a stock or crypto asset
  2. 02Compare returns and risk across tickers
  3. 03Inspect portfolio allocation and concentration
  4. 04Check major indices and market sentiment

MCP support

The server exposes 12 financial-data tools to MCP clients over stdio or HTTP. It can be used as a hosted endpoint or run locally.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"vdalhambra-financekit": {
"command": "uvx",
"args": [
"financekit-mcp"
]
}
}
}
Run commanduvx financekit-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypifinancekit-mcp1.2.0

Tools

17

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
symbolstringYesStock ticker symbol (e.g., AAPL, MSFT, TSLA)

Details

From the project README

PyPI version License: MIT Python 3.11+ Glama MCP Server

FinanceKit MCP

Financial Market Intelligence for AI Agents — real-time stock quotes, technical analysis, crypto data, and portfolio insights via the Model Context Protocol (MCP).

FinanceKit 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.

Try it now — no install needed: Open FinanceKit in the MCPize Playground — runs in your browser, free tier (100 calls/month)

Use Cases

Here are concrete examples of what you can ask your AI agent once FinanceKit is installed:

  • "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
  • "Compare AAPL vs MSFT vs GOOGL performance over the last 6 months" — Side-by-side returns, volatility, Sharpe ratio, and max drawdown
  • "Analyze my portfolio: AAPL:50, NVDA:20, MSFT:30, AMZN:10" — Total value, sector allocation, concentration risk, and diversification score
  • "What are the trending cryptocurrencies right now? Any worth watching?" — Top trending coins from CoinGecko with price data and momentum
  • "Give me a market overview — how are the major indices doing?" — S&P 500, NASDAQ, Dow, VIX, and market sentiment in one call
  • "Is Bitcoin overbought? Show me RSI and Bollinger Band analysis" — Full technical analysis works on crypto too, not just stocks

Why FinanceKit?

FeatureFinanceKit MCPYahoo Finance APIAlpha VantageTradingView
Works with Claude Code / CursorYesNoNoNo
No API key neededYesYesNo (free tier)No
Technical analysis built-in10+ indicatorsRaw data onlyLimitedManual
Crypto + stocks in one toolYesStocks onlySeparate APIsManual
Portfolio analysisYesNoNoNo
MCP native (stdio + HTTP)YesREST onlyREST onlyWeb only
FreeYesYesRate limitedPaid

Tools (12)

Stocks
ToolDescription
stock_quoteCurrent price, change, volume, P/E, market cap
company_infoSector, financials, valuation metrics, description
multi_quoteBatch quotes for up to 10 tickers at once
Crypto
ToolDescription
crypto_pricePrice, market cap, 1h/24h/7d changes, ATH data
crypto_trendingTop 10 trending coins on CoinGecko
crypto_searchFind coins by name or symbol
crypto_top_coinsTop N coins ranked by market cap
Technical Analysis
ToolDescription
technical_analysisFull analysis: RSI, MACD, Bollinger Bands, SMA/EMA, ADX, Stochastic, ATR, OBV + pattern detection (Golden Cross, Death Cross, overbought/oversold) with plain-English signal summary
price_historyHistorical OHLCV data with summary statistics
Market Overview
ToolDescription
market_overviewMajor indices (S&P 500, NASDAQ, Dow), VIX, market sentiment
Portfolio & Comparison
ToolDescription
compare_assetsSide-by-side returns, volatility, Sharpe ratio, drawdown
portfolio_analysisTotal value, allocation weights, sector breakdown, concentration risk

Installation

⭐ Recommended: MCPize (hosted, no setup)

The fastest way to get started. No terminal, no config files, no Python setup — works in any MCP client:

👉 Install FinanceKit on MCPize — Free tier available (100 calls/month)

Or add to your MCP config directly:

{
  "mcpServers": {
    "financekit": {
      "url": "https://financekit-mcp.mcpize.run/mcp"
    }
  }
}

Why MCPize?

  • ✅ Zero setup — works immediately in Claude Desktop, Cursor, Windsurf, Claude Code
  • ✅ Always up-to-date — new features deployed automatically
  • ✅ Scales with you — upgrade to Pro ($29/mo) for 10,000 calls + priority + all premium tools
  • ✅ Reliable uptime — managed cloud infrastructure
  • ✅ Analytics — track how your agents use the tools

See pricing below for all tiers including Team, Business, and Enterprise.


💻 Advanced: Self-hosted (developers)

For those who prefer to run the server locally:

Claude Code CLI
claude mcp add financekit -- uvx --from financekit-mcp financekit
Claude Desktop / Cursor / Windsurf (local)
{
  "mcpServers": {
    "financekit": {
      "command": "uvx",
      "args": ["--from", "financekit-mcp", "financekit"]
    }
  }
}
From PyPI
pip install financekit-mcp
financekit
From source
git clone https://github.com/vdalhambra/financekit-mcp.git
cd financekit-mcp
uv sync
uv run financekit
Smithery
npx -y @smithery/cli install @vdalhambra/financekit --client claude

Note: Self-hosted = full feature access but you manage updates, uptime, and infrastructure. For most users, MCPize is the better choice.


Pricing

TierPriceCalls/monthIncludes
Free$01005 basic tools (quotes, company info, crypto price)
Hobby$9/mo2,500Most tools — no portfolio or market overview
Pro ⭐$29/mo10,000All 12 tools + priority + premium features
Team$79/mo50,000Pro + 5 seats + CSV export + email support
Business$179/mo200,000Team + webhooks + alerts + SLA
Enterprise$499/moUnlimitedBusiness + white-label + on-prem + dedicated support

Annual plans: Get 2 months free (pay for 10, use 12).

Bundle: Combine with SiteAudit MCP for $39/mo (Pro Combo — save 19%).

👉 View all pricing on MCPize

Data Sources

  • Stocks: Yahoo Finance (via yfinance) — free, no API key
  • Crypto: CoinGecko API (free tier, 10K calls/month)
  • Technical Indicators: Calculated locally using the ta library (RSI, MACD, Bollinger Bands, ADX, Stochastic, ATR, OBV)

All data is cached to minimize API calls: quotes (60s), historical data (1h), crypto (2min), company info (24h).

Examples

Technical Analysis Output
Symbol: AAPL
Current Price: 260.48
Indicators:
  RSI(14): 55.65 — neutral
  MACD: histogram positive — bullish momentum
  Bollinger Bands: price within bands — normal
  SMA(50): 260.84
  ADX: 18.3 — weak/no trend
Patterns:
  Golden Cross: false
  Overbought: false
Portfolio Analysis Output
Total Value: $45,230.50
Positions: 3
Concentration Risk: MODERATE
Sector Breakdown:
  Technology: 85.2%
  Communication Services: 14.8%

Compatible AI Agents

FinanceKit works with any AI agent or IDE that supports the Model Context Protocol:

  • Claude Code (CLI) — claude mcp add
  • Claude Desktop — claude_desktop_config.json
  • Cursor — .cursor/mcp.json
  • Windsurf — MCP settings
  • Copilot — MCP configuration
  • Any MCP client — stdio or HTTP transport

Support this project

If FinanceKit is useful to you, please consider supporting ongoing development:

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.