← Back to directory
S

Stock Trade MCP Server

Community
MCP server exposing Tiingo API endpoints for stock prices, news, forex, and fundamentals.
Category
Dev Tools #339 of 438
Stars
★ 138 Popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
API key / credential required
License
Other / unspecified
Last commit
Tools
11
42FMRS · D

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.

Strongest · Setup experience 12/20 Weakest · Maintenance 4/20

Reliability
6/20
Security and permissions
10/20
Maintenance
4/20
Documentation
10/20
Setup experience
12/20
Why each score
Reliability 6/20
Based only on README and repository metadata, with no source code, tests, or CI workflows available. The listed tools map plausibly to Tiingo endpoints, but MCP initialization handshake, tool registration, and error handling cannot be verified. The static calibration forbids a reliability score above 12 without executable evidence, so a conservative deduction was applied.
Security and permissions 10/20
The API key is passed via the TIINGO_API_TOKEN environment variable, the README examples contain no real secrets, and no malicious or dangerous operations are evident. However, token scope, least privilege, data boundaries, and confirmation workflows are undocumented, and the source code cannot be audited, leaving several risks unverified.
Maintenance 4/20
The repository is not archived, but the license is NOASSERTION, meaning there is no clear open-source license. There is also no evidence of commits, releases, dependency updates, or issue responsiveness. Since active maintenance cannot be confirmed, the score is low.
Documentation 10/20
The README covers installation, authentication, and a list of tools, but lacks complete parameter schemas, usage examples, rate-limit and cost information, troubleshooting, and more in-depth guidance. The extension section is also brief. Documentation is usable but has significant gaps.
Setup experience 12/20
The README gives clear installation steps (npm install, npm run build), an MCP client stdio configuration example, and TIINGO_API_TOKEN environment variable setup. The path is straightforward. However, it lacks cross-platform guidance, verification steps, and reproducible execution evidence, so it does not receive full marks.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

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.

Setup

Before you start

Runtime:Node.js 18+

TIINGO_API_TOKEN requiredsecret Tiingo API token, obtained from your Tiingo account page at https://www.tiingo.com/account/api/token.
  1. Clone the repository and enter the project directory.
  2. Run npm install to install dependencies.
  3. Obtain a Tiingo API token by registering at Tiingo and visiting https://www.tiingo.com/account/api/token.
  4. Set the TIINGO_API_TOKEN environment variable in your MCP client configuration.
  5. Run npm run build to build the server.
  6. 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"
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

Check that it works

After building with npm run build, connect via stdio and check that tools like get_end_of_day_prices appear in your client's tool list, then ask for a stock's prices to confirm the Tiingo API connection works.

Troubleshooting

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

Things to try

Once connected, you can ask your AI assistant things like:

  • Show me the end-of-day prices for AAPL over the last month
  • Get the real-time forex top-of-book quote for EUR/USD
  • List historical dividend distributions for MSFT
  • Fetch the latest stock splits data for TSLA

Tools 11

get_end_of_day_prices read-only
Fetches End-of-Day prices for a given ticker symbol with optional date range and format.
get_news read-only
Fetches news articles from Tiingo with various filtering options.
get_forex_prices read-only
Fetches historical intraday Forex prices for a given ticker symbol with optional date range and frequency.
get_forex_top_of_book read-only
Fetches real-time Forex Top-of-Book/Last data for one or more ticker symbols.
get_fundamentals_definitions read-only
Fetches available fundamental metrics and their definitions.
get_fundamentals_statements read-only
Fetches historical fundamental statement data (Balance Sheet, Income Statement, Cash Flow, Overview) for a given ticker.
get_fundamentals_daily_metrics read-only
Fetches daily fundamental metrics for a given ticker.
get_fundamentals_meta read-only
Fetches fundamental meta data for companies.
Show 3 more tools
get_dividend_distributions read-only
Fetches historical dividend and distribution data for a given ticker.
get_dividend_yield read-only
Fetches historical dividend yield data for a given ticker.
get_splits read-only
Fetches historical split data for a given ticker.

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 Desktop

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

Source revision 90d12d2a17dc Data synced 2026-10-12 Read the FMRS scoring method