FinMCP - I Built a Financial Data MCP Because AI Doesn't Know Today's Prices!
- Mustafa Ramadan
- 57 minutes ago
- 2 min read
I ask Claude about my investments way too often. "How does this ETF compare to that one?" "What's the analyst take on this stock?" The problem? The answers come back stale or completely made up.
AI models have a knowledge cutoff. They don't know what happened in the market today, last week, or last month. For investing decisions, that's basically useless.
The Gap
I started looking into Finance MCP servers — tools that give AI assistants live access to real data. Brilliant idea on paper. Reality check: all the free finance MCPs only work for US markets. ASX? Nothing.
As someone with a proper ASX portfolio, I was out of luck.
What I Built
I found Yahoo Finance has a free, undocumented API that covers everything — US stocks, ASX, crypto, forex, ETFs. No API key. So I took an existing MCP wrapper, rebuilt it properly, and shipped FinMCP.
It's a production-grade financial data server. Connect Claude, ChatGPT, or Cursor to live market data across any market Yahoo Finance touches. Can run on cloud deployment so you can deploy this to Railway or Docker and share it with mates over HTTPS.
What You Get on FinMCP
15 tools covering what investors actually need:
Real-time quotes across any market (BHP.AX, AAPL, BTC-USD, EURUSD=X — up to 100 at once)
Crypto and forex quotes
Financial statements (annual or quarterly)
Options chains with Greeks (delta, gamma, theta, vega)
Analyst consensus and price targets
Institutional holdings data
News with relevance scoring
Market screener (filter by sector, P/E, yield, beta, etc.)
Real example: I asked Claude to compare free cash flow trends across three ASX mining companies over four years. It pulled the numbers and gave me a clear breakdown. Normally takes 20 minutes of spreadsheet work.
How to Run FinMCP
Locally — Node.js 22+, clone, point Claude Desktop at it. Five minutes.
In the cloud — Deploy to Railway with one click, get a public HTTPS URL, share with friends. Free tier is plenty for personal use.
Why Yahoo Finance
It's free, global, and needs no API key. Alpha Vantage caps you at 25 requests per day. Polygon costs money. Everyone else is either US-only or paid.
Yahoo covers what matters — US, ASX, LSE, crypto, forex, ETFs.
The catch: it's unofficial. But the circuit breaker, rate limiter, retry logic, and caching handle hiccups gracefully.
Automation Ideas
Pre-market brief — Scheduled prompt every morning with your watchlist moves and news
Portfolio health check — Monthly scan for deteriorating cash flow or rising debt across holdings
Options monitoring — Track put/call ratios and unusual activity
Earnings tracker — Pull analyst estimates before results
Dividend calendar — Track ex-dividend dates for ASX income plays
Sector rotation check — Spot rotations by combining screener data with analyst sentiment
Get It
GitHub: github.com/Steve-sy/finmcp
MIT licensed. Free forever. Open an issue if something's broken.
If you're an ASX investor who's tired of AI tools that don't know what happened in the market today, this one solves that problem.
Comments