MarketDataMcpServer

MarketDataMcpServer is a Model Context Protocol (MCP) server that provides comprehensive market data for stocks, ETFs, cryptocurrencies, and economic indicators. It leverages multiple data providers like Alpha Vantage and CoinGecko to offer high-quality financial information to AI models.

Features

• Stock Market Data: Search for stocks, get detailed company overviews, and access financial statements.
• ETF Analysis: Search for ETFs and view their holdings and detailed information.
• Crypto Tracking: Search for cryptocurrencies, get real-time data, and stay updated with crypto news.
• Super Investor Insights: Track institutional "Super Investors" and their portfolios.
• Economic Indicators: Access time series data for key economic indicators (GDP, Inflation, etc.) and commodities (Oil, Gas, etc.).
• Market Intelligence: Get the latest market news and sector performances.

Prerequisites

• Go 1.21 or higher.
• API keys for:
  • Alpha Vantage
  • CoinGecko

Configuration

The server is configured via environment variables. Create a .env file in the root directory:

# API Keys
ALPHA_VANTAGE_API_KEY=your_alpha_vantage_key
COIN_GECKO_API_KEY=your_coin_gecko_key

# Cache TTL (in seconds)
CACHE_TTL=3600
ALPHA_VANTAGE_CACHE_TTL=3600
COIN_GECKO_CACHE_TTL=3600

Getting Started

Installation

1. Clone the repository.
2. Install dependencies:

   make install
   

Running the Server

Start the MCP server on port 8080:

make run_mcp_server

Building

Build the binary:

make build_mcp_server

Available Tools

Tool	Description
stockSearch	Search for stock tickers based on keywords.
etfSearch	Search for ETFs based on keywords.
getETF	Get detailed information and holdings for a specific ETF.
getSuperInvestors	List tracked institutional super investors.
getSuperInvestorPortfolio	Get the portfolio holdings of a specific super investor.
getMarketNews	Get the latest global market news.
getSectors	Get a list of market sectors and their performance.
getSectorStocks	Get the top stocks for a specific sector.
getStockOverview	Get a comprehensive overview of a company (valuation, growth, etc.).
getStockFinancials	Get financial statements (Income Statement, Balance Sheet, Cash Flow).
getEconomicIndicatorTimeSeries	Get historical data for economic indicators (e.g., GDP, Inflation).
getCommodityTimeSeries	Get historical data for commodities (e.g., Crude Oil, Natural Gas).
searchCryptocurrencies	Search for cryptocurrencies on CoinGecko.
getCryptocurrencyDataById	Get detailed real-time data for a specific cryptocurrency.
getCryptocurrencyNews	Get the latest news related to cryptocurrencies.
calculateInvestmentFutureValue	Calculate the future value of an investment based on initial amount, annual return, and years.
getEarningsCallTranscript	Get the earnings call transcript of the stock with the given symbol, year, and quarter.
getInsiderTransactions	Get the insider transactions of the stock with the given symbol and year.
getCompanyKpiMetrics	Get the KPI metrics(revenue breakdown, revenue by geography etc) of the stock with the given symbol.
getInvestingIdeas	Get all investing ideas/themes (e.g. AI, Clean Energy, etc.)
getInvestingIdeaStocks	Returns the stocks(company name) for the given investing idea/theme id