Marketstack MCP Server

# Project Brief: Marketstack MCP Server This project aims to design and implement an MCP server for interacting with the Marketstack API. The server is built to provide access to various financial data endpoints, following a modular and scalable architecture based on the existing Alpha Vantage MCP server project. ## Core Requirements & Goals - Implement an MCP server using TypeScript and the @modelcontextprotocol/sdk. - Integrate with the Marketstack API to fetch financial data. - Implement the following Marketstack API endpoints as MCP tools: - End-of-Day Data (`eod`) - Intraday Data (`intraday`) - Splits Data (`splits`) - Dividends Data (`dividends`) - Tickers (`tickers/[symbol]`) - Tickers List (`tickerslist`) - Tickers Info (`tickerinfo`) - Exchanges (`exchanges`, `/exchanges/[mic]`, `/exchanges/[mic]/tickers`) - Currencies (`currencies`) - Timezones (`timezones`) - Bonds Listing (`bondslist` or similar) - Bond Info (`bond`) - ETF Holdings Listing (`etflist`) - ETF Holdings Info (`etfholdings`) - Stock Market Index Listing (`index` or similar) - Stock Market Index Info (`indexinfo`) - Use Zod for input schema validation for each tool. - Utilize native fetch for making HTTP requests to the Marketstack API. - Manage the Marketstack API key securely using an environment variable (`MARKETSTACK_API_KEY`). - The project is licensed under the GNU General Public License v3. - Exclude the following Marketstack endpoints: - Real-Time Updates - Real-time Stock Market Prices (`stockprice`) - Commodity Prices (`commodities`) - Commodities History Prices (`commoditieshistory`) - Company Ratings (`companyratings`) - Structure the project modularly, with each API group and endpoint implemented as a separate tool. - Ensure tools handle JSON responses and provide appropriate error handling. - Maintain up-to-date registration and index files for tools. - Implement a centralized client with LRU caching and appropriate TTLs for each tool, following the pattern of the `mcp-alphavantage` project. ## Project Scope The initial scope covers the implementation of the specified Marketstack API categories and their respective endpoints as individual MCP tools. Future extensions may include adding more endpoints, custom logic, automated tests, and deployment procedures.