Skip to content

FAQ

Jump to bottom
vdalhambra edited this page Apr 16, 2026 · 1 revision

FAQ — FinanceKit MCP

Common questions and troubleshooting.

Installation

Q: Do I need an API key? No. FinanceKit MCP uses Yahoo Finance and CoinGecko — both free, no registration required.

Q: How do I install it?

uvx financekit-mcp

Then add to your claude_desktop_config.json. See Home for the full config.

Q: Can I use it without installing anything locally? Yes — use the hosted version on MCPize. Free tier: 100 requests/month.

Q: Does it work with Cursor / Windsurf / other MCP clients? Yes. Any MCP-compatible client works. The config format may vary slightly — check your client's docs.

Data & Accuracy

Q: How real-time is the data? Stock quotes are delayed 15 minutes (Yahoo Finance standard). Crypto prices are near-real-time (CoinGecko updates every few minutes).

Q: How far back does historical data go? Up to 5 years for most stocks. Crypto history varies by coin age.

Q: Why is a ticker not found? Use the official exchange ticker (e.g. BRK-B not BRK.B, BTC-USD for Bitcoin). Some OTC stocks may not be available.

Technical Issues

Q: Claude says the tool is unavailable

  1. Check that FinanceKit MCP is listed in claude desktop > Settings > Developer
  2. Restart Claude Desktop after config changes
  3. Verify with: uvx financekit-mcp in terminal — should start without error

Q: Getting rate limit errors Yahoo Finance and CoinGecko have rate limits. Wait 30-60 seconds and retry. For high-frequency use, consider the MCPize hosted API.

Q: Options data not returning results Options data requires a valid US stock ticker with active options. Index ETFs (SPY, QQQ) and large caps work best.

Pricing

Q: Is FinanceKit MCP free? The open-source version (GitHub) is completely free. The hosted API on MCPize has a free tier (100 req/mo) and paid plans starting at $19/mo for unlimited access.

Q: What's the difference between local and hosted?

  • Local (uvx): Free, requires Python, runs on your machine
  • Hosted (MCPize): No install, always updated, usage-based pricing

Contributing

Found a bug or want a new feature? Open an issue at github.com/vdalhambra/financekit-mcp.

Back to Home | Tools Reference | Usage Examples

Clone this wiki locally