jesusrs1/stock-trade-finance-api

This project is a server that follows the Model Context Protocol, or MCP, a standard that lets AI assistants and other tools call external functions in a structured way. Here, the server exposes financial data from Tiingo, a market data provider, as a set of callable tools, so any MCP-compatible client such as an AI coding assistant can pull stock prices, news, foreign exchange rates, and company fundamentals without the developer writing custom API integration code. The available tools cover getting end-of-day stock prices for a ticker, fetching filtered news articles, retrieving historical and real-time foreign exchange prices, and pulling company fundamentals such as balance sheets, income statements, cash flow statements, dividend history, dividend yield, and stock split history. Each tool accepts inputs like a ticker symbol, a date range, and other filters specific to that data type. To use it, a developer needs Node.js version 18 or later and a Tiingo API account, since a Tiingo API token is required to authenticate requests. There is no way to sign up for Tiingo programmatically, so the token has to be obtained manually from the Tiingo website. Setup involves installing dependencies with npm, building the TypeScript source into JavaScript, and then configuring an MCP client to launch the server and pass in the API token as an environment variable. The project is also built to be extended: adding support for a new Tiingo endpoint means writing a new tool file that defines its name, description, and input rules, then registering it in a central list before rebuilding. This makes it a starting point for developers who want to give AI assistants access to real financial market data.