← Back to directory

Stock Trade MCP Server

Community

MCP server exposing Tiingo API endpoints for stock prices, news, forex, and fundamentals.

GitHub source repository ↗

★ 140 Stars Category · Dev Tools Popular Source revision 157c512a0334

42FMRS · D

Reliability

6/20

Security and permissions

10/20

Maintenance

4/20

Documentation

10/20

Setup experience

12/20

This server wraps Tiingo API endpoints, covering various financial data points, but requires users to bring their own API key. The code is well-structured and extensible, but the license is 'NOASSERTION', making official status unclear. It is suitable for developers needing programmatic access to Tiingo data.

Read the FMRS scoring method →

Stock Trade MCP Server is a Model Context Protocol (MCP) server that exposes various Tiingo API endpoints as tools. It allows programmatic access to financial data including stock prices, news, forex, fundamentals, and corporate actions via the MCP protocol. Requires Node.js (v18 or later), npm, and a Tiingo API key.

Tools

get_end_of_day_prices

Fetches End-of-Day prices for a given ticker symbol with optional date range and format.

get_news

Fetches news articles from Tiingo with various filtering options.

get_forex_prices

Fetches historical intraday Forex prices for a given ticker symbol with optional date range and frequency.

get_forex_top_of_book

Fetches real-time Forex Top-of-Book/Last data for one or more ticker symbols.

get_fundamentals_definitions

Fetches available fundamental metrics and their definitions.

get_fundamentals_statements

Fetches historical fundamental statement data (Balance Sheet, Income Statement, Cash Flow, Overview) for a given ticker.

get_fundamentals_daily_metrics

Fetches daily fundamental metrics for a given ticker.

get_fundamentals_meta

Fetches fundamental meta data for companies.

get_dividend_distributions

Fetches historical dividend and distribution data for a given ticker.

get_dividend_yield

Fetches historical dividend yield data for a given ticker.

get_splits

Fetches historical split data for a given ticker.

Setup

Clone the repository and enter the project directory.
Run npm install to install dependencies.
Obtain a Tiingo API token by registering at Tiingo and visiting https://www.tiingo.com/account/api/token.
Set the TIINGO_API_TOKEN environment variable in your MCP client configuration.
Run npm run build to build the server.
Configure your MCP client to run the server using stdio transport.

claude_desktop_config.json

{
  "mcp-tiingo": {
    "transportType": "stdio",
    "command": "node",
    "args": [
      "/path/to/mcp-tiingo/build/index.js"
    ],
    "env": {
      "TIINGO_API_TOKEN": "YOUR_API_KEY_HERE"
    }
  }
}

Generate and validate client config

Fit and risk

Best for

Developers and quantitative analysts needing programmatic access to Tiingo financial data.
Users who want to integrate financial data into MCP clients like Claude Desktop.
Workflows that require automated retrieval of stock, news, forex, and fundamentals data.

Not for

Users without a Tiingo API key (must register and obtain a token).
Users needing real-time streaming quotes (the server provides REST endpoints only).
Users requiring data sources other than Tiingo.

Required permissions

Network access to call Tiingo API endpoints.
Environment variable `TIINGO_API_TOKEN` for authentication.
Local file system access to read the built JavaScript file (typically `build/index.js`).

Risks and side effects

Risk of exposing your Tiingo API key; handle it securely.
API usage may incur costs depending on Tiingo's pricing.
Dependence on third-party service: Tiingo's availability and data accuracy may vary.
Error handling might not be robust; invalid API keys or request failures may result in errors.

Troubleshooting

Verify that your Tiingo API key is valid and correctly set in the environment.
Ensure Node.js version is v18 or later.
Check that `npm install` and `npm run build` completed successfully.
Verify the command and path in your MCP client configuration.
Inspect server logs for detailed error messages.

Use cases

Fetch historical end-of-day stock prices for trend analysis and backtesting.

Retrieve latest financial news to support investment decisions.

Query historical forex prices and real-time quotes for currency analysis.

Access fundamental statements and metrics for value investing.

Track corporate actions like dividends and stock splits.

Supported clients

Claude DesktopFull support

Related MCP servers

Compare with other MCP servers