MarketDataMcpServer

MarketDataMcpServer is an MCP server that aggregates and serves rich market data across multiple asset classes including stocks, ETFs, cryptocurrencies, and economic indicators. It exposes a suite of tools that let you search for tickers, retrieve detailed company information, track sector performance, obtain market news, and fetch time series data for economic indicators and commodities. Use these capabilities to power AI models with up-to-date financial data, perform scenario analysis, or build investment ideas based on real-time and historical market signals. The server interfaces with data providers like Alpha Vantage and CoinGecko to deliver fast and reliable financial insights.

Prerequisites:

• Go 1.21 or higher
• Git
• Make (for convenient build scripts)
• API keys for Alpha Vantage and CoinGecko

Installation steps:

1. Clone the repository

git clone https://github.com/orestisstefanou-marketdatamcpserver/MarketDataMcpServer.git
cd MarketDataMcpServer

2. Create a .env file with required keys (or export them in your environment)

# API Keys
ALPHA_VANTAGE_API_KEY=your_alpha_vantage_key
COIN_GECKO_API_KEY=your_coin_gecko_key

# Cache settings
CACHE_TTL=3600
ALPHA_VANTAGE_CACHE_TTL=3600
COIN_GECKO_CACHE_TTL=3600

3. Install dependencies and build the server

make install
make build_mcp_server

4. Run the MCP server (default port 8080)

make run_mcp_server

Tips:

• Ensure your API keys are valid and have access to the required endpoints from Alpha Vantage and CoinGecko.
• If you modify cache TTLs, restart the server to apply changes.
• The server is designed to be started in a network environment where port 8080 is accessible; adjust port settings if needed through your deployment configuration.
• If you encounter connectivity issues to data providers, verify environment variables and network access from the host.
• Explore the available tools to tailor data retrieval to your model’s needs (e.g., restricting to specific sectors or assets).