
A comprehensive FastMCP server that provides advanced financial market analysis tools for making
A comprehensive FastMCP server that provides advanced financial market analysis tools for making informed investment decisions. This server combines multiple free data sources with sophisticated analytics to give agents access to institutional-grade market intelligence.
·
A comprehensive FastMCP server that provides advanced financial market analysis tools for making informed investment decisions. This server combines multiple free data sources with sophisticated analytics to give agents access to institutional-grade market intelligence.
This package uses a combination of these free financial data APIs:
brew install uvor with curl
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
curl -LsSf https://astral.sh/uv/install.ps1 | powershell# Clone the repository
git clone https://github.com/duneraccoon/financial-markets-analyser.git
cd financial-markets-analyser
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install using uv
uv pip install -e .
## or in development mode
# uv pip install -e ".[dev]"Install Claude Desktop (if you haven't already done so):
Create claude_desktop_config.json (if it doesn't exist):
Add the server config to the config JSON. Use .env.example as a guide for the env arg:
{
"mcpServers": {
"financial-markets-analyser": {
"command": "uv",
"args": [
"--directory",
"/path/to/financial-markets-analyser",
"run",
"entrypoint.py"
],
"env": {
"ALPHA_VANTAGE_API_KEY": "your_api_key",
"FMP_API_KEY": "your_api_secret"
}
}
}
}You can obtain free API keys from:
python server.pyOr use the installed script:
financial-markets-analyser| Method | Description | Parameters |
|---|---|---|
get_income_statements | Get income statements for a company | ticker: Symbol (e.g., AAPL)period: "annual" or "quarterly"limit: Number of statements (default: 4) |
get_balance_sheets | Get balance sheets for a company | ticker: Symbol (e.g., AAPL)period: "annual" or "quarterly"limit: Number of statements (default: 4) |
get_cash_flow_statements | Get cash flow statements for a company | ticker: Symbol (e.g., AAPL)period: "annual" or "quarterly"limit: Number of statements (default: 4) |
get_current_stock_price | Get latest stock price data | ticker: Symbol (e.g., AAPL) |
get_historical_stock_prices | Get historical stock prices | ticker: Symbol (e.g., AAPL)start_date: Start date (YYYY-MM-DD)end_date: End date (YYYY-MM-DD)interval: Time interval (1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo) |
get_company_news | Get latest news for a company | ticker: Symbol (e.g., AAPL)limit: Number of news articles (default: 10) |
| Method | Description | Parameters |
|---|---|---|
get_available_crypto_tickers | Get list of available cryptocurrencies | None |
get_current_crypto_price | Get latest price for a cryptocurrency | ticker: Symbol (e.g., BTC-USD) |
get_historical_crypto_prices | Get historical cryptocurrency prices | ticker: Symbol (e.g., BTC-USD)start_date: Start date (YYYY-MM-DD)end_date: End date (YYYY-MM-DD)interval: Time interval (minute, hour, day) |
| Method | Description | Parameters |
|---|---|---|
get_market_indices | Get current prices and performance of major market indices (S&P 500, NASDAQ, Dow, VIX, etc.) | None |
get_sector_performance | Get performance of major market sectors | period: Time period (1d, 5d, 1mo, 3mo, 6mo, 1y, ytd) |
get_economic_indicators | Get key economic indicators (interest rates, inflation, GDP, unemployment, yield curve) | None |
get_market_sentiment_indicators | Get comprehensive market sentiment (VIX, Put/Call ratio, Fear & Greed, advance/decline) | None |
| Method | Description | Parameters |
|---|---|---|
get_financial_ratios | Calculate comprehensive financial ratios (profitability, liquidity, leverage, efficiency, valuation) | ticker: Symbolperiod: "annual" or "quarterly"limit: Number of periods (default: 4) |
perform_dcf_valuation | Perform Discounted Cash Flow valuation analysis | ticker: Symbolforecast_years: Years to forecast (default: 5)terminal_growth_rate: Long-term growth rate (default: 0.02)discount_rate: WACC or required return (default: 0.09) |
compare_peers | Compare a company with industry peers on key metrics | ticker: Symbolmetrics: List of metrics to compare |
get_analyst_ratings | Get analyst ratings, price targets, and recommendations | ticker: Symbol |
get_earnings_history | Get historical earnings with estimates, actuals, and surprises | ticker: Symbollimit: Number of reports (default: 4) |
get_earnings_calendar | Get upcoming earnings announcements | from_date: Start date (default: today)to_date: End date (default: +7 days) |
| Method | Description | Parameters |
|---|---|---|
get_technical_indicators | Calculate technical indicators (SMA, EMA, RSI, MACD, BB, ATR, OBV) with trading signals | ticker: Symbolstart_date: Start dateend_date: End dateindicators: List of indicators |
detect_chart_patterns | Detect chart patterns (double tops/bottoms, support/resistance) | ticker: Symbolstart_date: Start dateend_date: End date |
calculate_fibonacci_levels | Calculate Fibonacci retracement and extension levels | ticker: Symboltrend_type: "uptrend" or "downtrend"lookback_days: Days to analyze (default: 90) |
| Method | Description | Parameters |
|---|---|---|
get_options_chain | Get full options chain with calls and puts | ticker: Symbolexpiration_date: Specific expiration or None for nearest |
get_implied_volatility_surface | Get IV surface across strikes and expirations | ticker: Symbol |
| Method | Description | Parameters |
|---|---|---|
get_insider_transactions | Get recent insider trading transactions | ticker: Symbollimit: Number of transactions (default: 20) |
get_institutional_ownership | Get institutional ownership data | ticker: Symbol |
analyze_news_sentiment | Analyze sentiment of recent news articles | ticker: Symboldays: Lookback period (default: 7) |
analyze_portfolio_risk | Comprehensive portfolio risk analysis (Sharpe, beta, VaR, correlation, diversification) | tickers: List of symbolsweights: Portfolio weightsperiod: Analysis period (default: 5y) |
import asyncio
from mcp.client.localclient import LocalClient
async def main():
client = LocalClient(["python", "server.py"])
await client.start()
# Get current price of Apple stock
result = await client.call("get_current_stock_price", {"ticker": "AAPL"})
print(result)
# Get historical prices for Tesla
result = await client.call(
"get_historical_stock_prices",
{
"ticker": "TSLA",
"start_date": "2023-01-01",
"end_date": "2023-12-31",
"interval": "1mo"
}
)
print(result)
await client.stop()
if __name__ == "__main__":
asyncio.run(main())# With uv
uv pip install -e ".[dev]"# Run tests with pytest
pytestBe mindful of these rate limits for free tiers:
| API | Rate Limit |
|---|---|
| Yahoo Finance | No official limits (use responsibly) |
| Alpha Vantage | 5 API calls per minute, 500 per day |
| Financial Modeling Prep | ~250-300 calls per day, 500MB bandwidth/month |
| CoinGecko | 10-50 calls per minute |
The server implements a fallback system to manage these limits efficiently.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add financial-markets-analyser -- uv --directory /path/to/financial-markets-analyser run entrypoint.py{
"mcpServers": {
"financial-markets-analyser": {
"env": {
"FMP_API_KEY": "",
"ALPHA_VANTAGE_API_KEY": ""
},
"args": [
"--directory",
"/path/to/financial-markets-analyser",
"run",
"entrypoint.py"
],
"command": "uv"
}
}
}code --add-mcp '{"name":"financial-markets-analyser","env":{"FMP_API_KEY":"","ALPHA_VANTAGE_API_KEY":""},"args":["--directory","/path/to/financial-markets-analyser","run","entrypoint.py"],"command":"uv"}'[mcp_servers.financial-markets-analyser]
command = "uv"
args = ["--directory", "/path/to/financial-markets-analyser", "run", "entrypoint.py"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/financial-markets-analyser to learn what the "Financial Markets Analyser" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/financial-markets-analyser)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "financial-markets-analyser" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.